IsDialogMessageA-Funktion (winuser.h)
Bestimmt, ob eine Nachricht für das angegebene Dialogfeld vorgesehen ist und die Nachricht verarbeitet.
Syntax
BOOL IsDialogMessageA(
[in] HWND hDlg,
[in] LPMSG lpMsg
);
Parameter
[in] hDlg
Typ: HWND
Ein Handle des Dialogfelds.
[in] lpMsg
Typ: LPMSG
Ein Zeiger auf eine MSG-Struktur , die die zu überprüfende Nachricht enthält.
Rückgabewert
Typ: BOOL
Wenn die Nachricht verarbeitet wurde, ist der Rückgabewert nicht zero.
Wenn die Nachricht nicht verarbeitet wurde, ist der Rückgabewert null.
Hinweise
Obwohl die IsDialogMessage-Funktion für moduslose Dialogfelder vorgesehen ist, können Sie es mit jedem Fenster verwenden, das Steuerelemente enthält, sodass die Fenster dieselbe Tastaturauswahl bereitstellen können, wie in einem Dialogfeld verwendet wird.
Wenn IsDialogMessage eine Nachricht verarbeitet, sucht sie nach Tastaturnachrichten und konvertiert sie in Auswahlmöglichkeiten für das entsprechende Dialogfeld. Die TAB-TASTE, wenn sie gedrückt wird, wählt beispielsweise das nächste Steuerelement oder die GRUPPE der Steuerelemente aus, und die NACH-UNTEN-TASTE, wenn sie gedrückt wird, wählt das nächste Steuerelement in einer Gruppe aus.
Da die IsDialogMessage-Funktion alle erforderlichen Übersetzungen und Versendungen von Nachrichten ausführt, darf eine von IsDialogMessage verarbeitete Nachricht nicht an die Funktion "TranslateMessage " oder " DispatchMessage " übergeben werden.
IsDialogMessage sendet WM_GETDLGCODE Nachrichten an die Dialogfeldprozedur, um zu bestimmen, welche Schlüssel verarbeitet werden sollen.
IsDialogMessage kann DM_GETDEFID und DM_SETDEFID Nachrichten an das Fenster senden. Diese Nachrichten werden in der Winuser.h-Headerdatei als WM_USER und WM_USER + 1 definiert, sodass Konflikte mit anwendungsdefinierten Nachrichten mit denselben Werten möglich sind.
Hinweis
Der Winuser.h-Header definiert IsDialogMessage als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der codierungsneutralen Aliase mit Code, der nicht codierungsneutral ist, kann zu Übereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (enthalten Windows.h) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-dialogbox-l1-1-3 (eingeführt in Windows 10, Version 10.0.14393) |
Weitere Informationen
Konzept
Referenz