Método ITextHost::TxGetClientRect (textserv.h)

Artigo
03/05/2024

Recupera as coordenadas do cliente da área de cliente do host de texto.

Sintaxe

HRESULT TxGetClientRect(
  LPRECT prc
);

Parâmetros

prc

Tipo: LPRECT

As coordenadas do cliente da área de cliente do host de texto.

Retornar valor

Tipo: HRESULT

Retornar S_OK se o método for bem-sucedido.

Retornará o código de erro COM a seguir se o método falhar. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno	Descrição
E_FAIL	Erro não especificado.

Comentários

O retângulo do cliente é o retângulo que o objeto de serviços de texto é responsável por pintar e gerenciar. O host depende do objeto de serviços de texto para pintar essa área. E o objeto de serviços de texto não deve pintar nem invalidar áreas fora desse retângulo.

O host encaminha mensagens do mouse para o objeto de serviços de texto quando o cursor está sobre o retângulo do cliente.

O retângulo do cliente é expresso nas coordenadas do cliente da janela que o contém.

Importante O método ITextHost::TxGetClientRect falhará se for chamado em um momento inativo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	textserv.h
DLL	Msftedit.dll