OLEUICONVERTW 구조체(oledlg.h)

OLE 사용자 인터페이스 라이브러리가 변환 대화 상자를 초기화하는 데 사용하는 정보와 대화 상자가 해제될 때 라이브러리가 정보를 반환할 수 있는 공간이 포함되어 있습니다.

구문

typedef struct tagOLEUICONVERTW {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCWSTR       lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCWSTR       lpszTemplate;
  HRSRC         hResource;
  CLSID         clsid;
  CLSID         clsidConvertDefault;
  CLSID         clsidActivateDefault;
  CLSID         clsidNew;
  DWORD         dvAspect;
  WORD          wFormat;
  BOOL          fIsLinkedObject;
  HGLOBAL       hMetaPict;
  LPWSTR        lpszUserType;
  BOOL          fObjectsIconChanged;
  LPWSTR        lpszDefLabel;
  UINT          cClsidExclude;
  LPCLSID       lpClsidExclude;
} OLEUICONVERTW, *POLEUICONVERTW, *LPOLEUICONVERTW;

멤버

cbStruct

구조체의 크기(바이트)입니다. 이 멤버는 입력에 채워야 합니다.

dwFlags

입력 시 이 필드는 초기화 및 생성 플래그를 지정합니다. 종료 시 사용자의 선택 항목을 지정합니다. 다음 플래그의 조합일 수 있습니다.

값	의미
CF_SHOWHELPBUTTON	대화 상자에 도움말 단추가 표시됩니다. 이 플래그는 입력 시 설정됩니다.
CF_SETCONVERTDEFAULT	clsidConvertDefault에 의해 CLSID가 지정된 클래스가 기본 선택 영역으로 사용됩니다. 이 선택 영역은 변환 대상 라디오 단추를 선택하면 클래스 목록 상자에 나타납니다. 이 플래그는 입력 시 설정됩니다.
CF_SETACTIVATEDEFAULT	CLSID가 clsidActivateDefault로 지정된 클래스가 기본 선택 영역으로 사용됩니다. 이 선택 항목은 활성화 라디오 단추를 선택하면 클래스 목록 상자에 나타납니다. 이 플래그는 입력 시 설정됩니다.
CF_SELECTCONVERTTO	입력 시 이 플래그는 변환 대상 을 처음에 선택하도록 지정합니다(기본 동작). 이 플래그는 사용자가 대화 상자를 닫을 때 변환 대상 을 선택한 경우 출력에 설정됩니다.
CF_SELECTACTIVATEAS	입력 시 이 플래그는 As 활성화 가 처음에 선택되도록 지정합니다. 이 플래그는 사용자가 대화 상자를 닫을 때 다른 이름으로 활성화 를 선택한 경우 출력에 설정됩니다.
CF_DISABLEDISPLAYASICON	초기화 시 아이콘으로 표시 단추가 비활성화됩니다.
CF_DISABLEACTIVATEAS	초기화 시 활성화 라디오 단추가 비활성화됩니다.
CF_HIDECHANGEICON	변경 아이콘 단추는 변환 대화 상자에 숨겨집니다.
CF_CONVERTONLY	변환 대화 상자에서 다른 이름으로 활성화 라디오 단추를 사용할 수 없습니다.

hWndOwner

대화 상자를 소유하는 창입니다. 이 멤버는 NULL이 아니어야 합니다.

lpszCaption

대화 상자의 제목으로 사용할 문자열에 대한 포인터입니다. NULL인 경우 라이브러리는 Convert를 사용합니다.

lpfnHook

대화 상자용 메시지를 처리하는 후크 함수에 대한 포인터입니다. 후크 함수는 라이브러리의 대화 상자 프로시저로 다시 처리되지 않았다는 메시지를 전달하려면 0을 반환해야 합니다. 후크 함수는 라이브러리의 대화 상자 프로시저가 이미 처리한 메시지를 처리하지 못하도록 0이 아닌 값을 반환해야 합니다.

lCustData

라이브러리가 lpfnHook 멤버가 가리키는 후크 함수에 전달하는 애플리케이션 정의 데이터입니다. 라이브러리는 WM_INITDIALOG 메시지의 lParam 매개 변수에서 OLEUICONVERT 구조체에 대한 포인터를 전달합니다. 이 포인터를 사용하여 lCustData 멤버를 검색할 수 있습니다.

hInstance

lpszTemplate 멤버가 지정한 대화 상자 템플릿을 포함하는 인스턴스입니다. lpszTemplate 멤버가 NULL이거나 잘못된 경우 이 멤버는 무시됩니다.

lpszTemplate

라이브러리의 변환 대화 상자 템플릿으로 대체될 대화 상자 템플릿의 리소스 파일 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.

hResource

사용자 지정 대화 상자의 리소스 핸들입니다. 이 멤버가 NULL인 경우 라이브러리는 표준 변환 대화 상자 템플릿을 사용하거나 유효한 경우 lpszTemplate 멤버로 명명된 템플릿을 사용합니다.

clsid

변환하거나 활성화할 개체의 CLSID입니다. 이 멤버는 입력 시 설정됩니다.

clsidConvertDefault

변환 대상을 선택할 때 기본 클래스로 사용할 CLSID입니다. dwFlags 멤버에 CF_SETCONVERTDEFAULT 포함되지 않으면 이 멤버는 무시됩니다. 이 멤버는 입력 시 설정됩니다.

clsidActivateDefault

다른 것으로 활성화를 선택할 때 기본 클래스로 사용할 CLSID입니다. dwFlags 멤버에 CF_SETACTIVATEDEFAULT 포함되지 않으면 이 멤버는 무시됩니다. 이 멤버는 입력 시 설정됩니다.

clsidNew

선택한 클래스의 CLSID입니다. 이 멤버는 출력에서 설정됩니다.

dvAspect

개체의 측면입니다. DVASPECT_CONTENT 또는 DVASPECT_ICON 합니다. dvAspect가 입력에 DVASPECT_ICON 경우 표시 아이콘 상자가 선택되고 개체의 아이콘이 표시됩니다. 이 멤버는 입력 및 출력에 설정됩니다. 자세한 내용은 DVASPECT을 참조하세요.

wFormat

변환하거나 활성화할 개체의 데이터 형식입니다.

fIsLinkedObject

개체가 연결된 경우 TRUE입니다. 이 멤버는 입력 시 설정됩니다.

hMetaPict

상징적인 측면을 포함하는 METAFILEPICT 입니다. 이 멤버는 입력 및 출력에 설정됩니다.

lpszUserType

변환하거나 활성화할 개체의 사용자 유형 이름에 대한 포인터입니다. 이 값이 NULL이면 대화 상자가 레지스트리에서 사용자 유형 이름을 검색합니다. 이 문자열은 종료 시 해제됩니다.

fObjectsIconChanged

개체 의 아이콘이 변경되면 TRUE입니다. 즉, OleUIChangeIcon 이 호출되고 취소되지 않은 경우 입니다. 이 멤버는 출력에서 설정됩니다.

lpszDefLabel

아이콘에 사용할 기본 레이블에 대한 포인터입니다. NULL인 경우 짧은 사용자 유형 이름이 사용됩니다. 개체가 링크인 경우 호출자는 링크 원본의 표시 이름을 전달해야 합니다. 이는 출구에서 해제됩니다.

cClsidExclude

lpClsidExclude의 CLSID 수입니다.

lpClsidExclude

목록에서 제외할 CLSID 목록에 대한 포인터입니다.

설명

참고

oledlg.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 OLEUICONVERT를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	oledlg.h

추가 정보

OleUIChangeIcon

OleUIConvert