Metodo ITextStoreAnchor::QueryInsert (textstor.h)

Articolo
03/02/2024

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.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_FAIL	Si è verificato un errore non specificato.
E_INVALIDARG	I parametri paTestStart o paTestEnd non sono validi.
E_OUTOFMEMORY	Tentativo di creare un'istanza degli ancoraggi ppaResultStart e/o ppaResultEnd non riusciti.

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

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	textstor.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Condividi tramite