CheckRadioButton-Funktion (winuser.h)
Fügt einem angegebenen Optionsfeld in einer Gruppe ein Häkchen hinzu (überprüft) und entfernt ein Häkchen aus allen anderen Optionsfeldern in der Gruppe.
Syntax
BOOL CheckRadioButton(
[in] HWND hDlg,
[in] int nIDFirstButton,
[in] int nIDLastButton,
[in] int nIDCheckButton
);
Parameter
[in] hDlg
Typ: HWND
Ein Handle für das Dialogfeld, das das Optionsfeld enthält.
[in] nIDFirstButton
Typ: int
Der Bezeichner des ersten Optionsfelds in der Gruppe.
[in] nIDLastButton
Typ: int
Der Bezeichner des letzten Optionsfelds in der Gruppe.
[in] nIDCheckButton
Typ: int
Der Bezeichner des auszuwählenden Optionsfelds.
Rückgabewert
Typ: BOOL
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Die CheckRadioButton-Funktion sendet eine BM_SETCHECK Nachricht an jedes der Optionsfelder in der angegebenen Gruppe.
Die Parameter nIDFirstButton und nIDLastButton geben einen Bereich von Schaltflächenbezeichnern an (normalerweise die Ressourcen-IDs der Schaltflächen). Die Position von Schaltflächen in der Aktivierreihenfolge ist irrelevant; wenn eine Schaltfläche Teil einer Gruppe ist, aber über eine ID außerhalb des angegebenen Bereichs verfügt, ist sie von diesem Aufruf nicht betroffen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (windows.h einschließen) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-dialogbox-l1-1-2 (eingeführt in Windows 10, Version 10.0.10240) |
Weitere Informationen
Referenz