Método ITipAutocompleteClient::P referredRects

Permite que o cliente sugira onde posicionar a lista de preenchimento automático para evitar a sobreposição do Painel de Entrada.

Sintaxe

HRESULT PreferredRects(
  [in]      RECT *prcACList,
  [in]      RECT *prcField,
  [out]     RECT *prcModified,
  [in, out] BOOL *pfShownAboveTip
);

Parâmetros

prcACList [in]

Um retângulo, em coordenadas de tela, indicando o local preferencial do provedor e o tamanho da interface do usuário da lista de preenchimento automático.

prcField [in]

Um retângulo, em coordenadas de tela, indicando o local e o tamanho do campo focalizado.

prcModified [out]

Um retângulo com base no estado atual da TIP e no local e tamanho da lista de preenchimento automático preferencial especificados por prcACList.

pfShownAboveTip [in, out]

TRUE se o retângulo modificado deve ser mostrado acima da área de destino do Painel de Entrada de Texto; caso contrário, FALSE. Esse valor deve ser inicializado para a orientação preferencial do provedor antes que o método seja chamado.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	Êxito.
E_INVALIDARG	Chame o Método ITipAutocompleteClient::RequestShowUI para definir a janela de lista de preenchimento automático de pop-up antes de chamar o Método ITipAutocompleteClient::P referredRects.
E_FAIL	Ocorreu um erro não especificado.

Comentários

Esse é o método que o provedor de preenchimento automático chama quando está prestes a mostrar a interface do usuário de preenchimento automático. O cliente modifica o retângulo preferencial do provedor especificado por prcACList por meio do argumento prcModified .

Chame o Método ITipAutocompleteClient::RequestShowUI para definir o identificador da janela de lista de preenchimento automático do pop-up antes de chamar PreferredRects. Não fazer isso causará um erro de E_INVALIDARG ao chamar PreferredRects.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Cabeçalho	TipAutoComplete.h (também requer Peninputpanel_i.c)
DLL	Tiptsf.dll

Confira também

ITipAutocompleteClient Interface

Método ITipAutocompleteClient::RequestShowUI

Referência do painel de entrada de texto