ITipAutocompleteClient::P referredRects-Methode
Ermöglicht es dem Client, vorzuschlagen, wo die automatisch abgeschlossene Liste positioniert werden soll, um Überschneidungen im Eingabebereich zu vermeiden.
Syntax
HRESULT PreferredRects(
[in] RECT *prcACList,
[in] RECT *prcField,
[out] RECT *prcModified,
[in, out] BOOL *pfShownAboveTip
);
Parameter
-
prcACList [in]
-
Ein Rechteck in Bildschirmkoordinaten, das den bevorzugten Standort des Anbieters und die Größe der Benutzeroberfläche der automatisch vervollständigen Liste angibt.
-
prcField [in]
-
Ein Rechteck in Bildschirmkoordinaten, das die Position und Größe des fokussierten Felds angibt.
-
prcModified [out]
-
Ein Rechteck, das auf dem aktuellen Status des TIP und dem bevorzugten automatischen Vervollständigungslistenspeicherort und der von prcACList angegebenen Größe basiert.
-
pfShownAboveTip [in, out]
-
TRUE , wenn das geänderte Rechteck über dem Zielbereich des Texteingabebereichs angezeigt werden soll; andernfalls FALSE. Dieser Wert muss mit der bevorzugten Ausrichtung des Anbieters initialisiert werden, bevor die -Methode aufgerufen wird.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Erfolg. |
|
Rufen Sie die ITipAutocompleteClient::RequestShowUI-Methode auf, um vor dem Aufrufen der ITipAutocompleteClient::P referredRects-Methode das Popupfenster der automatischen Vervollständigung festzulegen. |
|
Es ist ein unbekannter Fehler aufgetreten. |
Bemerkungen
Dies ist die Methode, die der AutoVervollständigen-Anbieter aufruft, wenn die Benutzeroberfläche für die automatische Vervollständigung angezeigt wird. Der Client ändert das bevorzugte Rechteck des Anbieters, das von prcACList über das Argument prcModified angegeben wird .
Rufen Sie die ITipAutocompleteClient::RequestShowUI-Methode auf, um das Popuphandle für automatisch abgeschlossene Listenfenster festzulegen, bevor Sie PreferredRects aufrufen. Andernfalls wird beim Aufrufen von PreferredRects ein E_INVALIDARG Fehler verursacht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Header |
|
| DLL |
|