HDITEMA 구조체(commctrl.h)
헤더 컨트롤의 항목에 대한 정보를 포함합니다. 이 구조체는 HD_ITEM 구조를 대체합니다.
구문
typedef struct _HD_ITEMA {
UINT mask;
int cxy;
LPSTR pszText;
HBITMAP hbm;
int cchTextMax;
int fmt;
LPARAM lParam;
int iImage;
int iOrder;
UINT type;
void *pvFilter;
UINT state;
} HDITEMA, *LPHDITEMA;
멤버
mask
형식: UINT
유효한 데이터를 포함하거나 채워야 하는 다른 구조체 멤버를 나타내는 플래그입니다. 이 멤버는 다음 값의 조합일 수 있습니다.
| 값 | 의미 |
|---|---|
|
hbm 멤버가 유효합니다. |
|
메시지 HDM_GETITEM 처리하는 동안 헤더 컨트롤에 요청을 완료하는 데 필요한 모든 값이 없을 수 있습니다. 이 경우 컨트롤은 HDN_GETDISPINFO 알림을 통해 값에 대해 애플리케이션을 다시 호출해야 합니다. HDI_DI_SETITEM HDM_GETITEM 메시지에 전달된 경우 컨트롤은 HDN_GETDISPINFO 반환된 모든 값을 캐시합니다(그렇지 않으면 값이 설정되지 않은 상태로 유지됨). |
|
fmt 멤버가 유효합니다. |
|
형식 및 pvFilter 멤버는 유효합니다. 형식 멤버에 지정된 값을 필터링하는 데 사용됩니다. |
|
HDI_WIDTH 동일합니다. |
|
iImage 멤버가 유효하고 항목과 함께 표시할 이미지를 지정합니다. |
|
lParam 멤버가 유효합니다. |
|
iOrder 멤버가 유효하고 항목의 주문 값을 지정합니다. |
|
버전 6.00 이상. 상태 멤버가 유효합니다. |
|
pszText 및 cchTextMax 멤버는 유효합니다. |
|
cxy 멤버가 유효하고 항목의 너비를 지정합니다. |
cxy
형식: int
항목의 너비 또는 높이입니다.
pszText
형식: LPTSTR
항목 문자열에 대한 포인터입니다. 텍스트가 컨트롤에서 검색되는 경우 문자 버퍼를 가리키도록 이 멤버를 초기화해야 합니다. 이 멤버가 LPSTR_TEXTCALLBACK 설정되면 컨트롤은 HDN_GETDISPINFO 알림 코드를 전송하여 이 항목에 대한 텍스트 정보를 요청합니다. 헤더 컨트롤을 사용하면 모든 길이의 문자열을 항목 텍스트로 저장할 수 있지만 처음 260 TCHAR만 표시됩니다.
hbm
형식: HBITMAP
항목 비트맵에 대한 핸들입니다.
cchTextMax
형식: int
TCHAR의 항목 문자열 길이입니다. 컨트롤에서 텍스트를 검색하는 경우 이 멤버는 pszText로 지정된 주소의 TCHAR 수를 포함해야 합니다.
fmt
형식: int
항목의 형식을 지정하는 플래그입니다.
| 값 | 의미 |
|---|---|
|
다음 플래그 중 하나를 설정하여 텍스트 근거를 지정합니다. |
|
항목의 내용이 가운데에 배치됩니다. |
|
항목의 내용이 왼쪽에 맞춰집니다. |
|
항목의 내용이 오른쪽에 맞춰집니다. |
|
다음 플래그 중 하나를 설정하여 디스플레이를 제어합니다. |
|
항목에 비트맵이 표시됩니다. |
|
비트맵이 텍스트 오른쪽에 나타납니다. |
|
헤더 컨트롤의 소유자가 항목을 그립니다. |
|
항목에 문자열이 표시됩니다. |
|
위의 값은 다음과 함께 사용할 수 있습니다. |
|
이미지 목록에서 이미지를 표시합니다. HDM_SETIMAGELIST 메시지를 보내 이미지 목록을 지정합니다. 이 구조체의 iImage 멤버에서 이미지의 인덱스 를 지정합니다. |
|
앞의 표에 나열된 세 가지 근거 플래그에 해당하는 비트를 격리합니다. |
|
일반적으로 창에는 LTR(왼쪽에서 오른쪽) 텍스트가 표시됩니다. 오른쪽에서 왼쪽으로 읽는(RTL) 히브리어 또는 아랍어와 같은 언어를 표시하도록 Windows를 미러링할 수 있습니다. 일반적으로 머리글 텍스트는 부모 창의 텍스트와 동일한 방향으로 읽습니다. HDF_RTLREADING 설정된 경우 머리글 텍스트는 부모 창의 텍스트와 반대 방향으로 읽습니다. |
|
버전 6.00 이상. 이 항목에 아래쪽 화살표를 그립니다. 일반적으로 현재 창의 정보가 이 열에서 내림차순으로 정렬됨을 나타내는 데 사용됩니다. 이 플래그는 HDF_IMAGE 또는 HDF_BITMAP 결합할 수 없습니다. |
|
버전 6.00 이상. 이 항목에 위쪽 화살표를 그립니다. 일반적으로 현재 창의 정보가 이 열에 오름차순으로 정렬되었음을 나타내는 데 사용됩니다. 이 플래그는 HDF_IMAGE 또는 HDF_BITMAP 결합할 수 없습니다. |
|
버전 6.00 이상. 항목에 확인란이 표시됩니다. 플래그는 헤더 컨트롤에서 HDS_CHECKBOXES 스타일이 처음 설정된 경우에만 유효합니다. |
|
버전 6.00 이상. 항목에 확인란이 표시됩니다. 플래그는 HDF_CHECKBOX 설정된 경우에만 유효합니다. |
|
버전 6.00 이상. 항목의 너비는 크기를 조정하기 위한 사용자 작업으로 수정할 수 없습니다. |
|
버전 6.00 이상. 항목에 분할 단추가 표시됩니다. 분할 단추를 클릭하면 HDN_DROPDOWN 알림이 전송됩니다. |
lParam
형식: LPARAM
애플리케이션 정의 항목 데이터입니다.
iImage
형식: int
이미지 목록 내 이미지의 인덱스(0부터 시작)입니다. 지정된 이미지는 hbm 필드에 지정된 이미지 외에도 헤더 항목에 표시됩니다. iImage가 I_IMAGECALLBACK 설정된 경우 컨트롤은 HDN_GETDISPINFO 알림 코드를 사용하여 이 항목에 대한 텍스트 정보를 요청합니다. 이미지를 지우려면 이 값을 I_IMAGENONE 설정합니다.
iOrder
형식: int
헤더 컨트롤 내에서 항목이 나타나는 순서(왼쪽부터 오른쪽)입니다. 즉, 맨 왼쪽 항목의 값은 0입니다. 오른쪽에 있는 다음 항목의 값은 1 등입니다.
type
형식: UINT
pvFilter에서 지정한 필터의 형식입니다. 가능한 형식은 다음과 같습니다.
| 값 | 의미 |
|---|---|
|
문자열 데이터입니다. |
|
숫자 데이터입니다. |
|
pvFilter를 무시합니다. |
|
버전 6.00 이상. 날짜 데이터입니다. pvFilter 멤버는 SYSTEMTIME 구조체에 대한 포인터입니다. |
pvFilter
형식: void*
애플리케이션 정의 데이터 항목의 주소입니다. 데이터 필터 형식은 멤버의 플래그 값을 설정하여 결정됩니다. HDFT_ISSTRING 플래그를 사용하여 문자열을 나타내고 정수 표시를 HDFT_ISNUMBER. HDFT_ISSTRING 플래그를 사용하는 경우 pvFilter 는 HDTEXTFILTER 구조체에 대한 포인터입니다.
state
형식: UINT
상태입니다. 이 멤버에 대해 유일하게 유효한 지원되는 값은 다음과 같습니다.
| 값 | 의미 |
|---|---|
|
항목에 키보드 포커스가 있습니다. |
설명
참고
commctrl.h 헤더는 HDITEM을 별칭으로 정의하여 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 머리글 | commctrl.h |
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기