OLEUICHANGESOURCEW 구조체(oledlg.h)
표준 원본 변경 대화 상자를 초기화하는 데 사용되는 정보를 포함합니다. 사용자가 링크의 대상 또는 원본을 수정할 수 있습니다. 링크에 대해 다른 파일 이름을 선택하거나 파일 내에서 항목 참조를 변경해야 할 수 있습니다(예: 링크가 있는 스프레드시트 내 셀의 대상 범위 변경).
구문
typedef struct tagOLEUICHANGESOURCEW {
DWORD cbStruct;
DWORD dwFlags;
HWND hWndOwner;
LPCWSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPCWSTR lpszTemplate;
HRSRC hResource;
OPENFILENAMEW *lpOFN;
DWORD dwReserved1[4];
LPOLEUILINKCONTAINERW lpOleUILinkContainer;
DWORD dwLink;
LPWSTR lpszDisplayName;
ULONG nFileLength;
LPWSTR lpszFrom;
LPWSTR lpszTo;
} OLEUICHANGESOURCEW, *POLEUICHANGESOURCEW, *LPOLEUICHANGESOURCEW;
멤버
cbStruct
구조체의 크기(바이트)입니다.
dwFlags
입력 시 이 필드는 초기화 및 생성 플래그를 지정합니다. 종료 시 사용자의 선택 항목을 지정합니다. 다음 플래그의 조합일 수 있습니다.
| 값 | 의미 |
|---|---|
|
도움말 단추를 사용하거나 표시합니다. |
|
링크의 유효성이 검사되었음을 나타냅니다. |
|
사용자가 확인을 누르면 링크 원본의 자동 유효성 검사를 사용하지 않도록 설정합니다. 이 플래그를 지정하는 경우 대화 상자가 확인을 반환할 때 원본의 유효성을 검사해야 합니다. |
hWndOwner
대화 상자를 소유하는 창입니다.
lpszCaption
대화 상자의 제목으로 사용할 문자열에 대한 포인터입니다. NULL인 경우 라이브러리는 소스 변경을 사용합니다.
lpfnHook
대화 상자용 메시지를 처리하는 후크 함수에 대한 포인터입니다. 후크 함수는 라이브러리의 대화 상자 프로시저로 다시 처리되지 않았다는 메시지를 전달하려면 0을 반환해야 합니다. 후크 함수는 라이브러리의 대화 상자 프로시저가 이미 처리된 메시지를 처리하지 못하도록 0이 아닌 값을 반환해야 합니다.
lCustData
라이브러리가 WM_INITDIALOG 메시지의 lParam 매개 변수에 있는 OLEUICHANGEICON 구조가 가리키는 후크 함수에 전달하는 애플리케이션 정의 데이터입니다. 이 포인터를 사용하여 lCustData 멤버를 검색할 수 있습니다.
hInstance
lpszTemplate 멤버가 지정한 대화 상자 템플릿을 포함하는 인스턴스입니다. lpszTemplate 멤버가 NULL이거나 잘못된 경우 이 멤버는 무시됩니다.
lpszTemplate
라이브러리의 변환 대화 상자 템플릿으로 대체될 대화 상자 템플릿의 리소스 파일 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.
hResource
사용자 지정 대화 상자의 리소스 핸들입니다. 이 멤버가 NULL인 경우 라이브러리는 표준 변환 대화 상자 템플릿을 사용하거나 유효한 경우 lpszTemplate 멤버로 명명된 템플릿을 사용합니다.
lpOFN
운영 체제에서 시스템 정의 열기 또는 다른 이름으로 저장 대화 상자를 초기화하는 데 사용하는 정보를 포함하는 OPENFILENAME 구조체에 대한 포인터 입니다.
dwReserved1[4]
이 멤버는 예약되어 있습니다.
lpOleUILinkContainer
링크 원본의 유효성을 검사하는 데 사용되는 IOleUILinkContainer 인터페이스의 컨테이너 구현에 대한 포인터입니다. 링크 편집 대화 상자는 이를 사용하여 컨테이너가 해당 링크를 조작할 수 있도록 합니다.
dwLink
링크 원본의 유효성을 검사하는 데 사용되는 컨테이너 정의 고유 링크 식별자입니다. lpOleUILinkContainer에서 사용됩니다.
lpszDisplayName
전체 원본 표시 이름에 대한 포인터입니다.
nFileLength
lpszDisplayName의 파일 모니커 부분입니다.
lpszFrom
변경된 원본의 접두사에 대한 포인터입니다.
lpszTo
변경할 원본의 접두사에 대한 포인터입니다.
설명
참고
oledlg.h 헤더는 OLEUICHANGESOURCE를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 머리글 | oledlg.h |