Edit

IFileDialogCustomize::AddCheckButton method (shobjidl_core.h)

  • Article

Adds a check button (check box) to the dialog.

Syntax

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

Parameters

[in] dwIDCtl

Type: DWORD

The ID of the check button to add.

[in] pszLabel

Type: LPCWSTR

A pointer to a buffer that contains the button text as a null-terminated Unicode string.

[in] bChecked

Type: BOOL

A BOOL indicating the current state of the check button. TRUE if checked; FALSE otherwise.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The default state for this control is enabled and visible.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)