Share via

EvaluateProximityToRect-Funktion (winuser.h)

  • Artikel

Gibt den Score eines Rechtecks als wahrscheinliches Touchziel im Vergleich zu allen anderen Rechtecken, die den Touchkontaktbereich überschneiden, und einem angepassten Touchpunkt innerhalb des Rechtecks zurück.

Syntax

BOOL EvaluateProximityToRect(
  [in]  const RECT                             *controlBoundingBox,
  [in]  const TOUCH_HIT_TESTING_INPUT          *pHitTestingInput,
  [out] TOUCH_HIT_TESTING_PROXIMITY_EVALUATION *pProximityEval
);

Parameter

[in] controlBoundingBox

Die RECT-Struktur , die den Begrenzungsrahmen des UI-Elements definiert.

[in] pHitTestingInput

Die TOUCH_HIT_TESTING_INPUT Struktur, die die Daten für den Touchkontaktbereich enthält.

[out] pProximityEval

Die TOUCH_HIT_TESTING_PROXIMITY_EVALUATION Struktur, die die Bewertung und die angepassten Touchpunktdaten enthält.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird TRUE zurückgegeben.

Andernfalls wird FALSE zurückgegeben. Rufen Sie die GetLastError-Funktion auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Aus Gründen der Konsistenz mit Windows sollten Frameworks, die WM_TOUCHHITTESTING behandeln, die folgenden Prinzipien für die Ausrichtung verwenden:

  • Aufnahme: Wenn sich der Touchpunkt innerhalb der Grenzen eines Steuerelements befindet, wird der Touchpunkt nicht geändert.
  • Schnittmenge: Schließen Sie nur Steuerelemente ein, die die Kontaktgeometrie überschneiden.
  • Z-Reihenfolge: Wenn mehr als ein Steuerelement die Kontaktgeometrie überschneidet und sich die Steuerelemente überschneiden, erhält das Steuerelement, das in der Z-Reihenfolge am höchsten ist, Priorität.
  • Mehrdeutigkeit: Wenn mehr als ein Steuerelement die Kontaktgeometrie überschneidet und sich die Steuerelemente nicht überschneiden, erhält das Steuerelement, das dem ursprünglichen Touchpunkt am nächsten ist, Priorität.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile winuser.h
Bibliothek User32.lib
DLL User32.dll

Siehe auch

Funktionen