IDvdInfo2::GetButtonAtPosition-Methode (strmif.h)
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Die GetButtonAtPosition
-Methode ruft die Schaltfläche ab, die sich an dem angegebenen Punkt im Anzeigefenster befindet.
HRESULT GetButtonAtPosition(
[in] POINT point,
[out] ULONG *pulButtonIndex
);
[in] point
Aktuelle Mauszeigerposition, wie sie über die Win32-WM_MOUSEMOVE-Nachricht abgerufen wird.
[out] pulButtonIndex
Empfängt den Index (von 1 bis 36) der Schaltfläche an der aktuellen Mauszeigerposition.
Gibt einen der folgenden HRESULT-Werte zurück.
Rückgabecode | BESCHREIBUNG |
---|---|
|
Erfolg. |
|
Ungültiges Argument. |
|
Der puButtonIndex-Parameter ist ungültig. |
|
Keine Schaltfläche zu einem Zeitpunkt. |
Diese Methode wird in der Regel als Reaktion auf eine Mauszeigerbewegung innerhalb eines DVD-Menüanzeigefensters aufgerufen. Überprüfen Sie unbedingt, ob das HRESULT erfolgreich ist, bevor Sie versuchen, die Schaltflächennummer abzurufen. Diese Methode legt den Wert von puButtonIndex nur fest, wenn an dem angegebenen Punkt eine Schaltfläche gefunden wird. DVD-Schaltflächen verfügen nicht unbedingt über hervorgehobene Rechtecke, Schaltflächenrechtecke können sich überlappen, und Schaltflächenrechtecke entsprechen nicht immer der visuellen Darstellung der Schaltflächen.
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | strmif.h (include Dshow.h) |
Bibliothek | Strmiids.lib |