Share via

COMBOBOXEXITEMA 구조체(commctrl.h)

  • 아티클

ComboBoxEx 컨트롤의 항목에 대한 정보를 포함합니다.

구문

typedef struct tagCOMBOBOXEXITEMA {
  UINT    mask;
  INT_PTR iItem;
  LPSTR   pszText;
  int     cchTextMax;
  int     iImage;
  int     iSelectedImage;
  int     iOverlay;
  int     iIndent;
  LPARAM  lParam;
} COMBOBOXEXITEMA, *PCOMBOBOXEXITEMA;

멤버

mask

형식: UINT

이 구조체의 특성 또는 이 구조를 사용하는 작업의 특성을 지정하는 비트 플래그 집합입니다. 플래그는 유효하거나 채워야 하는 멤버를 지정합니다. 이 멤버는 다음 값의 조합일 수 있습니다.

값 의미
CBEIF_DI_SETITEM
 CBEN_GETDISPINFO 처리할 때 이 플래그를 설정합니다. ComboBoxEx 컨트롤은 제공된 정보를 유지하고 다시 요청하지 않습니다.
CBEIF_IMAGE
 iImage 멤버가 유효하거나 채워야 합니다.
CBEIF_INDENT
 iIndent 멤버가 유효하거나 채워야 합니다.
CBEIF_LPARAM
 lParam 멤버가 유효하거나 채워야 합니다.
CBEIF_OVERLAY
 iOverlay 멤버가 유효하거나 채워야 합니다.
CBEIF_SELECTEDIMAGE
 iSelectedImage 멤버가 유효하거나 채워야 합니다.
CBEIF_TEXT
 pszText 멤버가 유효하거나 채워야 합니다.

iItem

형식: INT_PTR

항목의 인덱스(0부터 시작)입니다.

pszText

형식: LPTSTR

항목의 텍스트를 포함하거나 받는 문자 버퍼에 대한 포인터입니다. 텍스트 정보를 검색하는 경우 이 멤버는 텍스트를 받을 문자 버퍼의 주소로 설정해야 합니다. 이 버퍼의 크기도 cchTextMax에 표시되어야 합니다. 이 멤버가 LPSTR_TEXTCALLBACK 설정되면 컨트롤은 CBEN_GETDISPINFO 알림 코드를 사용하여 정보를 요청합니다.

cchTextMax

형식: int

TCHAR의 pszText 길이입니다. 텍스트 정보가 설정되면 이 멤버는 무시됩니다.

iImage

형식: int

이미지 목록 내 이미지의 인덱스(0부터 시작)입니다. 지정한 이미지가 선택되지 않으면 항목에 대해 표시됩니다. 이 멤버가 I_IMAGECALLBACK 설정되면 컨트롤은 CBEN_GETDISPINFO 알림 코드를 사용하여 정보를 요청합니다.

iSelectedImage

형식: int

이미지 목록 내 이미지의 인덱스(0부터 시작)입니다. 선택한 항목에 대해 지정된 이미지가 표시됩니다. 이 멤버가 I_IMAGECALLBACK 설정되면 컨트롤은 CBEN_GETDISPINFO 알림 코드를 사용하여 정보를 요청합니다.

iOverlay

형식: int

이미지 목록 내 오버레이 이미지의 1 기반 인덱스입니다. 이 멤버가 I_IMAGECALLBACK 설정되면 컨트롤은 CBEN_GETDISPINFO 알림 코드를 사용하여 정보를 요청합니다.

iIndent

형식: int

항목에 대해 표시할 들여쓰기 공백의 수입니다. 각 들여쓰기 는 10픽셀과 같습니다. 이 멤버가 I_INDENTCALLBACK 설정되면 컨트롤은 CBEN_GETDISPINFO 알림 코드를 사용하여 정보를 요청합니다.

lParam

형식: LPARAM

항목과 관련된 값입니다.

설명

참고

commctrl.h 헤더는 COMBOBOXEXITEM을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
머리글 commctrl.h