Compartilhar via

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

  • Artigo

O método ITextStoreACP::GetTextExt retorna a caixa delimitadora, em coordenadas de tela, do texto em uma posição de caractere especificada. O chamador deve ter um bloqueio somente leitura no documento antes de chamar esse método.

Sintaxe

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

Parâmetros

[in] vcView

Especifica a exibição de contexto.

[in] acpStart

Especifica a posição do caractere inicial do texto a ser obtido no documento.

[in] acpEnd

Especifica a posição do caractere final do texto a ser obtido no documento.

[out] prc

Recebe a caixa delimitadora em coordenadas de tela do texto nas posições de caractere especificadas.

[out] pfClipped

Recebe um valor booliano que especifica se o texto na caixa delimitadora foi recortado. Se esse parâmetro for TRUE, a caixa delimitadora conterá texto recortado e não incluirá todo o intervalo de texto solicitado. A caixa delimitadora é recortada porque o intervalo solicitado não está visível.

Retornar valor

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
 O método foi bem-sucedido.
TS_E_INVALIDARG
 As posições de caractere inicial e final especificadas são iguais.
TS_E_INVALIDPOS
 O intervalo especificado pelos parâmetros acpStart e acpEnd se estende além do início ou do final do documento.
TS_E_NOLAYOUT
 O aplicativo não calculou um layout de texto.
TS_E_NOLOCK
 O chamador não tem um bloqueio somente leitura no documento.

Comentários

Se a janela do documento estiver minimizada ou se o texto especificado não estiver visível no momento, o método retornará S_OK com o parâmetro prc definido {0,0,0,0}como .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho textstor.h
DLL Msctf.dll
Redistribuível TSF 1.0 no Windows 2000 Professional

Confira também

Itextstoreacp

ITfContextOwner::GetTextExt

ITfContextView::GetTextExt