OLEUICHANGEICONW 구조체(oledlg.h)

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

구문

typedef struct tagOLEUICHANGEICONW {
  DWORD         cbStruct;
  DWORD         dwFlags;
  HWND          hWndOwner;
  LPCWSTR       lpszCaption;
  LPFNOLEUIHOOK lpfnHook;
  LPARAM        lCustData;
  HINSTANCE     hInstance;
  LPCWSTR       lpszTemplate;
  HRSRC         hResource;
  HGLOBAL       hMetaPict;
  CLSID         clsid;
  WCHAR         szIconExe[MAX_PATH];
  int           cchIconExe;
} OLEUICHANGEICONW, *POLEUICHANGEICONW, *LPOLEUICHANGEICONW;

멤버

cbStruct

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

dwFlags

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

값	의미
CIF_SHOWHELP	대화 상자에 도움말 단추가 표시됩니다.
CIF_SELECTCURRENT	입력 시 초기화 시 현재 라디오 단추를 선택합니다. 종료할 때 사용자가 현재를 선택했음을 지정합니다.
CIF_SELECTDEFAULT	입력 시 초기화 시 기본 라디오 단추를 선택합니다. 종료할 때 사용자가 기본값을 선택했음을 지정합니다.
CIF_SELECTFROMFILE	입력 시 초기화 시 파일에서 라디오 단추를 선택합니다. 종료할 때 사용자가 파일에서를 선택했음을 지정합니다.
CIF_USEICONEXE	입력 전용입니다. 클래스에서 아이콘을 검색하는 대신 szIconExe 멤버에 지정된 실행 파일에서 아이콘을 추출합니다. 이는 OLE가 아닌 파일에 OLE 포함 또는 연결에 유용합니다.

hWndOwner

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

lpszCaption

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

lpfnHook

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

lCustData

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

hInstance

lpTemplateName 멤버가 지정한 대화 상자 템플릿을 포함하는 인스턴스입니다.

lpszTemplate

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

hResource

사용자 지정된 템플릿 핸들입니다.

hMetaPict

현재 및 최종 이미지입니다. 아이콘의 원본은 메타파일 자체에 포함됩니다.

clsid

입력 전용입니다. 기본 아이콘을 가져오는 데 사용할 클래스입니다.

szIconExe[MAX_PATH]

입력 전용입니다. 기본 아이콘을 추출할 실행 파일에 대한 포인터입니다. 이 멤버는 CIF_USEICONEXE dwFlags 멤버에 포함되어 있고 지정된 CLSID에서 클래스 아이콘을 검색하는 시도가 실패하지 않는 한 무시됩니다.

cchIconExe

입력 전용입니다. szIconExe의 문자 수입니다. CIF_USEICONEXE dwFlags 멤버에 포함되지 않는 한 이 멤버는 무시됩니다.

설명

참고

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10 빌드 20348
지원되는 최소 서버	Windows 10 빌드 20348
머리글	oledlg.h