Metodo ITextStoreAnchor::InsertTextAtSelection (textstor.h)

Articolo
08/26/2023

Inserisce testo nel punto di inserimento o nella selezione.

Sintassi

HRESULT InsertTextAtSelection(
  [in]  DWORD       dwFlags,
  [in]  const WCHAR *pchText,
  [in]  ULONG       cch,
  [out] IAnchor     **ppaStart,
  [out] IAnchor     **ppaEnd
);

Parametri

[in] dwFlags

Specifica se i parametri paStart e paEnd conterranno i risultati dell'inserimento di testo.

I flag TF_IAS_NOQUERY e TF_IAS_QUERYONLY non possono essere combinati.

valore	Significato
TF_IAS_NOQUERY	Il testo viene inserito e i valori dei parametri ppaStart e ppaEnd possono essere NULL. Utilizzare questo flag se i risultati dell'inserimento di testo non sono obbligatori.
TF_IAS_QUERYONLY	Il testo non viene inserito e gli ancoraggi ppaStart e ppaEnd 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. Utilizzare questo flag per visualizzare i risultati dell'inserimento di testo senza inserire effettivamente il testo. È possibile inserire testo di lunghezza zero.

valore

Significato

TF_IAS_NOQUERY

Il testo viene inserito e i valori dei parametri ppaStart e ppaEnd possono essere NULL. Utilizzare questo flag se i risultati dell'inserimento di testo non sono obbligatori.

TF_IAS_QUERYONLY

Il testo non viene inserito e gli ancoraggi ppaStart e ppaEnd 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. Utilizzare questo flag per visualizzare i risultati dell'inserimento di testo senza inserire effettivamente il testo. È possibile inserire testo di lunghezza zero.

[in] pchText

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

[in] cch

Specifica la lunghezza del testo.

[out] ppaStart

Puntatore all'oggetto di ancoraggio all'inizio dell'inserimento di testo.

[out] ppaEnd

Puntatore all'oggetto di ancoraggio alla fine dell'inserimento di testo. Per un punto di inserimento, questo valore del parametro sarà uguale al valore del parametro ppaStart .

Valore restituito

Questo metodo può restituire uno di questi valori.

valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_FAIL	Il metodo non è riuscito a creare un'istanza di uno degli ancoraggi paStart o paEnd.
E_INVALIDARG	Il parametro pchText non è valido.
TS_E_NOLOCK	Il chiamante non dispone di un blocco sul documento.

Requisiti


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

Vedi anche

Composizioni

ITextStoreAnchor

ITextStoreAnchorSink::OnTextChange

Costanti TF_IAS_*

TS_TEXTCHANGE

Condividi tramite