Metodo ITfInsertAtSelection::InsertTextAtSelection (msctf.h)

Articolo
02/29/2024

Inserisce il testo nel punto di selezione o inserimento.

Sintassi

HRESULT InsertTextAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  const WCHAR  *pchText,
  [in]  LONG         cch,
  [out] ITfRange     **ppRange
);

Parametri

[in] ec

Identifica il contesto di modifica. Si ottiene da ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] dwFlags

Campo di bit con uno dei valori seguenti.

Valore	Significato
TF_IAS_NOQUERY	ppRange è NULL. Questo flag non può essere combinato con il flag TF_IAS_QUERYONLY.
TF_IAS_QUERYONLY	Il contesto non viene modificato, ma ppRange viene impostato come se si fosse verificato l'inserimento. L'accesso in sola lettura è sufficiente. Se questo flag non è impostato, ec deve avere accesso in lettura/scrittura. Questo flag non può essere combinato con il flag TF_IAS_NOQUERY.
TF_IAS_NO_DEFAULT_COMPOSITION	Il gestore non creerà una composizione predefinita se è necessaria una composizione. Il chiamante deve creare un oggetto composizione che copre il testo inserito prima di rilasciare il blocco del contesto.

[in] pchText

Specifica il testo da inserire.

[in] cch

Specifica il numero di caratteri del testo in pchText.

[out] ppRange

Riceve la posizione dell'oggetto inserito.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
TF_E_NOLOCK	Il servizio di testo non dispone di un blocco del documento
TF_E_DISCONNECTED	L'oggetto contesto non si trova in uno stack di documenti.
TS_E_NOSELECTION	Il contesto non ha alcuna selezione.
TS_E_READONLY	La selezione è di sola lettura.

Commenti

Per inserire un oggetto IDataObject anziché testo, utilizzare ITfInsertAtSelection::InsertEmbeddedAtSelection.

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	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Vedi anche

Idataobject

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfInsertAtSelection

ITfInsertAtSelection::InsertEmbeddedAtSelection

Condividi tramite