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
입력 시 이 필드는 초기화 및 생성 플래그를 지정합니다. 종료 시 사용자의 선택 항목을 지정합니다. 다음 플래그의 조합일 수 있습니다.
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 |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기