Metodo ITfInsertAtSelection::InsertTextAtSelection (msctf.h)

  • Articolo

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