CheckDlgButton-Funktion (winuser.h)

Ändert den Überprüfungsstatus eines Schaltflächensteuerelements.

Syntax

BOOL CheckDlgButton(
  [in] HWND hDlg,
  [in] int  nIDButton,
  [in] UINT uCheck
);

[in] hDlg

Typ: HWND

Ein Handle für das Dialogfeld, das die Schaltfläche enthält.

[in] nIDButton

Typ: int

Der Bezeichner der zu ändernden Schaltfläche.

[in] uCheck

Typ: UINT

Der Überprüfungszustand der Schaltfläche. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
BST_CHECKED	Legt den Schaltflächenzustand auf aktiviert fest.
BST_INDETERMINATE	Legt den Schaltflächenzustand auf abgeblendet fest, was auf einen unbestimmten Zustand hinweist. Verwenden Sie diesen Wert nur, wenn die Schaltfläche über das BS_3STATE- oder BS_AUTO3STATE-Format verfügt.
BST_UNCHECKED	Legt den Schaltflächenstatus auf deaktiviert fest.

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.

Die CheckDlgButton-Funktion sendet eine BM_SETCHECK Nachricht an das angegebene Schaltflächensteuerelement im angegebenen Dialogfeld.

Ein Beispiel finden Sie unter Erstellen eines moduslosen Dialogfelds unter Verwenden von Dialogfeldern.


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-0 (eingeführt in Windows 8)

Referenz