TVOT_PUSHBUTTON

Important

최신 인쇄 플랫폼은 Windows에서 프린터와 통신하는 데 선호되는 수단입니다. 프린터 장치 개발을 위해 Windows 10 및 11의 인쇄 환경을 사용자 지정하려면 MICROSOFT의 IPP 받은 편지함 클래스 드라이버와 PSA(인쇄 지원 앱)를 사용하는 것이 좋습니다.

자세한 내용은 최신 인쇄 플랫폼 및 인쇄 지원 앱 디자인 가이드를 참조하세요.

TVOT_PUSHBUTTON 옵션 유형은 그룹 상자 내의 누름 단추로 구성됩니다.

OPTITEM 구조체

Sel/pSel
다음과 같이 OPTPARAM 구조체의 Style 멤버에 따라 달라집니다.

누름 단추 스타일 Sel/pSel 사용량
PUSHBUTTON_TYPE_CALLBACK 사용되지 않습니다.
PUSHBUTTON_TYPE_DLGPROC CPSUI는 대화 상자 프로시저의 반환 값을 저장합니다.
PUSHBUTTON_TYPE_HTCLRADJ CPSUI는 하프톤 작업의 반환 값을 저장합니다.
PUSHBUTTON_TYPE_HTSETUP CPSUI는 하프톤 작업의 반환 값을 저장합니다.

OPTPARAM 구조 배열(OPTTYPE의 pOptParam 멤버)

pData
다음과 같이 Style 멤버에 따라 달라집니다.

누름 단추 스타일 pData 사용량
PUSHBUTTON_TYPE_CALLBACK _CPSUICALLBACK 형식 함수에 대한 포인터입니다.
PUSHBUTTON_TYPE_DLGPROC 대화 상자 프로시저에 대한 DLGPROC 형식 포인터입니다(Microsoft Windows SDK 설명서 참조).
PUSHBUTTON_TYPE_HTCLRADJ COLORADJUSTMENT 구조체에 대한 포인터입니다(Windows SDK 설명서에 설명됨).
PUSHBUTTON_TYPE_HTSETUP DEVHTADJDATA 구조체에 대한 포인터입니다.

IconID
누름 단추와 연결할 아이콘을 식별합니다.

lParam은 다음과 같이 스타일 멤버에 따라 달라집니다.

누름 단추 스타일 lParam 사용량
PUSHBUTTON_TYPE_CALLBACK 사용되지 않습니다.
PUSHBUTTON_TYPE_DLGPROC DIALOG 리소스에 대한 리소스 식별자 또는 DLGTEMPLATE 구조에 대한 핸들(Windows SDK 설명서 참조). OPTPARAM 구조체의 Flags 멤버에서 DPF_USE_HDLGTEMPLATE 플래그 에 따라 달라집니다.
PUSHBUTTON_TYPE_HTCLRADJ 사용되지 않습니다.
PUSHBUTTON_TYPE_HTSETUP 사용되지 않습니다.
용어 설명
스타일 사용자가 누름 단추를 클릭할 때 CPSUI에서 수행할 작업을 지정합니다. 다음 값 중 하나일 수 있습니다.
PUSHBUTTON_TYPE_CALLBACK CPSUI는 애플리케이션의 _CPSUICALLBACK 형식 콜백 함수를 호출하여 단추 이벤트를 처리하고 CPSUICBPARAM 구조체의 Reason 멤버는 CPSUICB_REASON_PUSHBUTTON. (CPSUI는 콜백 함수의 반환 값을 무시합니다.)
PUSHBUTTON_TYPE_DLGPROC 애플리케이션의 대화 상자 프로시저는 단추 이벤트를 처리합니다. (자세한 내용은 다음을 참조하세요.DLGPAGE 대한 설명 섹션입니다.) 함수가 WM_INITDIALOG 메시지를 받으면 해당 lParam 인수는 Reason 멤버가 CPSUICB_REASON_DLGPROC 설정된 CPSUICBPARAM 구조를 가리킵니다.
PUSHBUTTON_TYPE_HTCLRADJ CPSUI는 하프톤 색 조정 대화 상자를 표시합니다.
PUSHBUTTON_TYPE_HTSETUP CPSUI는 디바이스 하프톤 설정 대화 상자를 표시합니다.

OPTTYPE 구조체

형식 TVOT_PUSHBUTTON

개수 1

스타일 다음 선택적 비트 플래그를 지정할 수 있습니다.

Flag 설명
OTS_PUSH_ENABLE_ALWAYS 설정하면 사용자가 속성 시트 페이지를 수정할 수 없는 경우에도(즉, CPSUIF_UPDATE_PERMISSION COMPROPSHEETUI 구조에서 설정되지 않은 경우에도) 항상 누름 단추가 활성화됩니다.

푸시 단추의 콜백 함수는 대화 상자를 표시해야 하지만 사용자 수정을 허용해서는 안 됩니다.

OPTTYPE 구조의 Flags 멤버에서도 이 플래그를 설정해야 합니다.
OTS_PUSH_INCL_SETUP_TITLE 설정된 경우 CPSUI는 단추의 이름 문자열(OPTITEM의 pName) 다음에 "Setup"이라는 단어를 포함합니다.
OTS_PUSH_NO_DOT_DOT_DOT 설정된 경우 CPSUI는 단추의 이름 문자열(OPTITEM의 pName) 다음에 세 개의 점(...)을 포함합니다.

BegCtrlID
COMPROPSHEETUIpDlgPage가 CPSUI 제공 페이지를 식별하거나 DLGPAGE의 DlgTemplateID가 CPSUI 제공 템플릿을 식별하는 경우 BegCtrlID는 사용되지 않습니다. 그렇지 않으면 BegCtrlID 는 순차적으로 번호가 매겨진 컨트롤 식별자 집합의 첫 번째 컨트롤 식별자를 포함해야 합니다. 컨트롤 식별자는 다음 Windows 컨트롤을 식별해야 합니다.

컨트롤 식별자 Windows 컨트롤
BegCtrlID 콘텐츠 그룹 상자
BegCtrlID 콘텐츠+1 제목 텍스트
BegCtrlID 콘텐츠+2 누름 단추 상자
BegCtrlID 콘텐츠+3 누름 단추 아이콘
BegCtrlID 콘텐츠+4 확장 확인란 또는 확장된 누름 단추(선택 사항)
BegCtrlID 콘텐츠+5 확장 확인란 또는 확장된 누름 단추 아이콘(선택 사항)

자세한 내용은 CPSUI 지원 창 컨트롤 사용자 지정을 참조 하세요.

요구 사항

헤더: compstui.h(Compstui.h 포함)

참고 항목

OPTITEM

OPTPARAM

OPTTYPE