EvaluateProximityToRect-Funktion (winuser.h)

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

Siehe auch

Funktionen