Compartilhar via

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

  • Artigo

O método ITextStoreAnchor::GetTextExt retorna a caixa delimitadora, em coordenadas de tela, de um intervalo de texto. O chamador deve ter um bloqueio somente leitura no documento antes de chamar esse método.

Sintaxe

HRESULT GetTextExt(
  [in]  TsViewCookie vcView,
  [in]  IAnchor      *paStart,
  [in]  IAnchor      *paEnd,
  [out] RECT         *prc,
  [out] BOOL         *pfClipped
);

Parâmetros

[in] vcView

Especifica a exibição de contexto.

[in] paStart

Especifica a âncora posicionada no início do intervalo.

[in] paEnd

Especifica a âncora posicionada no final do intervalo.

[out] prc

Recebe a caixa delimitadora do intervalo de texto nas coordenadas da tela.

[out] pfClipped

Recebe um valor booliano que especifica se o texto na caixa delimitadora foi recortado. Se TRUE, a caixa delimitadora contém texto recortado e não inclui 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.
E_FAIL
 O método não pôde obter um ponteiro de interface válido para as âncoras inicial e/ou final.
TS_E_INVALIDARG
 Um ou mais dos parâmetros de entrada são inválidos.
TS_E_INVALIDPOS
 O intervalo especificado pelos parâmetros paStart e paEnd se estende além do início ou final do documento.
TS_E_NOLAYOUT
 O aplicativo não calculou um layout de texto. As chamadas adicionais não terão êxito até que o aplicativo chame ITextStoreAnchorSink::OnLayoutChange.
TS_E_NOLOCK
 O chamador não tem um bloqueio somente leitura no documento.

Comentários

Se a janela do documento for 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 como {0,0,0,0}.

Requisitos

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

Confira também

ITextStoreAnchor

ITfContextOwner::GetTextExt

ITfContextView::GetTextExt