CheckRadioButton-Funktion (winuser.h)

  • Artikel

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

CheckDlgButton

IsDlgButtonChecked

Referenz