Método ITipAutocompleteClient::P referredRects

Permite al cliente sugerir dónde colocar la lista de autocompletar para evitar que se superponga el Panel de entrada.

Sintaxis

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

Parámetros

prcACList [in]

Rectángulo, en coordenadas de pantalla, que indica la ubicación preferida del proveedor y el tamaño de la interfaz de usuario de la lista de autocompletar.

prcField [in]

Rectángulo, en coordenadas de pantalla, que indica la ubicación y el tamaño del campo centrado.

prcModified [out]

Rectángulo basado en el estado actual de la SUGERENCIA y la ubicación y tamaño de lista de autocompletar preferidos especificados por prcACList.

pfShownAboveTip [in, out]

TRUE si el rectángulo modificado debe mostrarse encima del área de destino del Panel de entrada de texto; de lo contrario, FALSE. Este valor debe inicializarse en la orientación preferida del proveedor antes de llamar al método .

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	Correcto.
E_INVALIDARG	Llame al método ITipAutocompleteClient::RequestShowUI para establecer la ventana de lista de autocompletar emergente antes de llamar al método ITipAutocompleteClient::P referredRects.
E_FAIL	Se ha producido un error no especificado.

Observaciones

Este es el método al que llama el proveedor de autocompletar cuando está a punto de mostrar la interfaz de usuario de autocompletar. El cliente modifica el rectángulo preferido del proveedor especificado por prcACList mediante el argumento prcModified .

Llame al método ITipAutocompleteClient::RequestShowUI para establecer el identificador de la ventana de lista de autocompletar emergente antes de llamar a PreferredRects. Si no lo hace, se producirá un error de E_INVALIDARG al llamar a PreferredRects.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Encabezado	TipAutoComplete.h (también requiere Peninputpanel_i.c)
Archivo DLL	Tiptsf.dll

Vea también

ITipAutocompleteClient (Interfaz)

ITipAutocompleteClient::RequestShowUI (Método)

Referencia del panel de entrada de texto