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 알림을 통해 값에 대해 애플리케이션을 다시 호출해야 합니다. HDM_GETITEM 메시지에 HDI_DI_SETITEM 전달된 경우 컨트롤은 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(왼쪽에서 오른쪽) 텍스트가 표시됩니다. Windows는 미러된 히브리어 또는 RTL(오른쪽에서 왼쪽)으로 읽는 아랍어와 같은 언어를 표시할 수 있습니다. 일반적으로 머리글 텍스트는 부모 창의 텍스트와 동일한 방향으로 읽습니다. HDF_RTLREADING 설정되면 머리글 텍스트는 부모 창의 텍스트와 반대 방향으로 읽습니다. |
|
버전 6.00 이상 |
|
버전 6.00 이상 |
|
버전 6.00 이상 |
|
버전 6.00 이상 |
|
버전 6.00 이상 |
|
버전 6.00 이상 |
lParam
형식: LPARAM
애플리케이션 정의 항목 데이터입니다.
iImage
형식: int
이미지 목록 내 이미지의 인덱스(0부터 시작하는 인덱스)입니다. 지정된 이미지는 hbm 필드에 지정된 이미지 외에 헤더 항목에 표시됩니다. iImage I_IMAGECALLBACK 설정되면 컨트롤은 HDN_GETDISPINFO 알림 코드를 사용하여 이 항목에 대한 텍스트 정보를 요청합니다. 이미지를 지우려면 이 값을 I_IMAGENONE 설정합니다.
iOrder
형식: int
항목이 헤더 컨트롤 내에서 왼쪽에서 오른쪽으로 나타나는 순서입니다. 즉, 맨 왼쪽 항목의 값은 0입니다. 오른쪽에 있는 다음 항목의 값은 1 등입니다.
type
형식: UINT
pvFilter지정한 필터 형식입니다. 가능한 형식은 다음과 같습니다.
| 값 | 의미 |
|---|---|
|
문자열 데이터입니다. |
|
숫자 데이터입니다. |
|
pvFilter무시합니다. |
|
버전 6.00 이상 |
pvFilter
형식: void*
애플리케이션 정의 데이터 항목의 주소입니다. 데이터 필터 형식은 멤버의 플래그 값을 설정하여 결정됩니다. HDFT_ISSTRING 플래그를 사용하여 문자열을 나타내고 HDFT_ISNUMBER 정수로 나타냅니다. pvFilter
state
형식: UINT
상태입니다. 이 멤버에 대해 유일하게 유효한 지원되는 값은 다음과 같습니다.
| 값 | 의미 |
|---|---|
|
항목에 키보드 포커스가 있습니다. |
발언
메모
commctrl.h 헤더는 HDITEM을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 헤더 | commctrl.h |