IsDlgButtonChecked-Funktion (winuser.h)
Die IsDlgButtonChecked-Funktion bestimmt, ob ein Schaltflächensteuerelement aktiviert ist oder ob ein Schaltflächensteuerelement mit drei Status aktiviert, deaktiviert oder unbestimmt ist.
Syntax
UINT IsDlgButtonChecked(
[in] HWND hDlg,
[in] int nIDButton
);
Parameter
[in] hDlg
Typ: HWND
Ein Handle für das Dialogfeld, das das Schaltflächensteuerelement enthält.
[in] nIDButton
Typ: int
Der Bezeichner des Schaltflächensteuerelements.
Rückgabewert
Typ: UINT
Der Rückgabewert einer Schaltfläche, die mit den Formatvorlagen BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTON oder BS_3STATE erstellt wurde, kann einer der Werte in der folgenden Tabelle sein. Wenn die Schaltfläche eine andere Formatvorlage aufweist, ist der Rückgabewert 0.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Schaltfläche ist aktiviert. |
|
Die Schaltfläche befindet sich in einem unbestimmten Zustand (gilt nur, wenn die Schaltfläche über das BS_3STATE - oder BS_AUTO3STATE-Format verfügt). |
|
Die Schaltfläche ist nicht aktiviert. |
Hinweise
Die IsDlgButtonChecked-Funktion sendet eine BM_GETCHECK Nachricht an das angegebene Schaltflächensteuerelement.
Beispiele
Ein Beispiel finden Sie im Abschnitt "Erstellen eines moduslosen Dialogfelds" unter Verwenden von Dialogfeldern.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (einschließlich Windows.h) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-dialogbox-l1-1-0 (in Windows 8 eingeführt) |