IFileDialogCustomize::StartVisualGroup method

Declares a visual group in the dialog. Subsequent calls to any "add" method add those elements to this group.

Syntax


HRESULT StartVisualGroup(
  [in] DWORD   dwIDCtl,
  [in] LPCWSTR pszLabel
);

Parameters

dwIDCtl [in]

Type: DWORD

The ID of the visual group.

pszLabel [in]

Type: LPCWSTR

A pointer to a buffer that contains text, as a null-terminated Unicode string, that appears next to the visual group.

Return value

Type: HRESULT

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

Remarks

Controls will continue to be added to this visual group until you call IFileDialogCustomize::EndVisualGroup.

A visual group can be hidden and disabled like any other control, except that doing so affects all of the controls within it. Individual members of the visual group can also be hidden and disabled singly.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

 

 

Show: