IFileDialogCustomize::AddCheckButton-Methode (shobjidl_core.h)

Fügt dem Dialogfeld eine Kontrollkästchenschaltfläche (Kontrollkästchen) hinzu.

Syntax

HRESULT AddCheckButton(
  [in] DWORD   dwIDCtl,
  [in] LPCWSTR pszLabel,
  [in] BOOL    bChecked
);

Parameter

[in] dwIDCtl

Art: DWORD

Die ID der hinzuzufügenden Überprüfungsschaltfläche.

[in] pszLabel

Typ: LPCWSTR

Ein Zeiger auf einen Puffer, der den Schaltflächentext als Unicode-Zeichenfolge mit Null-Endung enthält.

[in] bChecked

Typ: BOOL

Ein BOOL , der den aktuellen Zustand der Prüfschaltfläche angibt. TRUE , wenn aktiviert; False andernfalls.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der Standardzustand für dieses Steuerelement ist aktiviert und sichtbar.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)