Metodo ITextStoreACP2::QueryInsert (textstor.h)

Articolo
03/13/2024

Determina se le posizioni di inizio e di fine specificate sono valide. Usare questo metodo per modificare un documento prima di eseguire la modifica. Il metodo non deve restituire valori all'esterno dell'intervallo del documento.

Sintassi

HRESULT QueryInsert(
  [in]  LONG  acpTestStart,
  [in]  LONG  acpTestEnd,
  [in]  ULONG cch,
  [out] LONG  *pacpResultStart,
  [out] LONG  *pacpResultEnd
);

Parametri

[in] acpTestStart

Avvio della posizione del carattere dell'applicazione per il testo inserito.

[in] acpTestEnd

Posizione di carattere dell'applicazione finale 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 iniziale del carattere dell'applicazione 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 il 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 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	textstor.h
DLL	Msctf.dll

Vedi anche

ITextStoreACP2

Condividi tramite