IColumnProvider 인터페이스(shlobj.h)

Windows Explorer 세부 정보 보기에서 사용자 지정 열을 추가하도록 설정하는 메서드를 노출합니다.

참고 Windows Vista를 기준으로 IColumnProvider 에 대한 지원이 제거되었습니다. Windows 속성 시스템이 그 자리에 사용됩니다. 새 시스템의 사용을 설명하는 개념 자료는 Windows 속성 시스템을 참조하세요.

 

상속

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

메서드

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

IColumnProvider::GetColumnInfo 열에 대한 정보를 요청합니다.
IColumnProvider::GetItemData 지정된 파일에 대한 열 데이터를 요청합니다.
IColumnProvider::Initialize IColumnProvider 인터페이스를 초기화합니다.

설명

Windows Explorer 세부 정보 보기에는 일반적으로 여러 표준 열이 표시됩니다. 각 열에는 현재 폴더의 각 파일에 대한 파일 크기 또는 형식과 같은 정보가 나열됩니다. 사용자가 표시하도록 선택할 수 있는 여러 열이 있을 수도 있습니다. 사용자가 열 머리글 중 하나를 마우스 오른쪽 단추로 클릭하면 사용 가능한 열 목록이 대화 상자에 표시됩니다. IColumnProvider 인터페이스를 내보내는 열 공급자 개체를 만들면 Windows Explorer 표시할 사용자 지정 열을 해당 대화 상자에 추가할 수 있습니다. 예를 들어 음악이 포함된 파일 컬렉션은 열 공급자를 사용하여 각 파일에 포함된 아티스트 및 조각을 나열하는 열을 표시할 수 있습니다.

열 공급자는 Windows Explorer 세부 정보 보기를 표시할 때마다 호출되는 전역 개체입니다. Windows Explorer 등록된 모든 열 공급자에게 열 특성을 쿼리합니다. 사용자가 열 공급자의 열 중 하나를 선택한 경우 Windows Explorer 폴더의 각 파일에 대해 연결된 데이터에 대해 열 공급자를 쿼리합니다. 그런 다음 선택한 모든 열을 표시합니다.

일반적으로 열 공급자는 특정 파일 형식에 대해 하나 이상의 사용자 지정 열을 표시하는 데 사용됩니다. 열 공급자가 데이터에 대한 요청을 받으면 파일이 지원되는 형식의 멤버인 경우 이를 제공합니다. 그렇지 않으면 S_FALSE 반환하여 요청을 무시합니다.

열은 fmtid pid/ 쌍을 포함하는 SHCOLUMNID 구조체로 식별됩니다. 가능하면 기존 fmtids 및 pids를 사용합니다. 폴더에 둘 이상의 파일 형식의 파일이 포함된 경우 다른 형식의 데이터를 동일한 열에 병합할 수 있습니다. instance 경우 요약 정보 속성 집합의 Author pid를 다양한 용도로 사용할 수 있습니다. 사용자 지정 SHCOLUMNID 구조를 사용하는 경우 열에는 지원되는 형식의 멤버인 파일에 대한 데이터만 표시됩니다. 폴더에 다른 파일이 포함된 경우 해당 항목은 비어 있습니다.

Windows Explorer 세부 정보 보기에 하나 이상의 사용자 지정 열을 표시하려는 경우 이 인터페이스를 내보내는 개체를 구현합니다. Windows Explorer 인터페이스 메서드를 호출하여 열을 표시하는 데 필요한 정보를 요청합니다. Windows Explorer 사용하는 절차는 다음과 같습니다.

1. IColumnProvider::Initialize를 호출하여 표시할 폴더를 지정합니다.
2. IColumnProvider::GetColumnInfo를 호출하여 열의 특성을 검색합니다.
3. 사용자가 열을 선택한 경우 폴더의 각 파일에 대해 IColumnProvider::GetItemData 를 호출하여 파일의 열 항목에 속한 데이터를 검색합니다.

일반 COM(구성 요소 개체 모델) 등록 외에도 열 공급자 개체도 Windows Explorer 등록해야 합니다. 이렇게 하려면 개체 GUID의 문자열 형식을 사용하여 이라는 하위 키를 이 키에 추가합니다.

HKEY_CLASSES_ROOT
   Folder
      shellex
         ColumnHandlers

이 인터페이스는 Windows Explorer 호출됩니다. 일반적으로 애플리케이션에서 사용되지 않습니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shlobj.h