헤더 컨트롤

이 섹션에는 헤더 컨트롤과 함께 사용되는 프로그래밍 요소에 대한 정보가 포함되어 있습니다.

개요

항목	콘텐츠
헤더 컨트롤 정보	헤더 컨트롤은 일반적으로 텍스트 또는 숫자 열 위에 위치하는 창입니다. 각 열에 대한 제목이 포함되어 있으며 파트로 나눌 수 있습니다.
헤더 컨트롤 사용	이 항목에서는 헤더 컨트롤에 대한 구현 세부 정보 및 코드 예를 제공합니다.

매크로

항목	콘텐츠
Header_ClearAllFilters	지정된 헤더 컨트롤에 대한 모든 필터를 지웁니다. 이 매크로를 사용하거나 HDM_CLEARFILTER 메시지를 명시적으로 보낼 수 있습니다.
Header_ClearFilter	지정된 헤더 컨트롤에 대한 필터를 지웁니다. 이 매크로를 사용하거나 HDM_CLEARFILTER 메시지를 명시적으로 보낼 수 있습니다.
Header_CreateDragImage	기존 헤더 컨트롤 내에서 항목 이미지의 투명 버전을 만듭니다. 이 매크로를 사용하거나 HDM_CREATEDRAGIMAGE 메시지를 명시적으로 보낼 수 있습니다.
Header_DeleteItem	헤더 컨트롤에서 항목을 삭제합니다. 이 매크로를 사용하거나 HDM_DELETEITEM 메시지를 명시적으로 보낼 수 있습니다.
Header_EditFilter	필터 단추에 포커스가 있는 경우 입력 포커스를 편집 상자로 이동합니다.
Header_GetBitmapMargin	기존 헤더 컨트롤에서 비트맵의 여백 너비(픽셀)를 가져옵니다. 이 매크로를 사용하거나 HDM_GETBITMAPMARGIN 메시지를 명시적으로 보낼 수 있습니다.
Header_GetFocusedItem	포커스가 있는 헤더 컨트롤의 항목을 가져옵니다. 이 매크로를 사용하거나 HDM_GETFOCUSEDITEM 메시지를 명시적으로 보냅니다.
Header_GetImageList	기존 헤더 컨트롤에 대해 설정된 이미지 목록에 대한 핸들을 가져옵니다. 이 매크로를 사용하거나 HDM_GETIMAGELIST 메시지를 명시적으로 보낼 수 있습니다.
Header_GetItem	헤더 컨트롤의 항목에 대한 정보를 가져옵니다. 이 매크로를 사용하거나 HDM_GETITEM 메시지를 명시적으로 보낼 수 있습니다.
Header_GetItemCount	헤더 컨트롤의 항목 수를 가져옵니다. 이 매크로를 사용하거나 HDM_GETITEMCOUNT 메시지를 명시적으로 보낼 수 있습니다.
Header_GetItemDropDownRect	헤더 컨트롤의 지정된 항목에 대한 드롭다운 단추의 좌표를 가져옵니다. 헤더 컨트롤은 HDF_SPLITBUTTON 형식이어야 합니다. 이 매크로를 사용하거나 HDM_GETITEMDROPDOWNRECT 메시지를 명시적으로 보냅니다.
Header_GetItemRect	헤더 컨트롤의 지정된 항목에 대한 경계 사각형을 가져옵니다. 이 매크로를 사용하거나 HDM_GETIMRECT 메시지를 명시적으로 보낼 수 있습니다.
Header_GetOrderArray	헤더 컨트롤에 있는 항목의 현재 왼쪽에서 오른쪽 순서를 가져옵니다. 이 매크로를 사용하거나 HDM_GETORDERARRAY 메시지를 명시적으로 보낼 수 있습니다.
Header_GetOverflowRect	지정된 헤더 컨트롤에 대한 드롭다운 오버플로 영역의 좌표를 가져옵니다. 헤더 컨트롤은 HDF_SPLITBUTTON 형식이어야 합니다. 이 매크로를 사용하거나 HDM_GETOVERFLOWRECT 메시지를 명시적으로 보냅니다.
Header_GetStateImageList	기존 헤더 컨트롤 상태에 대해 설정된 이미지 목록에 대한 핸들을 가져옵니다.
Header_GetUnicodeFormat	컨트롤의 유니코드 문자 형식 플래그를 가져옵니다. 이 매크로를 사용하거나 HDM_GETUNICODEFORMAT 메시지를 명시적으로 보낼 수 있습니다.
Header_InsertItem	헤더 컨트롤에 새 항목을 삽입합니다. 이 매크로를 사용하거나 HDM_INSERTITEM 메시지를 명시적으로 보낼 수 있습니다.
Header_Layout	부모 창 내에서 헤더 컨트롤의 올바른 크기와 위치를 검색합니다. 이 매크로를 사용하거나 HDM_LAYOUT 메시지를 명시적으로 보낼 수 있습니다.
Header_OrderToIndex	헤더 컨트롤의 순서에 따라 항목의 인덱스 값을 검색합니다. 이 매크로를 사용하거나 HDM_ORDERTOINDEX 메시지를 명시적으로 보낼 수 있습니다.
Header_SetBitmapMargin	기존 헤더 컨트롤에서 비트맵의 여백 너비를 설정합니다. 이 매크로를 사용하거나 HDM_SETBITMAPMARGIN 메시지를 명시적으로 보낼 수 있습니다.
Header_SetFilterChangeTimeout	필터 특성에서 변경이 발생하는 시간과 HDN_FILTERCHANGE 알림 게시 사이의 시간 제한 간격을 설정합니다. 이 매크로를 사용하거나 HDM_SETFILTERCHANGETIMEOUT 메시지를 명시적으로 보낼 수 있습니다.
Header_SetFocusedItem	헤더 컨트롤의 지정된 항목에 포커스를 설정합니다. 이 매크로를 사용하거나 HDM_SETFOCUSEDITEM 메시지를 명시적으로 보냅니다.
Header_SetHotDivider	외부 끌어서 놓기 작업의 대상을 나타내기 위해 헤더 항목 사이의 구분선 색을 변경합니다. 이 매크로를 사용하거나 HDM_SETHOTDIVIDER 메시지를 명시적으로 보낼 수 있습니다.
Header_SetImageList	기존 헤더 컨트롤에 이미지 목록을 할당합니다. 이 매크로를 사용하거나 HDM_SETIMAGELIST 메시지를 명시적으로 보낼 수 있습니다.
Header_SetItem	헤더 컨트롤에서 지정된 항목의 특성을 설정합니다. 이 매크로를 사용하거나 HDM_SETITEM 메시지를 명시적으로 보낼 수 있습니다.
Header_SetOrderArray	헤더 항목의 왼쪽에서 오른쪽 순서를 설정합니다. 이 매크로를 사용하거나 HDM_SETORDERARRAY 메시지를 명시적으로 보낼 수 있습니다.
Header_SetStateImageList	기존 헤더 컨트롤 상태에 이미지 목록을 할당합니다.
Header_SetUnicodeFormat	컨트롤의 유니코드 문자 형식 플래그를 설정합니다. 이 메시지를 통해 컨트롤을 다시 만들지 않고도 런타임에 컨트롤에서 사용하는 문자 집합을 변경할 수 있습니다. 이 매크로를 사용하거나 HDM_SETUNICODEFORMAT 메시지를 명시적으로 보낼 수 있습니다.

메시지

항목	콘텐츠
HDM_CLEARFILTER	지정된 헤더 컨트롤에 대한 필터를 지웁니다. 이 메시지를 명시적으로 보내거나 Header_ClearFilter 매크로를 사용할 수 있습니다.
HDM_CREATEDRAGIMAGE	끌기 이미지로 사용할 항목 이미지의 반투명 버전을 만듭니다. 이 메시지를 명시적으로 보내거나 Header_CreateDragImage 매크로를 사용할 수 있습니다.
HDM_DELETEITEM	헤더 컨트롤에서 항목을 삭제합니다. 이 메시지를 명시적으로 보내거나 Header_DeleteItem 매크로를 사용할 수 있습니다.
HDM_EDITFILTER	필터 단추에 포커스가 있는 경우 입력 포커스를 편집 상자로 이동합니다.
HDM_GETBITMAPMARGIN	헤더 컨트롤의 비트맵 여백 너비를 가져옵니다. 이 메시지를 명시적으로 보내거나 Header_GetBitmapMargin 매크로를 사용할 수 있습니다.
HDM_GETFOCUSEDITEM	포커스가 있는 헤더 컨트롤의 항목을 가져옵니다. 명시적으로 또는 Header_GetFocusedItem 매크로를 사용하여 이 메시지를 보냅니다. 창은 WindowProc 함수를 통해 이 메시지를 받습니다.
HDM_GETIMAGELIST	기존 헤더 컨트롤에 대해 설정된 이미지 목록에 대한 핸들을 가져옵니다. 이 메시지를 명시적으로 보내거나 Header_GetImageList 또는 Header_GetStateImageList 매크로를 사용할 수 있습니다.
HDM_GETITEM	헤더 컨트롤의 항목에 대한 정보를 가져옵니다. 이 메시지를 명시적으로 보내거나 Header_GetItem 매크로를 사용할 수 있습니다.
HDM_GETITEMCOUNT	헤더 컨트롤의 항목 수를 가져옵니다. 이 메시지를 명시적으로 보내거나 Header_GetItemCount 매크로를 사용할 수 있습니다.
HDM_GETITEMDROPDOWNRECT	HDF_SPLITBUTTON 스타일의 헤더 항목에 대한 분할 단추의 경계 사각형을 가져옵니다. 이 메시지를 명시적으로 보내거나 Header_GetItemDropDownRect매크로를 사용하여 보냅니다.
HDM_GETITEMRECT	헤더 컨트롤의 지정된 항목에 대한 경계 사각형을 가져옵니다. 이 메시지를 명시적으로 보내거나 Header_GetItemRect 매크로를 사용할 수 있습니다.
HDM_GETORDERARRAY	헤더 컨트롤에 있는 항목의 현재 왼쪽에서 오른쪽 순서를 가져옵니다. 이 메시지를 명시적으로 보내거나 Header_GetOrderArray 매크로를 사용할 수 있습니다.
HDM_GETOVERFLOWRECT	HDS_OVERFLOW 스타일이 헤더 컨트롤에 설정되고 오버플로 단추가 표시될 때 오버플로 단추의 경계 사각형을 가져옵니다. 이 메시지를 명시적으로 보내거나 Header_GetOverflowRect매크로를 사용하여 보냅니다.
HDM_GETUNICODEFORMAT	컨트롤의 유니코드 문자 형식 플래그를 가져옵니다. 이 메시지를 명시적으로 보내거나 Header_GetUnicodeFormat 매크로를 사용할 수 있습니다.
HDM_HITTEST	지정된 지점에 있는 헤더 항목(있는 경우)을 확인하기 위해 지점을 테스트합니다.
HDM_INSERTITEM	헤더 컨트롤에 새 항목을 삽입합니다. 이 메시지를 명시적으로 보내거나 Header_InsertItem 매크로를 사용할 수 있습니다.
HDM_LAYOUT	부모 창의 대상 사각형 내에서 헤더 컨트롤의 크기와 위치를 설정하는 데 사용되는 정보를 검색합니다. 이 메시지를 명시적으로 보내거나 Header_Layout 매크로를 사용할 수 있습니다.
HDM_ORDERTOINDEX	헤더 컨트롤의 순서에 따라 항목의 인덱스 값을 검색합니다. 이 메시지를 명시적으로 보내거나 Header_OrderToIndex 매크로를 사용할 수 있습니다.
HDM_SETBITMAPMARGIN	기존 헤더 컨트롤에서 비트맵의 여백 너비(픽셀로 지정)를 설정합니다. 이 메시지를 명시적으로 보내거나 Header_SetBitmapMargin 매크로를 사용할 수 있습니다.
HDM_SETFILTERCHANGETIMEOUT	필터 특성에서 변경이 발생하는 시간과 HDN_FILTERCHANGE 알림 게시 사이의 시간 제한 간격을 설정합니다. 이 메시지를 명시적으로 보내거나 Header_SetFilterChangeTimeout 매크로를 사용할 수 있습니다.
HDM_SETFOCUSEDITEM	헤더 컨트롤의 지정된 항목에 포커스를 설정합니다. 이 메시지를 명시적으로 보내거나 Header_SetFocusedItem 매크로를 사용하여 보냅니다.
HDM_SETHOTDIVIDER	외부 끌어서 놓기 작업의 대상을 나타내기 위해 헤더 항목 사이의 구분선 색을 변경합니다. 이 메시지를 명시적으로 보내거나 Header_SetHotDivider 매크로를 사용할 수 있습니다.
HDM_SETIMAGELIST	기존 헤더 컨트롤에 이미지 목록을 할당합니다. 이 메시지를 명시적으로 보내거나 Header_SetImageList 또는 Header_SetStateImageList 매크로를 사용할 수 있습니다.
HDM_SETITEM	헤더 컨트롤에서 지정된 항목의 특성을 설정합니다. 이 메시지를 명시적으로 보내거나 Header_SetItem 매크로를 사용할 수 있습니다.
HDM_SETORDERARRAY	헤더 항목의 왼쪽에서 오른쪽 순서를 설정합니다. 이 메시지를 명시적으로 보내거나 Header_SetOrderArray 매크로를 사용할 수 있습니다.
HDM_SETUNICODEFORMAT	컨트롤의 유니코드 문자 형식 플래그를 설정합니다. 이 메시지를 통해 컨트롤을 다시 만들지 않고도 런타임에 컨트롤에서 사용하는 문자 집합을 변경할 수 있습니다. 이 메시지를 명시적으로 보내거나 Header_SetUnicodeFormat 매크로를 사용할 수 있습니다.
HDM_TRANSLATEACCELERATOR	구현되지 않았습니다.

알림

항목	콘텐츠
HDN_BEGINDRAG	해당 항목 중 하나에서 끌기 작업이 시작되면 헤더 컨트롤에서 보냅니다. 이 알림 코드는 HDS_DRAGDROP 스타일로 설정된 헤더 컨트롤에서만 전송됩니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
HDN_BEGINFILTEREDIT	필터 편집이 시작되었음을 헤더 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
HDN_BEGINTRACK	헤더 컨트롤의 부모 창에 사용자가 컨트롤의 구분선을 끌기 시작했음을 알립니다(즉, 마우스 커서가 헤더 컨트롤의 구분선에 있는 동안 사용자가 마우스 왼쪽 단추를 누름). 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
HDN_DIVIDERDBLCLICK	사용자가 컨트롤의 구분선 영역을 두 번 클릭했음을 헤더 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
HDN_DROPDOWN	헤더 컨트롤의 드롭다운 화살표를 클릭하면 헤더 컨트롤에서 부모에게 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
HDN_ENDDRAG	해당 항목 중 하나에서 끌기 작업이 종료되면 헤더 컨트롤에서 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지로 전송됩니다. HDS_DRAGDROP 스타일로 설정된 헤더 컨트롤만 이 알림을 보냅니다.
HDN_ENDFILTEREDIT	필터 편집이 종료되었음을 헤더 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
HDN_ENDTRACK	사용자가 구분선 끌기를 완료했음을 헤더 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
HDN_FILTERBTNCLICK	필터 단추를 클릭하거나 HDM_SETITEM 메시지에 대한 응답으로 헤더 컨트롤의 부모 창에 알립니다.
HDN_FILTERCHANGE	헤더 컨트롤 필터의 특성이 변경되거나 편집되고 있음을 헤더 컨트롤의 부모 창에 알립니다.
HDN_GETDISPINFO	컨트롤에 콜백 헤더 항목에 대한 정보가 필요할 때 헤더 컨트롤의 소유자에게 전송됩니다. 이 알림 코드는 WM_NOTIFY 메시지로 전송됩니다.
HDN_ITEMCHANGED	헤더 항목의 특성이 변경되었음을 헤더 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
HDN_ITEMCHANGING	헤더 항목의 특성이 변경되려고 한다는 것을 헤더 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
HDN_ITEMCLICK	사용자가 컨트롤을 클릭했음을 헤더 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
HDN_ITEMDBLCLICK	사용자가 컨트롤을 두 번 클릭했음을 헤더 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다. HDS_BUTTONS 스타일로 설정된 헤더 컨트롤만 이 알림을 보냅니다.
HDN_ITEMKEYDOWN	항목이 선택된 상태에서 키를 눌렀음을 헤더 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
HDN_ITEMSTATEICONCLICK	사용자가 항목의 상태 아이콘을 클릭했음을 헤더 컨트롤의 부모 창에 알립니다.
HDN_OVERFLOWCLICK	헤더의 오버플로 단추를 클릭하면 헤더 컨트롤에서 부모에게 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
HDN_TRACK	사용자가 헤더 컨트롤에서 구분선을 끌고 있음을 헤더 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_CUSTOMDRAW(헤더)	그리기 작업에 대해 부모 창에 알리기 위해 헤더 컨트롤에서 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_RCLICK(헤더)	사용자가 컨트롤 내에서 마우스 오른쪽 단추를 클릭했음을 트리 뷰 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_RELEASEDCAPTURE(헤더)	컨트롤이 마우스 캡처를 해제하고 있음을 헤더 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.

상수

항목	콘텐츠
헤더 컨트롤 스타일	헤더 컨트롤에는 컨트롤의 모양과 동작을 결정하는 이 섹션에 설명된 여러 스타일이 있습니다. 헤더 컨트롤을 만들 때 초기 스타일을 설정합니다.