Metodo ITextStoreACP::QueryInsert (textstor.h)

Il metodo ITextStoreACP::QueryInsert determina se le posizioni dei caratteri di inizio e fine specificate sono valide. 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]  LONG  acpTestStart,
  [in]  LONG  acpTestEnd,
  [in]  ULONG cch,
  [out] LONG  *pacpResultStart,
  [out] LONG  *pacpResultEnd
);

Parametri

[in] acpTestStart

Posizione iniziale del carattere dell'applicazione per il testo inserito.

[in] acpTestEnd

Posizione finale del carattere dell'applicazione per il testo inserito. Questo valore è uguale a acpTextStart se il testo viene inserito in un punto anziché sostituire il testo selezionato.

[in] cch

Lunghezza del testo sostitutivo.

[out] pacpResultStart

Restituisce la nuova posizione del carattere applicazione iniziale del testo inserito. Se questo parametro è NULL, il testo non può essere inserito nella posizione specificata. Questo valore non può essere esterno all'intervallo di documenti.

[out] pacpResultEnd

Restituisce la nuova posizione del carattere dell'applicazione finale del testo inserito. Se questo parametro è NULL, pacpResultStart è impostato su NULL e il testo non può essere inserito nella posizione specificata. Questo valore non può essere esterno all'intervallo di documenti.

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 acpTestStart o acpTestEnd non sono validi.

Commenti

I valori di pacpResultStart e pacpResultEnd dipendono dal modo in cui l'applicazione inserisce testo nel documento. Se pacpResultStart e pacpResultEnd sono uguali a acpTextStart, il cursore si trova all'inizio del testo inserito dopo l'inserimento. Se pacpResultStart e pacpResultEnd sono uguali a acpTextEnd, il cursore si trova alla fine del testo inserito dopo l'inserimento. Se la differenza tra pacpResultStart e pacpResultEnd è uguale alla lunghezza del testo inserito, il testo inserito viene evidenziato dopo l'inserimento.

Requisiti

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