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.

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

Weitere Informationen

ITipAutocompleteClient-Schnittstelle

ITipAutocompleteClient::RequestShowUI-Methode

Texteingabebereichsreferenz