IFileDialogCustomize::MakeProminent method (shobjidl_core.h)

Article
02/22/2024

Places a control in the dialog so that it stands out compared to other added controls.

Syntax

HRESULT MakeProminent(
  [in] DWORD dwIDCtl
);

Parameters

[in] dwIDCtl

Type: DWORD

The ID of the control.

Return value

Type: HRESULT

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

Remarks

This method causes the control to be placed near the Open or Save button instead of being grouped with the rest of the custom controls.

Only check buttons (check boxes), push buttons, combo boxes, and menus—or a visual group that contains only a single item of one of those types—can be made prominent.

Only one control can be marked in this way. If a dialog has only one added control, that control is marked as prominent by default.

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)

Share via