EXTCHKBOX 구조체(compstui.h)

아티클
02/22/2024

EXTCHKBOX 구조는 속성 시트 페이지 옵션에 추가할 수 있는 확장된 검사 상자를 지정하기 위해 CPSUI 애플리케이션(프린터 인터페이스 DLL 포함)에서 사용됩니다.

구문

typedef struct _EXTCHKBOX {
  WORD      cbSize;
  WORD      Flags;
  LPTSTR    pTitle;
  LPTSTR    pSeparator;
  LPTSTR    pCheckedName;
  ULONG_PTR IconID;
  WORD      wReserved[4];
  ULONG_PTR dwReserved[2];
} EXTCHKBOX, *PEXTCHKBOX;

멤버

cbSize

EXTCHKBOX 구조체의 크기(바이트)입니다.

Flags

비트 플래그는 다음 중 하나일 수 있습니다.

ECBF_CHECKNAME_AT_FRONT

설정된 경우 CPSUI는 "pCheckedName pSeparator SelectName" 순서로 문자열을 표시합니다. 여기서 SelectName 은 옵션의 선택한 값과 연결된 문자열입니다.

설정하지 않으면 CPSUI는 문자열을 "SelectName pSeparator pCheckedName" 순서로 표시합니다.

ECBF_CHECKNAME_ONLY_ENABLED

설정된 경우 CPSUI는 옵션을 선택하고 사용하도록 설정한 경우에만 pCheckedName 문자열을 표시합니다(즉, OPTIF_ECB_CHECKED 설정되고 OPTITEM 구조에서 OPTIF_DISABLED 명확함).

설정되지 않은 경우 옵션이 선택되어 있는 경우(즉, 옵션을 사용하지 않도록 설정된 경우에도 OPTITEM 구조에서 OPTIF_ECB_CHECKED 설정된 경우) CPSUI는 항상 pCheckedName 문자열을 표시합니다.

ECBF_ICONID_AS_HICON

설정하면 IconID 멤버에 아이콘 핸들이 포함됩니다.

설정하지 않으면 IconID 멤버에 아이콘 리소스 식별자가 포함됩니다.

ECBF_OVERLAY_ECBICON_IF_CHECKED

설정되고 검사 확인란이 선택되어 있으면(즉, OPTITEM 구조에서 OPTIF_ECB_CHECKED 설정됨) CPSUI는 IconID 멤버로 식별된 아이콘을 옵션 항목과 연결된 아이콘에 오버레이합니다.

ECBF_OVERLAY_NO_ICON

설정된 경우 CPSUI는 IDI_CPSUI_NO 아이콘을 IconID 멤버로 식별된 아이콘에 오버레이합니다.

ECBF_OVERLAY_STOP_ICON

설정된 경우 CPSUI는 IDI_CPSUI_STOP 아이콘을 IconID 멤버로 식별된 아이콘에 오버레이합니다.

ECBF_OVERLAY_WARNING_ICON

설정된 경우 CPSUI는 IDI_CPSUI_WARNING 아이콘을 IconID 멤버로 식별된 아이콘에 오버레이합니다.

pTitle

검사 상자 제목을 나타내는 문자열 식별자입니다. NULL로 끝나는 문자열에 대한 32비트 포인터이거나 HIWORD가 0으로 설정된 16비트 문자열 리소스 식별자일 수 있습니다.

pSeparator

선택한 이름 문자열과 선택한 옵션 문자열 사이에 표시할 구분 기호 문자를 나타내는 문자열 식별자 NULL로 끝나는 문자열에 대한 32비트 포인터이거나 HIWORD가 0으로 설정된 16비트 문자열 리소스 식별자일 수 있습니다.

pCheckedName

검사 확인란이 선택되어 있을 때 표시할 텍스트를 나타내는 문자열 식별자입니다. NULL로 끝나는 문자열에 대한 32비트 포인터이거나 HIWORD가 0으로 설정된 16비트 문자열 리소스 식별자일 수 있습니다.

IconID

다음 아이콘 식별자 중 하나입니다.

아이콘 리소스 식별자입니다. 애플리케이션에서 정의하거나 CPSUI에서 제공하는 IDI_CPSUI 접두사 아이콘 리소스 식별자 중 하나일 수 있습니다.
아이콘 핸들입니다. 핸들이 지정된 경우 flags 멤버에서 ECBF_ICONID_AS_HICON 설정해야 합니다.

이 값이 0이면 아이콘이 표시되지 않습니다.

wReserved[4]

예약된 는 0으로 초기화되어야 합니다.

dwReserved[2]

예약된 는 0으로 초기화되어야 합니다.

설명

확장된 검사 상자는 OPTITEM 구조와 연결할 수 있는 CPSUI 정의 형식의 검사 상자입니다. OPTITEM 구조체에는 하나의 확장된 검사 상자 또는 하나의 확장된 누름 단추가 연결되어 있을 수 있습니다.

요구 사항

요구 사항	값
헤더	compstui.h(Compstui.h 포함)

추가 정보

EXTPUSH

다음을 통해 공유