IFileDialogCustomize 인터페이스(shobjidl_core.h)

애플리케이션이 공통 파일 대화 상자에 컨트롤을 추가할 수 있도록 하는 메서드를 노출합니다.

상속

IFileDialogCustomize 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IFileDialogCustomize 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IFileDialogCustomize 인터페이스에는 이러한 메서드가 있습니다.

IFileDialogCustomize::AddCheckButton 대화 상자에 검사 단추(검사 상자)를 추가합니다.
IFileDialogCustomize::AddComboBox 대화 상자에 콤보 상자를 추가합니다.
IFileDialogCustomize::AddControlItem 대화 상자의 컨테이너 컨트롤에 항목을 추가합니다.
IFileDialogCustomize::AddEditBox 대화 상자에 편집 상자 컨트롤을 추가합니다.
IFileDialogCustomize::AddMenu 대화 상자에 메뉴를 추가합니다.
IFileDialogCustomize::AddPushButton 대화 상자에 단추를 추가합니다.
IFileDialogCustomize::AddRadioButtonList 대화 상자에 옵션 단추(라디오 단추라고도 함) 그룹을 추가합니다.
IFileDialogCustomize::AddSeparator 컨트롤을 시각적으로 분리할 수 있도록 대화 상자에 구분 기호를 추가합니다.
IFileDialogCustomize::AddText 대화 상자에 텍스트 콘텐츠를 추가합니다.
IFileDialogCustomize::EnableOpenDropDown 대화 상자의 열기 또는 저장 단추에서 드롭다운 목록을 사용하도록 설정합니다.
IFileDialogCustomize::EndVisualGroup 대화 상자에서 시각적 개체 그룹에 요소 추가를 중지합니다.
IFileDialogCustomize::GetCheckButtonState 대화 상자에서 검사 단추(검사 상자)의 현재 상태를 가져옵니다.
IFileDialogCustomize::GetControlItemState 대화 상자에 있는 컨테이너 컨트롤에 있는 항목의 현재 상태를 가져옵니다.
IFileDialogCustomize::GetControlState 지정된 컨트롤의 현재 표시 유형 및 사용 상태를 가져옵니다.
IFileDialogCustomize::GetEditBoxText 편집 상자 컨트롤의 현재 텍스트를 가져옵니다.
IFileDialogCustomize::GetSelectedControlItem 대화 상자의 지정된 컨테이너 컨트롤에서 특정 항목을 가져옵니다.
IFileDialogCustomize::MakeProminent 추가된 다른 컨트롤과 비교하여 눈에 띄는 컨트롤을 대화 상자에 배치합니다.
IFileDialogCustomize::RemoveAllControlItems 구현되지 않았습니다. (IFileDialogCustomize.RemoveAllControlItems)
IFileDialogCustomize::RemoveControlItem 대화 상자의 컨테이너 컨트롤에서 항목을 제거합니다.
IFileDialogCustomize::SetCheckButtonState 대화 상자에서 검사 단추(검사 상자)의 상태를 설정합니다.
IFileDialogCustomize::SetControlItemState 대화 상자에 있는 컨테이너 컨트롤에 있는 항목의 현재 상태를 설정합니다.
IFileDialogCustomize::SetControlItemText 컨트롤 항목의 텍스트를 설정합니다. 예를 들어 라디오 단추 또는 메뉴의 항목과 함께 제공되는 텍스트입니다.
IFileDialogCustomize::SetControlLabel 단추 텍스트 또는 편집 상자 레이블과 같은 컨트롤과 연결된 텍스트를 설정합니다.
IFileDialogCustomize::SetControlState 지정된 컨트롤의 현재 표시 유형 및 사용 상태를 설정합니다.
IFileDialogCustomize::SetEditBoxText 대화 상자에 있는 편집 상자 컨트롤의 텍스트를 설정합니다.
IFileDialogCustomize::SetSelectedControlItem 옵션 단추 그룹 또는 대화 상자에 있는 콤보 상자에서 특정 항목의 선택한 상태를 설정합니다.
IFileDialogCustomize::StartVisualGroup 대화 상자에서 시각적 개체 그룹을 선언합니다. "add" 메서드에 대한 후속 호출은 해당 요소를 이 그룹에 추가합니다.

설명

구현 시기

IFileDialogControlEvents 는 일반 파일 열기 대화 상자(CLSID_FileOpenDialog) 및 파일 저장 대화 상자(CLSID_FileSaveDialog)에 의해 구현됩니다.

컨트롤은 대화 상자가 표시되기 전에 대화 상자에 추가됩니다. 레이아웃은 추가되는 순서에 따라 암시됩니다. 대화 상자가 표시되면 컨트롤을 추가하거나 제거할 수 없지만 기존 컨트롤은 언제든지 숨기거나 사용하지 않도록 설정할 수 있습니다. 언제든지 레이블을 변경할 수도 있습니다.

컨테이너 컨트롤은 항목을 추가할 수 있는 컨트롤입니다. 컨테이너 컨트롤에는 콤보 상자, 메뉴, 열기 단추에 연결된 드롭다운 목록 및 모든 옵션 단추 그룹이 포함됩니다. 항목이 컨테이너에 표시되는 순서는 항목이 추가된 순서입니다. 순서를 다시 정렬할 수 있는 시설은 없습니다. ID는 부모 컨트롤로 범위가 지정됩니다. 메뉴를 제외한 컨테이너 컨트롤에는 선택한 항목이 있습니다.

컨테이너 컨트롤이 있는 항목은 활성화된 상태와 표시되는 상태를 제외하고 만든 후에는 변경할 수 없습니다. 그러나 언제든지 추가 및 제거할 수 있습니다. 예를 들어 메뉴의 텍스트를 변경해야 하는 경우 현재 메뉴를 제거하고 올바른 텍스트로 다른 메뉴를 추가해야 합니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)