Compartir a través de

Método ITfContextOwner::GetTextExt (msctf.h)

  • Artículo

El método ITfContextOwner::GetTextExt devuelve el cuadro de límite, en coordenadas de pantalla, del texto en una posición de carácter especificada. El autor de la llamada debe tener un bloqueo de solo lectura en el documento antes de llamar a este método.

Sintaxis

HRESULT GetTextExt(
  [in]  LONG acpStart,
  [in]  LONG acpEnd,
  [out] RECT *prc,
  [out] BOOL *pfClipped
);

Parámetros

[in] acpStart

Especifica la posición del carácter inicial del texto que se va a obtener en el documento.

[in] acpEnd

Especifica la posición del carácter final del texto que se va a obtener en el documento.

[out] prc

Recibe el rectángulo delimitador, en coordenadas de pantalla, del texto en las posiciones de caracteres especificadas.

[out] pfClipped

Recibe el valor booleano que especifica si se ha recortado el texto del cuadro de límite. Si este parámetro es TRUE, el cuadro de límite contiene texto recortado y no incluye todo el intervalo de texto solicitado. El rectángulo de límite se recorta debido a que el intervalo solicitado no está visible.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Descripción
S_OK
 Método realizado correctamente.
TS_E_INVALIDARG
 Las posiciones de carácter inicial y final especificadas son iguales.
TS_E_INVALIDPOS
 El intervalo especificado por los parámetros acpStart y acpEnd se extiende más allá del final del documento o de la parte superior del documento.
TS_E_NOLAYOUT
 La aplicación no ha calculado un diseño de texto.
TS_E_NOLOCK
 El autor de la llamada no tiene un bloqueo de solo lectura en el documento.

Comentarios

Si la ventana del documento está minimizada o si el texto especificado no está visible actualmente, el método devuelve S_OK con el parámetro prc establecido en {0,0,0,0}.

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 Msimtf.dll
Redistribuible TSF 1.0 en Windows 2000 Professional

Consulte también

ITextStoreACP::GetTextExt

ITfContextOwner

ITfContextView::GetTextExt