Método ITfInsertAtSelection::InsertTextAtSelection (msctf.h)

Artículo
02/29/2024

Inserta texto en el punto de selección o inserción.

Sintaxis

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

Parámetros

[in] ec

Identifica el contexto de edición. Esto se obtiene de ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] dwFlags

Campo de bits con uno de los valores siguientes.

Valor	Significado
TF_IAS_NOQUERY	ppRange es NULL. Esta marca no se puede combinar con la marca TF_IAS_QUERYONLY.
TF_IAS_QUERYONLY	El contexto no se modifica, pero ppRange se establece como si se hubiera producido la inserción. El acceso de solo lectura es suficiente. Si no se establece esta marca, ec debe tener acceso de lectura y escritura. Esta marca no se puede combinar con la marca TF_IAS_NOQUERY.
TF_IAS_NO_DEFAULT_COMPOSITION	El administrador no creará una composición predeterminada si se requiere una composición. El autor de la llamada debe crear un objeto de composición que cubra el texto insertado antes de liberar el bloqueo de contexto.

[in] pchText

Especifica el texto que se va a insertar.

[in] cch

Especifica el recuento de caracteres del texto en pchText.

[out] ppRange

Recibe la posición del objeto insertado.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
TF_E_NOLOCK	El servicio de texto no tiene un bloqueo de documento
TF_E_DISCONNECTED	El objeto context no está en una pila de documentos.
TS_E_NOSELECTION	El contexto no tiene ninguna selección.
TS_E_READONLY	La selección es de solo lectura.

Comentarios

Para insertar un objeto IDataObject en lugar de texto, use ITfInsertAtSelection::InsertEmbeddedAtSelection.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msctf.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional