Metodo ITipAutocompleteClient::P referredRects

Consente al client di suggerire dove posizionare l'elenco completo automatico per evitare la sovrapposizione del pannello di input.

Sintassi

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

Parametri

prcACList [in]

Rettangolo, nelle coordinate dello schermo, che indica la posizione preferita del provider e le dimensioni dell'interfaccia utente dell'elenco automatico.

prcField [in]

Rettangolo, nelle coordinate dello schermo, che indica la posizione e le dimensioni del campo incentrato.

prcModified [out]

Rettangolo in base allo stato corrente del SUGGERIMENTo e alla posizione e alle dimensioni dell'elenco completo automatico preferito specificato da prcACList.

pfShownAboveTip [in, out]

TRUE se il rettangolo modificato deve essere visualizzato sopra l'area di destinazione del pannello di input di testo; in caso contrario, FALSE. Questo valore deve essere inizializzato nell'orientamento preferito del provider prima che venga chiamato il metodo.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_INVALIDARG	Chiamare il metodo ITipAutocompleteClient::RequestShowUI per impostare la finestra dell'elenco di completamento automatico popup prima di chiamare il metodo ITipAutocompleteClient::P referredRects.
E_FAIL	Si è verificato un errore non specificato.

Commenti

Questo è il metodo che il provider completo automatico chiama quando sta per visualizzare l'interfaccia utente completa automatica. Il client modifica il rettangolo preferito del provider specificato da prcACList tramite l'argomento prcModified .

Chiamare il metodo ITipAutocompleteClient::RequestShowUI per impostare l'handle della finestra dell'elenco di completamento automatico popup prima di chiamare PreferredRects. Se non si esegue questa operazione, si verificherà un errore di E_INVALIDARG quando si chiama PreferredRects.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Intestazione	TipAutoComplete.h (richiede anche Peninputpanel_i.c)
DLL	Tiptsf.dll

Vedi anche

Interfaccia ITipAutocompleteClient

Metodo ITipAutocompleteClient::RequestShowUI

Informazioni di riferimento sul pannello di input di testo