PFNCOMPROPSHEET 콜백 함수(compstui.h)

아티클
03/08/2023

ComPropSheet 함수는 CPSUI에서 제공하며 CPSUI 애플리케이션(프린터 인터페이스 DLL 포함)에서 호출하여 속성 시트 페이지를 빌드할 수 있습니다.

구문

PFNCOMPROPSHEET Pfncompropsheet;

LONG_PTR Pfncompropsheet(
  [in] HANDLE hComPropSheet,
  [in] UINT Function,
  [in] LPARAM lParam1,
  [in] LPARAM lParam2
)
{...}

매개 변수

[in] hComPropSheet

속성 시트 그룹 부모에 대한 호출자 제공 핸들입니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

[in] Function

ComPropSheet 함수에서 수행할 작업을 지정하는 호출자 제공 CPSFUNC_ 접두사 ComPropSheet 함수 코드입니다. 아래의 설명 섹션에서 ComPropSheet 함수 코드 테이블을 참조하세요.

[in] lParam1

함수에 제공된 ComPropSheet 함수 코드에 따라 달라지는 호출자 제공 값입니다.

[in] lParam2

함수에 제공된 ComPropSheet 함수 코드에 따라 달라지는 호출자 제공 값입니다.

반환 값

반환 값은 Function에 제공된 ComPropSheet 함수 코드에 따라 달라집니다.

설명

CPSUI는 애플리케이션의 PFNPROPSHEETUI 형식 함수 중 하나를 호출할 때 PROPSHEETUI_INFO 구조에서 ComPropSheet 함수에 대한 포인터를 전달합니다. PFNPROPSHEETUI 형식 함수는 ComPropSheet 함수를 호출하여 CPSUI에 대한 속성 시트 페이지를 설명할 수 있습니다.

프린터 인터페이스 DLL은 DrvDocumentPropertySheets 함수 또는 DrvDevicePropertySheets 함수 내에서 ComPropSheet를 호출할 수 있습니다.

Microsoft의 Unidrv 및 Pscript 드라이버용 사용자 인터페이스 플러그 인은 IPrintOemUI::D ocumentPropertySheets 및 IPrintOemUI::D evicePropertySheets 메서드 내에서 ComPropSheet를 호출할 수 있습니다.

hComPropSheet 매개 변수에 지정된 그룹 부모 핸들은 다음 중 하나일 수 있습니다.

PROPSHEETUI_INFO 구조체의 hComPropSheet 멤버에서 받은 핸들입니다.
이전에 CPSFUNC_INSERT_PSUIPAGE 함수 코드를 사용하여 ComPropSheet를 호출하고 PSUIPAGEINSERT_GROUP_PARENT INSERTPSUIPAGE_INFO 구조체의 Type 멤버로 지정한 결과로 받은 핸들입니다.

ComPropSheet 함수 코드

다음 함수 코드를 CPSUI의 ComPropSheet 함수에 전달할 수 있습니다.

CPSFUNC_ADD_HPROPSHEETPAGE

CPSFUNC_ADD_HPROPSHEETPAGE 함수 코드는 ComPropSheet 함수가 CreatePropertySheetPage 함수를 호출하여 만든 속성 시트 페이지를 추가하도록 합니다.

매개 변수(CPSFUNC_ADD_HPROPSHEETPAGE)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 속성 시트 페이지를 추가할 때 이 함수 코드 매개 변수를 CPSFUNC_ADD_HPROPSHEETPAGE 설정합니다.
lParam1: CreatePropertySheetPage 함수를 호출하여 가져온 속성 시트 페이지에 대한 핸들
lParam2: 사용되지 않음, 0이어야 합니다.

반환 값(CPSFUNC_ADD_HPROPSHEETPAGE)

작업이 성공하면 ComPropSheet 는 추가된 페이지에 CPSUI 핸들을 반환합니다. 그렇지 않으면 NULL을 반환합니다.

CPSFUNC_ADD_PCOMPROPSHEETUI

CPSFUNC_ADD_PCOMPROPSHEETUI 함수 코드를 사용하면 ComPropSheet 함수가 COMPROPSHEETUI 구조에 설명된 하나 이상의 속성 시트 페이지 집합을 추가합니다.

매개 변수

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 하나 이상의 속성 시트 페이지 집합을 추가할 때 이 함수 코드 매개 변수를 CPSFUNC_ADD_PCOMPROPSHEETUI 설정합니다.
lParam1: COMPROPSHEETUI 구조체에 대한 포인터
lParam2: 추가된 페이지 수를 받기 위한 32비트 위치에 대한 포인터이거나, 오류가 발생하면 ERR_CPSUI 접두사 오류 코드

반환 값

작업이 성공하면 ComPropSheet 는 추가된 페이지 집합에 대한 핸들을 반환합니다. 그렇지 않으면 함수는 NULL을 반환합니다.

CPSFUNC_ADD_PFNPROPSHEETUI

CPSFUNC_ADD_PFNPROPSHEETUI 함수 코드는 ComPropSheet 함수가 지정된 PFNPROPSHEETUI 형식 함수를 호출하도록 합니다. 이 함수는 하나 이상의 속성 시트 페이지 집합을 추가해야 합니다.

매개 변수(CPSFUNC_ADD_PFNPROPSHEETUI)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출할 때 이 함수 코드 매개 변수를 CPSFUNC_ADD_PFNPROPSHEETUI 설정합니다. 그런 다음 ComPropSheet 는 지정된 PFNPROPSHEETUI 형식 함수를 호출하여 하나 이상의 속성 시트 페이지 집합을 추가합니다.
lParam1: PFNPROPSHEETUI 형식 함수에 대한 포인터
lParam2: lParam 매개 변수에 대한 PFNPROPSHEETUI 형식 함수에 전달되는 32비트 값입니다.

반환 값(CPSFUNC_ADD_PFNPROPSHEETUI)

작업이 성공하면 ComPropSheet 는 추가된 페이지 집합에 대한 핸들을 반환합니다. 그렇지 않으면 함수는 NULL을 반환합니다.

CPSFUNC_ADD_PROPSHEETPAGE

CPSFUNC_ADD_PROPSHEETPAGE 함수 코드는 ComPropSheet 함수가 PROPSHEETPAGE 구조에 설명된 속성 시트 페이지의 형식을 추가하도록 합니다.

매개 변수(CPSFUNC_ADD_PROPSHEETPAGE)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 COMPropSheet를 호출하여 PROPSHEETPAGE 구조에 설명된 속성 시트 페이지의 형식을 추가할 때 이 함수 코드 매개 변수를 CPSFUNC_ADD_PROPSHEETPAGE 설정합니다. ComPropSheet 함수는 CreatePropertySheetPage 함수를 호출하고 PROPSHEETPAGE 구조체의 주소를 전달하여 페이지를 만듭니다.
lParam1: PROPSHEETPAGE 구조체에 대한 포인터
lParam2: 사용되지 않음, 0이어야 합니다.

반환 값(CPSFUNC_ADD_PROPSHEETPAGE)

작업이 성공하면 ComPropSheet 는 추가된 페이지에 CPSUI 핸들을 반환합니다. 그렇지 않으면 NULL을 반환합니다.

CPSFUNC_DELETE_HCOMPROPSHEET

CPSFUNC_DELETE_HCOMPROPSHEET 함수 코드는 ComPropSheet 함수가 CPSUI 핸들로 지정된 속성 시트 페이지 집합을 삭제하도록 합니다.

매개 변수(CPSFUNC_DELETE_HCOMPROPSHEET)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 속성 시트 페이지 집합을 삭제할 때 이 함수 코드 매개 변수를 CPSFUNC_DELETE_HCOMPROPSHEET 설정합니다.
lParam1: 삭제할 페이지 집합을 참조하는 CPSUI 핸들입니다. 이 핸들은 이전에 다음 함수 코드 중 하나를 사용하여 ComPropSheet 를 호출하여 가져와야 합니다.
- CPSFUNC_ADD_HPROPSHEETPAGE
- CPSFUNC_ADD_PCOMPROPSHEETUI
- CPSFUNC_ADD_PFNPROPSHEETUI
- CPSFUNC_ADD_PROPSHEETPAGE
- CPSFUNC_INSERT_PSUIPAGE
lParam2: 사용되지 않음, 0이어야 합니다.

반환 값(CPSFUNC_DELETE_HCOMPROPSHEET)

ComPropSheet 함수는 삭제된 속성 시트 페이지의 수를 반환합니다.

CPSFUNC_DO_APPLY_CPSUI

CPSFUNC_DO_APPLY_CPSUI 함수 코드는 ComPropSheet 함수가 PSN_APPLY 알림 메시지 배달을 시뮬레이션하도록 합니다.

CPSUI는 애플리케이션의 _CPSUICALLBACK 형식 콜백 함수에 CPSUICB_REASON_APPLYNOW 이유를 전달하여 CPSFUNC_DO_APPLY_CPSUI 함수 코드에 응답합니다.

매개 변수(CPSFUNC_DO_APPLY_CPSUI)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 PSN_APPLY 알림 메시지 배달을 시뮬레이션할 때 이 함수 코드 매개 변수를 CPSFUNC_DO_APPLY_CPSUI 설정합니다.
lParam1: 하나 이상의 속성 시트 페이지 집합을 가리키는 CPSUI 핸들입니다. 일반적으로 이 핸들은 이전에 CPSFUNC_IGNORE_CPSUI_PSN_APPLY 함수 코드를 사용하여 ComPropSheet 에 대한 lParam1 매개 변수로 지정되었습니다.
lParam2: 이 매개 변수는 다음 비트 플래그의 조합입니다.
- APPLYCPSUI_NO_NEWDEF - 현재 기본값(실행 취소 작업에 사용됨)을 변경하지 않으려면 이 플래그를 설정합니다. 모든 옵션의 현재 값이 실행 취소 작업에 사용되는 기본값이 되도록 하려면 이 플래그를 지웁니다.
- APPLYCPSUI_OK_CANCEL_BUTTON - 사용자가 확인 또는 취소 단추를 선택한 경우(또는 이 활동을 시뮬레이션하려는 경우) 이 플래그를 설정합니다. 사용자가 닫기 또는 지금 적용 단추를 선택한 경우(또는 이 활동을 시뮬레이션하려는 경우) 이 플래그를 지웁니다. 코드가 PSN_APPLY 메시지를 받도록 설정된 경우 코드는 PSHNOTIFY 구조의 lParam 멤버를 검사 합니다. 멤버가 0이면 이 비트를 지워야 합니다.

반환 값(CPSFUNC_DO_APPLY_CPSUI)

작업이 성공하면 ComPropSheet 함수는 0이 아닌 값을 반환합니다. 그렇지 않으면 0을 반환하고 지정된 페이지가 활성화됩니다.

CPSFUNC_IGNORE_CPSUI_PSN_APPLY 함수 코드를 사용하여 PSN_APPLY 알림 메시지의 CPSUI 처리를 사용하지 않도록 설정하는 경우 CPSFUNC_DO_APPLY_CPSUI 함수 코드를 사용하여 PSN_APPLY 메시지 배달을 시뮬레이션해야 합니다. 그렇지 않으면 속성 시트 페이지에 대한 사용자 변경 내용을 가져올 수 없습니다.

CPSFUNC_GET_HPSUIPAGES

CPSFUNC_GET_HPSUIPAGES 함수 코드는 ComPropSheet 함수가 속성 시트 페이지를 가리키는 CPSUI 핸들 배열을 반환하도록 합니다. 이러한 핸들은 지정된 그룹 부모 핸들과 연결된 자식 페이지를 식별합니다.

이 함수 코드를 사용하려면 다음 단계를 수행합니다.

comPropSheet를 호출하여 CPSFUNC_GET_PAGECOUNT 함수 코드를 지정하여 지정된 그룹 부모와 연결된 자식 페이지 수를 가져옵니다.
각 페이지에 대한 HANDLE 구조를 포함하기에 충분한 로컬 메모리를 할당합니다.
COMPropSheet를 다시 호출하여 CPSFUNC_GET_HPSUIPAGES 함수 코드와 로컬로 할당된 메모리의 주소를 지정하여 HANDLE 구조의 배열을 가져옵니다.

매개 변수(CPSFUNC_GET_HPSUIPAGES)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 CPSUI 핸들 배열을 검색할 때 이 함수 코드 매개 변수를 CPSFUNC_GET_HPSUIPAGES 설정합니다.
lParam1: HANDLE 구조체 배열에 대한 포인터
lParam2: lParam1이 가리키는 HANDLE 배열의 크기

반환 값(CPSFUNC_GET_HPSUIPAGES)

ComPropSheet 함수는 CPSUI가 HANDLE 배열에 배치하는 핸들 수를 반환합니다.

CPSFUNC_GET_PAGECOUNT

CPSFUNC_GET_PAGECOUNT 함수 코드는 ComPropSheet 함수가 지정된 그룹 부모 핸들의 자식 페이지인 속성 시트 페이지 수를 반환하도록 합니다.

매개 변수(CPSFUNC_GET_PAGECOUNT)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 자식 페이지 수를 반환할 때 이 함수 코드 매개 변수를 CPSFUNC_GET_PAGECOUNT 설정합니다.
lParam1: 사용되지 않음, 0이어야 합니다.
lParam2: 사용되지 않음, 0이어야 합니다.

반환 값(CPSFUNC_GET_PAGECOUNT)

ComPropSheet 함수는 계산된 페이지 수를 반환합니다.

CPSFUNC_GET_PFNPROPSHEETUI_ICON

CPSFUNC_GET_PFNPROPSHEETUI_ICON 함수 코드는 ComPropSheet 함수가 속성 시트 페이지 집합과 연결된 아이콘에 대한 핸들을 반환하도록 합니다. 페이지 집합은 이전에 PFNPROPSHEETUI 형식 함수에 의해 만들어졌어야 합니다.

ComPropSheet 함수는 지정된 페이지 핸들과 연결된 PFNPROPSHEETUI 형식 함수를 호출하고 PROPSHEETUI_REASON_GET_ICON 이유 값을 전달합니다. PFNPROPSHEETUI 형식 함수는 LoadImage 를 호출하고 bylParam2로 지정된 아이콘 크기를 제공하여 아이콘 리소스를 로드합니다.

매개 변수(CPSFUNC_GET_PFNPROPSHEETUI_ICON)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 속성 시트 페이지 집합과 연결된 아이콘에 대한 핸들을 검색할 때 이 함수 코드 매개 변수를 CPSFUNC_GET_PFNPROPSHEETUI_ICON 설정합니다.
lParam1: 속성 시트 페이지 집합을 참조하는 CPSUI 핸들입니다. 이 핸들은 이전에 CPSFUNC_ADD_PFNPROPSHEETUI 함수 코드를 사용하여 ComPropSheet를 호출하여 가져와야 합니다.
lParam2: 아이콘의 크기를 나타내는 두 개의 WORD 크기 값을 픽셀 단위로 지정합니다. LOWORD 값은 너비이고 HIWORD 값은 높이입니다. 이러한 값이 0이면 SM_CXICON 및 SM_CYICON 시스템 메트릭이 사용됩니다. 자세한 내용은 GetSystemMetrics를 참조하세요.

반환 값(CPSFUNC_GET_PFNPROPSHEETUI_ICON)

작업이 성공하면 ComPropSheet 함수는 아이콘 핸들을 반환합니다. 그렇지 않으면 NULL을 반환합니다.

CPSFUNC_IGNORE_CPSUI_PSN_APPLY

CPSFUNC_IGNORE_CPSUI_PSN_APPLY 함수 코드는 ComPropSheet 함수가 CPSUI의 PSN_APPLY 알림 메시지 처리를 사용하지 않도록 설정하거나 다시 사용하도록 설정합니다.

사용자가 속성 시트의 확인 또는 취소 단추를 선택하면 시스템에서 CPSUI에 PSN_APPLY 알림 메시지를 보냅니다. CPSUI는 애플리케이션의 _CPSUICALLBACK 형식 콜백 함수에 CPSUICB_REASON_APPLYNOW 이유를 전달하여 이 메시지에 응답합니다.

CPSUI의 PSN_APPLY 알림 메시지 처리를 사용하지 않도록 설정하는 경우 CPSFUNC_DO_APPLY_CPSUI 함수 코드를 사용하여 PSN_APPLY 메시지 배달을 시뮬레이션해야 합니다. 그렇지 않으면 속성 시트 페이지에 대한 사용자 변경 내용을 가져올 수 없습니다.

CPSFUNC_IGNORE_CPSUI_PSN_APPLY 함수 코드를 사용하지 않으면 기본적으로 CPSUI의 PSN_APPLY 알림 메시지 처리가 사용하도록 설정됩니다.

매개 변수(CPSFUNC_IGNORE_CPSUI_PSN_APPLY)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 CPSUI의 PSN_APPLY 알림 메시지 처리를 사용하지 않도록 설정하거나 다시 활성화할 때 이 함수 코드 매개 변수를 CPSFUNC_IGNORE_CPSUI_PSN_APPLY 설정합니다.
lParam1: 하나 이상의 속성 시트 페이지 집합을 참조하는 CPSUI 핸들입니다. 이 핸들은 이전에 함수 코드가 CPSFUNC_ADD_PCOMPROPSHEETUI ComPropSheet를 호출하거나 CPSFUNC_INSERT_PSUIPAGE 함수 코드와 삽입 형식의 PSUIPAGEINSERT_PROPSHEETPAGE 사용하여 가져와야 합니다.
lParam2: 0이 아닌 값은 CPSUI의 CPSUICB_REASON_APPLYNOW 전달을 사용하지 않도록 설정합니다. 0 값은 CPSUICB_REASON_APPLYNOW 이유의 배달을 다시 활성화합니다.

반환 값(CPSFUNC_IGNORE_CPSUI_PSN_APPLY)

작업이 성공하면 ComPropSheet 함수는 0이 아닌 값을 반환합니다. 그렇지 않으면 0을 반환합니다.

CPSFUNC_INSERT_PSUIPAGE

CPSFUNC_INSERT_PSUIPAGE 함수 코드는 ComPropSheet 함수가 특정 위치에 속성 시트 페이지 집합을 삽입하도록 합니다.

매개 변수(CPSFUNC_INSERT_PSUIPAGE)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 특정 위치에 속성 시트 페이지 집합을 삽입할 때 이 함수 코드 매개 변수를 CPSFUNC_INSERT_PSUIPAGE 설정합니다.
lParam1: 하나 이상의 속성 시트 페이지 집합에 대한 핸들을 지정합니다. 새 페이지는 lParam2가 가리키는 INSERTPSUIPAGE_INFO 구조체의 Mode 멤버에 따라 이러한 페이지 앞이나 뒤에 삽입됩니다. 이 핸들은 이전에 다음 함수 코드 중 하나를 사용하여 ComPropSheet 를 호출하여 가져와야 합니다.
- CPSFUNC_ADD_HPROPSHEETPAGE
- CPSFUNC_ADD_PCOMPROPSHEETUI
- CPSFUNC_ADD_PFNPROPSHEETUI
- CPSFUNC_ADD_PROPSHEETPAGE
- CPSFUNC_INSERT_PSUIPAGE
lParam2: 새 페이지를 삽입해야 하는 위치와 방법을 설명하는 INSERTPSUIPAGE_INFO 구조체에 대한 포인터입니다.

반환 값(CPSFUNC_INSERT_PSUIPAGE)

작업이 성공하면 ComPropSheet 함수는 삽입된 페이지 집합에 대한 핸들을 반환합니다. 그렇지 않으면 함수는 NULL을 반환합니다.

CPSFUNC_LOAD_CPSUI_ICON

CPSFUNC_LOAD_CPSUI_ICON 함수 코드는 ComPropSheet 함수가 CPSUI 제공 아이콘 리소스를 로드하도록 합니다.

CPSUI는 LoadImage 를 호출하여 지정된 아이콘 리소스를 로드합니다.

매개 변수(CPSFUNC_LOAD_CPSUI_ICON)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 COMPropSheet를 호출하여 CPSUI 제공 아이콘 리소스를 로드할 때 이 함수 코드 매개 변수를 CPSFUNC_LOAD_CPSUI_ICON 설정합니다.
lParam1: 로드할 CPSUI 제공 아이콘의 리소스 식별자입니다. Compstui.h에 정의된 IDI_CPSUI 접두사 식별자여야 합니다.
lParam2: 아이콘의 크기를 나타내는 두 개의 WORD 크기 값을 픽셀 단위로 지정합니다. LOWORD 값은 너비이고 HIWORD 값은 높이입니다. 이러한 값이 0이면 SM_CXICON 및 SM_CYICON 시스템 메트릭이 사용됩니다. 자세한 내용은 GetSystemMetrics를 참조하세요.

반환 값(CPSFUNC_LOAD_CPSUI_ICON)

작업이 성공하면 ComPropSheet 함수는 아이콘 핸들을 반환합니다. 그렇지 않으면 NULL을 반환합니다.

CPSFUNC_LOAD_CPSUI_STRING

CPSFUNC_LOAD_CPSUI_STRING 함수 코드는 ComPropSheet 함수가 CPSUI 제공 문자열 리소스를 로드하도록 합니다.

ComPropSheet 함수는 LoadString](/windows/win32/api/winuser/nf-winuser-loadstringw) 함수를 호출하여 지정된 문자열을 로드합니다.

매개 변수(CPSFUNC_LOAD_CPSUI_STRING)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 COMPropSheet를 호출하여 CPSUI 제공 문자열 리소스를 로드할 때 이 함수 코드 매개 변수를 CPSFUNC_LOAD_CPSUI_STRING 설정합니다.
lParam1: HIWORD(lParam2)에서 지정한 CPSUI 제공 문자열을 배치할 호출자 할당 버퍼에 대한 LPSTR 형식 포인터입니다.
lParam2: 다음 두 호출자 제공 값을 포함합니다.
- LOWORD(lParam2). lParam1이 가리키는 버퍼의 크기(바이트)입니다.
- HIWORD(lParam2). 로드할 CPSUI 제공 문자열의 리소스 식별자입니다. Compstui.h에 정의된 IDS_CPSUI 접두사 식별자여야 합니다.

반환 값(CPSFUNC_LOAD_CPSUI_STRING)

작업이 성공하면 ComPropSheet 함수는 문자열의 길이를 반환합니다. 잘못된 리소스 식별자를 지정하면 함수는 0을 반환합니다. lParam1이 NULL이거나 LOWORD(lParam2)가 0이면 함수는 -1을 반환합니다.

CPSFUNC_QUERY_DATABLOCK

CPSFUNC_QUERY_DATABLOCK 함수 코드는 ComPropSheet 함수가 이전에 CPSFUNC_SET_DATABLOCK 함수 코드를 사용하여 저장한 호출자 제공 데이터 블록을 검색하도록 합니다.

일반적으로 이 함수 코드는 _CPSUICALLBACK 형식의 콜백 함수(함수의 CPSUICBPARAM 구조에 CPSUICB_REASON_SETACTIVE Reason 값이 포함된 경우)에서 현재 페이지가 비활성 상태가 되기 전에 다른 페이지와 연결된 값을 검색하는 데 사용됩니다.

매개 변수(CPSFUNC_QUERY_DATABLOCK)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 호출자가 제공한 데이터 블록을 검색할 때 이 함수 코드 매개 변수를 CPSFUNC_QUERY_DATABLOCK 설정합니다.
lParam1: 요청된 데이터 블록을 받을 버퍼의 크기와 위치를 식별하는 CPSUIDATABLOCK 구조체에 대한 포인터입니다.
lParam2: 요청된 CPSUIDATABLOCK 구조를 식별하는 데 사용되는 DWORD 크기의 식별자 값입니다. 이 값은 CPSFUNC_SET_DATABLOCK 함수 코드를 사용하여 ComPropSheet에 대한 이전 호출에서 지정되어야 합니다.

반환 값(CPSFUNC_QUERY_DATABLOCK)

작업이 성공하면 ComPropSheet 함수는 검색된 데이터 블록의 크기를 나타내는 값을 반환합니다. lParam1이 NULL이거나 제공된 CPSUIDATABLOCK 구조체의 멤버 값이 0이면 ComPropSheet는 데이터 블록을 저장하는 데 필요한 크기를 반환합니다. 오류가 발생하면 함수는 0보다 작거나 같은 값을 반환합니다.

CPSFUNC_SET_DATABLOCK

CPSFUNC_SET_DATABLOCK 함수 코드는 ComPropSheet 함수가 호출자 제공 데이터 블록을 저장하도록 합니다. 이 함수 코드를 사용하여 속성 시트 페이지에 대한 정보를 다른 페이지에서 사용할 수 있도록 할 수 있습니다.

일반적으로 이 함수 코드는 비활성 상태가 되기 전에 페이지와 연결된 값을 저장하기 위해 _CPSUICALLBACK 형식의 콜백 함수(함수의 CPSUICBPARAM 구조에 CPSUICB_REASON_KILLACTIVE 이유 값이 포함된 경우)에서 사용됩니다.

매개 변수(CPSFUNC_SET_DATABLOCK)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 호출자가 제공한 데이터 블록을 저장할 때 이 함수 코드 매개 변수를 CPSFUNC_SET_DATABLOCK 설정합니다.
lParam1: 저장할 데이터 블록을 설명하는 CPSUIDATABLOCK 구조체에 대한 포인터
lParam2: 호출자 정의 DWORD 크기의 식별자 값입니다. CPSFUNC_QUERY_DATABLOCK 함수 코드를 사용하여 ComPropSheet에 대한 후속 호출에서 제공된 CPSUIDATABLOCK 구조를 식별하는 데 사용됩니다.

반환 값(CPSFUNC_SET_DATABLOCK)

작업이 성공하면 ComPropSheet 함수는 저장된 바이트 수를 나타내는 값을 반환합니다. 그렇지 않으면 0보다 작거나 같은 값을 반환합니다.

CPSFUNC_SET_DMPUB_HIDEBITS

CPSFUNC_SET_DMPUB_HIDEBITS 함수 코드는 ComPropSheet 함수가 지정된 문서 속성 옵션 집합을 "숨기"도록 하여 표시되지 않도록 합니다.

하나 이상의 문서 속성 시트 옵션에 대해 OPTITEM 구조를 정의하려는 경우 CPSFUNC_SET_DMPUB_HIDEBITS 함수 코드를 사용할 수 있지만 옵션을 사용자 수정할 수는 없습니다. 속성 시트 페이지는 COMPROPSHEETUI 구조를 사용하여 정의해야 하며 구조체의 pDlgPage 멤버는 CPSUI_PDLGPAGE_DOCPROP 또는 CPSUI_PDLGPAGE_ADVDOCPROP 합니다.

CPSFUNC_SET_DMPUB_HIDEBITS 함수 코드를 사용하는 경우 CPSFUNC_ADD_PCOMPROPSHEETUI 또는 CPSFUNC_INSERT_PSUIPAGE 함수 코드를 사용하여 페이지를 만들기 전에 ComPropSheet에 지정해야 합니다.

매개 변수(CPSFUNC_SET_DMPUB_HIDEBITS)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 지정된 문서 속성 옵션 집합을 "숨기"때 이 함수 코드 매개 변수를 CPSFUNC_SET_DMPUB_HIDEBITS 설정합니다.
lParam1: 숨길 옵션을 나타내는 비트 배열에 대한 포인터입니다. 이 배열은 MAKE_DMPUB_HIDEBIT(DMPub) 매크로를 사용하여 만들어야 합니다. 여기서 DMPub는 하나 이상의 DMPUB_ 접두사 상수의 OR 조합입니다. DMPUB_ 접두사 상수는 OPTITEM 구조에 대한 설명에 나열됩니다. 매크로 및 상수는 Compstui.h에 정의되어 있습니다.
lParam2: 사용되지 않음, 0이어야 합니다.

반환 값(CPSFUNC_SET_DMPUB_HIDEBITS)

작업이 성공하면 ComPropSheet 함수는 lParam1에 지정된 값을 반환합니다. 그렇지 않으면 0을 반환합니다.

CPSFUNC_SET_FUSION_CONTEXT

CPSFUNC_SET_FUSION_CONTEXT 지정된 페이지에 대한 Fusion 활성화 컨텍스트를 설정합니다.

페이지를 만들거나 삽입하려고 하는 경우 PROPSHEETPAGE 구조에서 활성화 컨텍스트를 지정하지 않으면 부모의 페이지 활성화 컨텍스트에서 생성됩니다.

부모의 활성화 컨텍스트가 설정되지 않은 경우 Compstui.dll 상위 수준 부모에 도달할 때까지 또는 활성화 컨텍스트가 올바르게 설정된 부모를 발견할 때까지 계속 부모의 부모를 조회합니다.

부모 중 어느 부모도 활성화 컨텍스트를 설정하지 않은 경우 Compstui.dll PROPSHEETPAGE 구조에서 활성화 컨텍스트를 지정하지 않습니다. 즉, PropertySheet 함수 호출자의 활성화 컨텍스트에서 페이지가 만들어집니다.

매개 변수(CPSFUNC_SET_FUSION_CONTEXT)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 지정된 페이지에 대한 Fusion 활성화 컨텍스트를 설정할 때 이 함수 코드 매개 변수를 CPSFUNC_SET_FUSION_CONTEXT 설정합니다.
lParam1: Fusion 컨텍스트에 대한 핸들을 지정합니다. Compstui.dll 핸들을 복제하여 내부 구조에 연결하므로 호출자가 핸들을 유지할 의무가 없습니다. Compstui.dll Compstui.dll 핸들이 삭제되면 전달된 컨텍스트 핸들을 해제합니다.
lParam2: 사용되지 않음, 0이어야 합니다.

반환 값(CPSFUNC_SET_FUSION_CONTEXT)

작업이 성공하면 ComPropSheet 함수는 0보다 큰 값을 반환합니다. 그렇지 않으면 ComPropSheet 는 0보다 작거나 같은 값을 반환합니다. 오류에 대한 자세한 내용은 GetLastError 함수를 사용합니다.

CPSFUNC_SET_HSTARTPAGE

CPSFUNC_SET_HSTARTPAGE 함수 코드는 ComPropSheet 함수가 지정된 속성 시트 페이지를 연결된 속성 시트의 맨 위 페이지로 표시하도록 합니다. 현재 속성 시트가 표시되면 지정된 페이지가 활성 페이지가 됩니다.

매개 변수(CPSFUNC_SET_HSTARTPAGE)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 지정된 속성 시트 페이지를 연결된 속성 시트의 맨 위 페이지로 표시할 때 이 함수 코드 매개 변수를 CPSFUNC_SET_HSTARTPAGE 설정합니다.
lParam1: 다음 함수 코드 중 하나를 사용하여 ComPropSheet 를 호출하여 이전에 가져온 호출자 제공 CPSUI 페이지 핸들입니다.
- CPSFUNC_ADD_HPROPSHEETPAGE
- CPSFUNC_ADD_PCOMPROPSHEETUI
- CPSFUNC_ADD_PFNPROPSHEETUI
- CPSFUNC_ADD_PROPSHEETPAGE
- CPSFUNC_INSERT_PSUIPAGE
핸들이 hComPropSheet로 지정된 그룹에 속하는 단일 페이지를 나타내는 경우 CPSUI는 이 페이지를 맨 위 페이지로 만듭니다.

핸들이 그룹 부모 핸들을 나타내는 경우( CPSFUNC_INSERT_PSUIPAGE 참조) lParam2 는 그룹의 페이지에 대한 0부터 시작하는 인덱스를 나타내고 인덱스가 나타내는 페이지가 맨 위 페이지가 됩니다.
lParam2: lParam1이 그룹 부모 핸들을 나타내는 경우 이 호출자 제공 값은 그룹의 페이지에 대한 0부터 시작하는 인덱스입니다. lParam1이 hComPropSheet로 지정된 그룹에 속하는 단일 페이지를 나타내는 경우 이 매개 변수는 사용되지 않습니다. lParam1에서 지정한 핸들이 CPSFUNC_ADD_PCOMPROPSHEETUI 함수 코드를 사용하여 가져온 경우 및 연결된 COMPROPSHEETUI 구조체의 pDlgPage 멤버가 CPSUI_PDLGPAGE_DOCPROP 설정된 경우 lParam2에 대해 다음 값 중 하나를 지정할 수 있습니다.
- SSP_STDPAGE1 - 레이아웃 페이지를 위쪽 페이지로 만듭니다.
- SSP_STDPAGE2 - 용지/품질 페이지를 맨 위 페이지로 만듭니다.
- SSP_TVPAGE - 고급 페이지를 위쪽 페이지로 만듭니다.

반환 값(CPSFUNC_SET_HSTARTPAGE)

작업이 성공하면 ComPropSheet 함수는 lParam1에 지정된 값을 반환합니다. 그렇지 않으면 0을 반환합니다.

CPSFUNC_SET_PSUIPAGE_ICON

CPSFUNC_SET_PSUIPAGE_ICON 함수 코드는 ComPropSheet 함수가 속성 시트 페이지의 탭에 할당된 아이콘을 추가, 바꾸기 또는 제거하도록 합니다.

lParam2에 아이콘 핸들이 포함되어 있고 lParam1로 지정된 페이지가 현재 표시되는 경우 CPSUI는 지정된 페이지의 탭에 아이콘을 추가합니다. 아이콘이 페이지에 이미 할당된 경우 이전 아이콘이 새 아이콘으로 바뀝 있습니다. lParam2가 0이면 현재 아이콘(있는 경우)이 제거됩니다.

CPSFUNC_SET_PSUIPAGE_ICON 함수 코드로 지정된 모든 아이콘의 경우 CPSUI는 이미지 크기를 16x16픽셀로 설정합니다.

아이콘 핸들은 LoadImage를 호출하여 가져와야 합니다.

매개 변수(CPSFUNC_SET_PSUIPAGE_ICON)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 속성 시트 페이지의 탭에 할당된 아이콘을 추가, 바꾸기 또는 제거할 때 이 함수 코드 매개 변수를 CPSFUNC_SET_PSUIPAGE_ICON 설정합니다.
lParam1: 다음 함수 코드 중 하나를 사용하여 ComPropSheet 를 호출하여 이전에 가져온 호출자 제공 CPSUI 페이지 핸들입니다.
- CPSFUNC_ADD_HPROPSHEETPAGE
- CPSFUNC_ADD_PROPSHEETPAGE
- CPSFUNC_INSERT_PSUIPAGE ( INSERTPSUIPAGE_INFO 구조체의 Type 멤버를 PSUIPAGEINSERT_HPROPSHEETPAGE 또는PSUIPAGEINSERT_PROPSHEETPAGE 로 설정)
lParam2: 호출자가 제공한 아이콘 핸들입니다. 이 매개 변수를 0으로 설정하여 현재 아이콘을 제거할 수 있습니다.

반환 값(CPSFUNC_SET_PSUIPAGE_ICON)

작업이 성공하면 ComPropSheet 함수는 1을 반환합니다. 오류가 발생하거나 지정된 페이지가 현재 표시되지 않으면 함수는 0을 반환합니다.

CPSFUNC_SET_PSUIPAGE_TITLE

CPSFUNC_SET_PSUIPAGE_TITLE 함수 코드는 ComPropSheet 함수가 속성 시트 페이지의 탭 제목을 설정하도록 합니다.

매개 변수(CPSFUNC_SET_PSUIPAGE_TITLE)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 속성 시트 페이지의 탭 제목을 설정할 때 이 함수 코드 매개 변수를 CPSFUNC_SET_PSUIPAGE_TITLE 설정합니다.
lParam1: 다음 함수 코드 중 하나를 사용하여 ComPropSheet 를 호출하여 이전에 가져온 호출자 제공 CPSUI 페이지 핸들입니다.
- CPSFUNC_ADD_HPROPSHEETPAGE
- CPSFUNC_ADD_PROPSHEETPAGE
- CPSFUNC_INSERT_PSUIPAGE ( INSERTPSUIPAGE_INFO 구조체의 Type 멤버가 PSUIPAGEINSERT_HPROPSHEETPAGE 또는PSUIPAGEINSERT_PROPSHEETPAGE).
lParam2: 새 제목을 지정하는 NULL로 종료된 문자열에 대한 호출자 제공 포인터

반환 값(CPSFUNC_SET_PSUIPAGE_TITLE)

작업이 성공하면 ComPropSheet 함수는 1을 반환합니다. 오류가 발생하거나 지정된 페이지가 현재 표시되지 않는 경우 함수는 0을 반환합니다.

CPSFUNC_SET_RESULT

CPSFUNC_SET_RESULT 함수 코드를 사용하면 ComPropSheet 함수가 지정된 페이지 및 해당 부모에 연결된 모든 PFNPROPSHEETUI 형식 함수에 지정된 결과 값을 전달합니다.

결과 값을 설정하는 방법에 대한 자세한 내용은 SETRESULT_INFO 구조체에 대한 설명을 참조하세요.

다음 주의 사항은 사용자 지정 UI 속성 시트가 있는 Unidrv 또는 Pscript5 기반 IHV UI 플러그 인에 적용되며 속성 시트에서 만든 사용자 설정은 영구적이어야 합니다. 플러그 인이 함수 매개 변수가 CPSFUNC_SET_RESULT 설정된 ComPropSheet 함수를 호출하는 경우 플러그 인은 lParam2 매개 변수를 CPSUI_OK 설정해야 합니다.

매개 변수(CPSFUNC_SET_RESULT)

hComPropSheet: 그룹 부모 핸들
함수: 호출자는 ComPropSheet를 호출하여 지정된 페이지 및 해당 부모에 연결된 모든 PFNPROPSHEETUI 형식 함수에 지정된 결과 값을 전달할 때 이 함수 코드 매개 변수를 CPSFUNC_SET_RESULT 설정합니다.
lParam1: 결과 값이 전달되는 페이지에 대한 호출자 제공 CPSUI 핸들입니다. lParam1이 NULL인 경우 CPSUI는 hComPropSheet에 지정된 값을 사용합니다.
lParam2: 호출자가 제공한 32비트 DWORD 결과 값입니다.

반환 값(CPSFUNC_SET_RESULT)

작업이 성공하면 ComPropSheet 함수는 호출된 PFNPROPSHEETUI 형식 함수 수를 반환합니다. lParam1에 지정된 핸들이 유효하지 않으면 함수는 -1을 반환합니다.

요구 사항

요구 사항	값
대상 플랫폼	데스크톱
머리글	compstui.h(Compstui.h 포함)

PFNCOMPROPSHEET 콜백 함수(compstui.h)

구문

매개 변수

반환 값

설명

ComPropSheet 함수 코드

CPSFUNC_ADD_HPROPSHEETPAGE

매개 변수(CPSFUNC_ADD_HPROPSHEETPAGE)

반환 값(CPSFUNC_ADD_HPROPSHEETPAGE)

CPSFUNC_ADD_PCOMPROPSHEETUI

매개 변수

반환 값

CPSFUNC_ADD_PFNPROPSHEETUI

매개 변수(CPSFUNC_ADD_PFNPROPSHEETUI)

반환 값(CPSFUNC_ADD_PFNPROPSHEETUI)

CPSFUNC_ADD_PROPSHEETPAGE

매개 변수(CPSFUNC_ADD_PROPSHEETPAGE)

반환 값(CPSFUNC_ADD_PROPSHEETPAGE)

CPSFUNC_DELETE_HCOMPROPSHEET

매개 변수(CPSFUNC_DELETE_HCOMPROPSHEET)

반환 값(CPSFUNC_DELETE_HCOMPROPSHEET)

CPSFUNC_DO_APPLY_CPSUI

매개 변수(CPSFUNC_DO_APPLY_CPSUI)

반환 값(CPSFUNC_DO_APPLY_CPSUI)

CPSFUNC_GET_HPSUIPAGES

매개 변수(CPSFUNC_GET_HPSUIPAGES)

반환 값(CPSFUNC_GET_HPSUIPAGES)

CPSFUNC_GET_PAGECOUNT

매개 변수(CPSFUNC_GET_PAGECOUNT)

반환 값(CPSFUNC_GET_PAGECOUNT)

CPSFUNC_GET_PFNPROPSHEETUI_ICON

매개 변수(CPSFUNC_GET_PFNPROPSHEETUI_ICON)

반환 값(CPSFUNC_GET_PFNPROPSHEETUI_ICON)

CPSFUNC_IGNORE_CPSUI_PSN_APPLY

매개 변수(CPSFUNC_IGNORE_CPSUI_PSN_APPLY)

반환 값(CPSFUNC_IGNORE_CPSUI_PSN_APPLY)

CPSFUNC_INSERT_PSUIPAGE

매개 변수(CPSFUNC_INSERT_PSUIPAGE)

반환 값(CPSFUNC_INSERT_PSUIPAGE)

CPSFUNC_LOAD_CPSUI_ICON

매개 변수(CPSFUNC_LOAD_CPSUI_ICON)

반환 값(CPSFUNC_LOAD_CPSUI_ICON)

CPSFUNC_LOAD_CPSUI_STRING

매개 변수(CPSFUNC_LOAD_CPSUI_STRING)

반환 값(CPSFUNC_LOAD_CPSUI_STRING)

CPSFUNC_QUERY_DATABLOCK

매개 변수(CPSFUNC_QUERY_DATABLOCK)

반환 값(CPSFUNC_QUERY_DATABLOCK)

CPSFUNC_SET_DATABLOCK

매개 변수(CPSFUNC_SET_DATABLOCK)

반환 값(CPSFUNC_SET_DATABLOCK)

CPSFUNC_SET_DMPUB_HIDEBITS

매개 변수(CPSFUNC_SET_DMPUB_HIDEBITS)

반환 값(CPSFUNC_SET_DMPUB_HIDEBITS)

CPSFUNC_SET_FUSION_CONTEXT

매개 변수(CPSFUNC_SET_FUSION_CONTEXT)

반환 값(CPSFUNC_SET_FUSION_CONTEXT)

CPSFUNC_SET_HSTARTPAGE

매개 변수(CPSFUNC_SET_HSTARTPAGE)

반환 값(CPSFUNC_SET_HSTARTPAGE)

CPSFUNC_SET_PSUIPAGE_ICON

매개 변수(CPSFUNC_SET_PSUIPAGE_ICON)

반환 값(CPSFUNC_SET_PSUIPAGE_ICON)

CPSFUNC_SET_PSUIPAGE_TITLE

매개 변수(CPSFUNC_SET_PSUIPAGE_TITLE)

반환 값(CPSFUNC_SET_PSUIPAGE_TITLE)

CPSFUNC_SET_RESULT

매개 변수(CPSFUNC_SET_RESULT)

반환 값(CPSFUNC_SET_RESULT)

요구 사항

피드백

피드백

추가 리소스