Metodo ITextStoreACP::InsertTextAtSelection (textstor.h)

Articolo
08/26/2023

Il metodo ITextStoreACP::InsertTextAtSelection inserisce il testo nel punto di inserimento o nella selezione. Un chiamante deve avere un blocco di lettura/scrittura nel documento prima di inserire testo.

Sintassi

HRESULT InsertTextAtSelection(
  [in]  DWORD         dwFlags,
  [in]  const WCHAR   *pchText,
  [in]  ULONG         cch,
  [out] LONG          *pacpStart,
  [out] LONG          *pacpEnd,
  [out] TS_TEXTCHANGE *pChange
);

Parametri

[in] dwFlags

Specifica se i parametri pacpStart e pacpEnd e la struttura TS_TEXTCHANGE contengono i risultati dell'inserimento di testo.

Impossibile combinare i flag TF_IAS_NOQUERY e TF_IAS_QUERYONLY .

Valore	Significato
0	L'inserimento del testo si verificherà e i parametri pacpStart e pacpEnd conterranno i risultati dell'inserimento di testo. La struttura TS_TEXTCHANGE deve essere riempita con questo flag.
TF_IAS_NOQUERY	Il testo viene inserito, i valori dei parametri pacpStart e pacpEnd possono essere NULL e la struttura TS_TEXTCHANGE deve essere compilata. Usare questo flag per visualizzare i risultati dell'inserimento di testo.
TF_IAS_QUERYONLY	Il testo non viene inserito e i valori per i parametri pacpStart e pacpEnd contengono i risultati dell'inserimento di testo. I valori di questi parametri dipendono dal modo in cui l'applicazione implementa l'inserimento di testo in un documento. Per altre informazioni, vedere la sezione Osservazioni. Usare questo flag per visualizzare i risultati dell'inserimento di testo senza inserire effettivamente il testo. Non è necessario riempire la struttura di TS_TEXTCHANGE se si usa questo flag.

[in] pchText

Puntatore alla stringa da inserire nel documento. La stringa può essere terminata da NULL .

[in] cch

Specifica la lunghezza del testo.

[out] pacpStart

Puntatore alla posizione del carattere dell'applicazione iniziale in cui si verifica l'inserimento del testo.

[out] pacpEnd

Puntatore alla posizione del carattere dell'applicazione finale in cui si verifica l'inserimento di testo. Questo valore di parametro è lo stesso del valore del parametro pacpStart per un punto di inserimento.

[out] pChange

Puntatore a una struttura TS_TEXTCHANGE con i membri seguenti.

Valore	Significato
acpStart	Posizione del carattere dell'applicazione iniziale prima dell'inserimento del testo nel documento.
acpOldEnd	Posizione del carattere dell'applicazione finale prima dell'inserimento del testo nel documento. Questo valore è uguale a acpStart per un punto di inserimento. Se questo valore è diverso da acpStart, il testo è stato selezionato prima dell'inserimento di testo.
acpNewEnd	Posizione finale dopo l'inserimento del testo.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
TS_E_NOLOCK	Il chiamante non ha un blocco nel documento.
E_INVALIDARG	Il parametro pchText non è valido.

Commenti

I valori dei parametri pacpStart e pacpEnd dipendono dal modo in cui l'applicazione client inserisce il testo in un documento. Ad esempio, se l'applicazione imposta il cursore all'inizio del testo inserito dopo l'inserimento di testo, il valore per i parametri pacpStart e pacpEnd corrisponde al membro acpStart della struttura TS_TEXTCHANGE.

Le applicazioni non devono chiamare il metodo ITextStoreACPSink::OnTextChange in risposta a questo metodo.

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

Vedi anche

Composizioni

ITextStoreACP

ITextStoreACPSink::OnTextChange

costanti TF_IAS_*

TS_TEXTCHANGE

Condividi tramite