Compartir a través de

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

  • Artículo

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

Consulte también

IDataObject

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfInsertAtSelection

ITfInsertAtSelection::InsertEmbeddedAtSelection