Método ITextStoreACP::GetTextExt (textstor.h)

El método ITextStoreACP::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]  TsViewCookie vcView,
  [in]  LONG         acpStart,
  [in]  LONG         acpEnd,
  [out] RECT         *prc,
  [out] BOOL         *pfClipped
);

Parámetros

[in] vcView

Especifica la vista de contexto.

[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 un 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 porque 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 principio o final 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	textstor.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional

Consulte también

ITextStoreACP

ITfContextOwner::GetTextExt

ITfContextView::GetTextExt