Metodo ITextStoreAnchor::QueryInsert (textstor.h)

Il metodo ITextStoreAnchor::QueryInsert determina se gli ancoraggi di inizio e fine specificati sono validi. Utilizzare questo metodo per modificare un documento prima di eseguire la modifica. Il metodo non deve restituire valori esterni all'intervallo del documento.

Sintassi

HRESULT QueryInsert(
  [in]  IAnchor *paTestStart,
  [in]  IAnchor *paTestEnd,
  [in]  ULONG   cch,
  [out] IAnchor **ppaResultStart,
  [out] IAnchor **ppaResultEnd
);

Parametri

[in] paTestStart

Riceve un puntatore a un ancoraggio iniziale per il testo inserito.

[in] paTestEnd

Riceve un puntatore a un ancoraggio finale per il testo inserito. Si tratta dello stesso valore di paTestStart se il testo viene inserito in un punto invece di sostituire il testo selezionato.

[in] cch

Lunghezza del testo sostitutivo.

[out] ppaResultStart

Puntatore al nuovo oggetto ancoraggio nella posizione iniziale del testo inserito. Se il valore di questo parametro è NULL, il testo non può essere inserito nella posizione specificata. L'ancoraggio non può essere esterno al documento.

[out] ppaResultEnd

Puntatore al nuovo oggetto ancoraggio nella posizione finale del testo inserito. Se il valore di questo parametro è NULL, il testo non può essere inserito nella posizione specificata. L'ancoraggio non può essere esterno al documento.

Valore restituito

Questo metodo può restituire uno di questi valori.

Commenti

I valori di ppaResultStart e ppaResultEnd dipendono dal modo in cui l'applicazione inserisce testo nel documento. Se ppaResultStart e ppaResultEnd sono uguali a paTestStart, il cursore si trova all'inizio del testo inserito dopo l'inserimento. Se ppaResultStart e ppaResultEnd sono uguali a paTextEnd, il cursore si trova alla fine del testo inserito dopo l'inserimento.

Requisiti