IDirectManipulationManager::RegisterHitTestTarget-Methode (directmanipulation.h)

Registriert einen dedizierten Thread für Treffertests.

Syntax

HRESULT RegisterHitTestTarget(
  [in]           HWND                            window,
  [in, optional] HWND                            hitTestWindow,
  [in]           DIRECTMANIPULATION_HITTEST_TYPE type
);

Parameter

[in] window

Das Handle des Standard App-Fensters (in der Regel aus dem UI-Thread erstellt).

[in, optional] hitTestWindow

Der Handle des Fensters, in dem Treffertests registriert sind (sollte aus dem Treffertestthread erstellt werden). Übergeben Sie nullptr, um die Registrierung eines zuvor registrierten Treffertestziels aufzuheben.

[in] type

Einer der Werte aus DIRECTMANIPULATION_HITTEST_TYPE. Gibt an, ob das Benutzeroberflächenfenster oder das Treffertestfenster (oder beides) den Treffertest WM_POINTERDOWN Meldung empfängt und in welcher Reihenfolge.

Rückgabewert

Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Treffertests werden in der Regel für den Anwendungs-UI-Thread ausgeführt. Die Anwendung empfängt eine WM_POINTERDOWN Meldung, für die Treffertests durchgeführt werden. Wenn eine Bearbeitung erforderlich ist, wird SetContact für einen oder mehrere Viewports aufgerufen. Eine Anwendung kann die RegisterHitTestTarget-Methode verwenden, um diese Verantwortung für Treffertests an einen separaten Treffertestthread zu delegieren.

Sobald ein dediziertes Treffertestziel erfolgreich registriert wurde, werden WM_POINTERDOWN Nachrichten im Treffertestthread verarbeitet. Wenn eine Bearbeitung wie Schwenken oder Zoomen erforderlich ist, wird SetContact aus diesem Thread aufgerufen.

Wenn SetContact nicht über den Treffertestthread aufgerufen wird, können WM_POINTERDOWN Nachrichten auf dem UI-Thread verarbeitet werden, je nach dem bei der Registrierung angegebenen DIRECTMANIPULATION_HITTEST_TYPE .

Wenn SetContact weder vom Treffertestthread noch vom UI-Thread aufgerufen wird, ignoriert die direkte Bearbeitung die Eingabe, die dann im UI-Thread verarbeitet wird.

Anforderungen

Weitere Informationen

IDirectManipulationManager