_CPSUICALLBACK 콜백 함수(compstui.h)

_CPSUICALLBACK 함수 형식은 CPSUI 메시지 처리기로 사용하기 위한 콜백 함수를 정의하기 위해 CPSUI 애플리케이션(프린터 인터페이스 DLL 포함)에서 사용됩니다.

구문

_CPSUICALLBACK Cpsuicallback;

LONG Cpsuicallback(
  PCPSUICBPARAM pCPSUICBParam
)
{...}

매개 변수

pCPSUICBParam

CPSUICBPARAM 구조체에 대한 CPSUI 제공 포인터입니다.

반환 값

_CPSUICALLBACK 형식의 콜백 함수는 다음 표에 나열된 값 중 하나를 반환해야 합니다. 각 값은 CPSUI가 수행해야 하는 작업을 나타냅니다.

반환 코드	설명
CPSUICB_ACTION_ITEMS_APPLIED	CPSUICBPARAM 구조체의 Reason 멤버가 CPSUICB_REASON_APPLYNOW 설정되었으며 콜백 함수가 현재 옵션 값을 성공적으로 처리했습니다.
CPSUICB_ACTION_NO_APPLY_EXIT	CPSUICBPARAM 구조체의 Reason 멤버가 CPSUICB_REASON_APPLYNOW 설정되었지만 콜백 함수에서 유효하지 않거나 호환되지 않는 옵션 값을 검색했습니다. 콜백 함수는 사용자에게 문제를 알리는 대화 상자를 표시해야 합니다.
CPSUICB_ACTION_NONE	CPSUI에 의한 작업은 필요하지 않습니다.
CPSUICB_ACTION_OPTIF_CHANGED	콜백 함수는 OPTITEM 구조에서 OPTIF_CHANGED 플래그를 설정하여 선택한 옵션이 변경되었거나 다른 OPTIF 접두사 플래그가 변경되었음을 나타냅니다.
CPSUICB_ACTION_REINIT_ITEMS	콜백 함수는 OPTITEM 구조체에서 OPTIF_CHANGED 플래그를 설정하여 연결된 OPTTYPE 또는 OPTPARAM 구조체의 Flags 또는 pData 멤버가 변경되었음을 나타냅니다.

설명

_CPSUICALLBACK 함수 형식을 사용하여 지정된 콜백 함수는 CPSUI 를 사용하여 속성 시트 페이지를 관리하는 애플리케이션에서 제공합니다. 이러한 콜백 함수 중 하나가 속성 시트 페이지와 연결된 경우 CPSUI는 사용자 작업(예: 페이지의 컨트롤 포커스 변경, 옵션 값 수정 또는 확인 클릭)이 검색될 때 호출합니다.

_CPSUICALLBACK 형식의 콜백 함수는 함수 코드가 CPSFUNC_ADD_PCOMPROPSHEETUI 때 CPSUI의 ComPropSheet 함수에 전달되는 COMPROPSHEETUI 구조에 주소를 포함하여 속성 시트 페이지에 할당됩니다.

또한 EXTPUSH 구조를 사용하여 확장된 푸시 단추에 콜백 함수를 할당할 수 있습니다.

이러한 콜백 함수 중 하나가 호출되면 CPSUICBPARAM 구조체에 대한 포인터를 받습니다. 이 구조체는 페이지의 현재 옵션 설정을 설명하고 함수를 호출한 사용자 이벤트를 나타냅니다. 콜백 함수는 설정의 유효성을 검사하고 처리합니다. 설정(또는 설정 조합)이 잘못된 경우 대화 상자를 표시해야 합니다. 함수의 반환 값은 페이지를 다시 표시하거나 다시 초기화해야 하는지 여부를 CPSUI에 나타냅니다.

DLGPAGE 구조체의 DlgProc 멤버가 애플리케이션 제공 대화 상자 프로시저를 지정하는 경우 이 함수 형식으로 지정된 콜백 함수를 사용할 수 없습니다. 이는 애플리케이션이 자체 프로시저를 제공하는 경우 사용되지 않는 CPSUI의 대화 상자 프로시저에서 _CPSUICALLBACK 형식의 콜백이 호출되기 때문입니다.

요구 사항

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