REBARBANDINFOA 구조체(commctrl.h)
rebar 컨트롤에서 밴드를 정의하는 정보를 포함합니다.
구문
typedef struct tagREBARBANDINFOA {
UINT cbSize;
UINT fMask;
UINT fStyle;
COLORREF clrFore;
COLORREF clrBack;
LPSTR lpText;
UINT cch;
int iImage;
HWND hwndChild;
UINT cxMinChild;
UINT cyMinChild;
UINT cx;
HBITMAP hbmBack;
UINT wID;
UINT cyChild;
UINT cyMaxChild;
UINT cyIntegral;
UINT cxIdeal;
LPARAM lParam;
UINT cxHeader;
RECT rcChevronLocation;
UINT uChevronState;
} REBARBANDINFOA, *LPREBARBANDINFOA;
멤버
cbSize
형식: UINT
이 구조체의 크기(바이트)입니다. 이 구조체의 주소를 매개 변수로 사용하는 메시지를 보내기 전에 애플리케이션이 이 멤버를 채워야 합니다.
fMask
형식: UINT
이 구조체의 멤버가 유효하거나 채워야 함을 나타내는 플래그입니다. 이 값은 다음의 조합일 수 있습니다.
| 값 | 의미 |
|---|---|
|
hbmBack 멤버가 유효하거나 설정해야 합니다. |
|
hwndChild 멤버가 유효하거나 설정해야 합니다. |
|
cxMinChild, cyMinChild, cyChild, cyMaxChild 및 cyIntegral 멤버는 유효하거나 설정해야 합니다. |
|
clrFore 및 clrBack 멤버는 유효하거나 설정해야 합니다. |
|
버전 4.71. cxHeader 멤버가 유효하거나 설정해야 합니다. |
|
버전 4.71. cxIdeal 멤버가 유효하거나 설정해야 합니다. |
|
wID 멤버가 유효하거나 설정해야 합니다. |
|
iImage 멤버가 유효하거나 설정해야 합니다. |
|
버전 4.71. lParam 멤버가 유효하거나 설정해야 합니다. |
|
cx 멤버가 유효하거나 설정해야 합니다. |
|
fStyle 멤버가 유효하거나 설정해야 합니다. |
|
lpText 멤버가 유효하거나 설정해야 합니다. |
|
rcChevronLocation 멤버가 유효하거나 설정해야 합니다. |
|
uChevronState 멤버가 유효하거나 설정해야 합니다. |
fStyle
형식: UINT
밴드 스타일을 지정하는 플래그입니다. 이 값은 다음의 조합일 수 있습니다.
| 값 | 의미 |
|---|---|
|
밴드는 새로운 라인에있다. |
|
밴드는 자식 창의 위쪽과 아래쪽에 가장자리가 있습니다. |
|
대역 크기를 조정할 때 배경 비트맵이 이동하지 않습니다. |
|
밴드 크기를 지정할 수 없습니다. 이 스타일을 사용하면 크기 조정 그립이 밴드에 표시되지 않습니다. |
|
버전 4.71. 밴드는 리바에서 유일한 밴드인 경우에도 항상 크기 조정 그립을 갖습니다. |
|
밴드는 표시되지 않습니다. |
|
버전 4.71. 레바에 밴드가 두 개 이상 있더라도 밴드는 크기 조정 그립을 갖지 않습니다. |
|
버전 5.80. 밴드가 cxIdeal보다 작은 경우 펼침 단추 표시 |
|
버전 4.71. 밴드는 rebar 컨트롤에 의해 크기를 조정할 수 있습니다. cyIntegral 및 cyMaxChild 는 리바가 대역 크기를 조정하는 방법에 영향을 줍니다. |
|
세로로 표시하지 마세요. |
|
밴드 제목을 숨깁니다. |
|
맨 위 행에 밴드를 유지합니다. |
clrFore
형식: COLORREF
대역 전경색.
clrBack
형식: COLORREF
대역 배경색. hbmBack이 백그라운드 비트맵을 지정하는 경우 이러한 멤버는 무시됩니다. 기본적으로 밴드는 RB_SETBKCOLOR 메시지와 함께 rebar 컨트롤 집합의 배경색을 사용합니다. 여기서 배경색을 지정하면 이 배경색이 대신 사용됩니다.
lpText
형식: LPTSTR
밴드에 대한 표시 텍스트가 포함된 버퍼에 대한 포인터입니다. 컨트롤에서 대역 정보가 요청되고 RBBIM_TEXT fMask에 지정된 경우 이 멤버는 텍스트를 받을 버퍼의 주소로 초기화되어야 합니다.
cch
형식: UINT
lpText의 버퍼 크기(바이트)입니다. 컨트롤에서 정보를 요청하지 않으면 이 멤버는 무시됩니다.
iImage
형식: int
밴드에 표시해야 하는 이미지의 인덱스(0부터 시작)입니다. 이미지 목록은 RB_SETBARINFO 메시지를 사용하여 설정됩니다.
hwndChild
형식: HWND
밴드에 포함된 자식 창(있는 경우)에 대한 핸들입니다.
cxMinChild
형식: UINT
자식 창의 최소 너비(픽셀)입니다. 밴드 크기는 이 값보다 작을 수 없습니다.
cyMinChild
형식: UINT
자식 창의 최소 높이(픽셀)입니다. 밴드 크기는 이 값보다 작을 수 없습니다.
cx
형식: UINT
대역의 길이(픽셀)입니다.
hbmBack
형식: HBITMAP
이 밴드의 배경으로 사용되는 비트맵에 대한 핸들입니다.
wID
형식: UINT
컨트롤이 사용자 지정 그리기 알림 메시지에 대해 이 밴드를 식별하는 데 사용하는 UINT 값입니다.
cyChild
형식: UINT
버전 4.71. 대역의 초기 높이(픽셀)입니다. RBBS_VARIABLEHEIGHT 스타일을 지정하지 않으면 이 멤버는 무시됩니다.
cyMaxChild
형식: UINT
버전 4.71. 대역의 최대 높이(픽셀)입니다. RBBS_VARIABLEHEIGHT 스타일을 지정하지 않으면 이 멤버는 무시됩니다.
cyIntegral
형식: UINT
버전 4.71. 밴드가 증가하거나 축소할 수 있는 단계 값(픽셀)입니다. 대역의 크기가 조정되면 이 값으로 지정된 단계에서 크기가 조정됩니다. RBBS_VARIABLEHEIGHT 스타일을 지정하지 않으면 이 멤버는 무시됩니다.
cxIdeal
형식: UINT
버전 4.71. 대역의 이상적인 너비(픽셀)입니다. 밴드가 이상적인 너비로 최대화되면( RB_MAXIMIZEBAND 참조) rebar 컨트롤은 밴드를 이 너비로 만들려고 시도합니다.
lParam
형식: LPARAM
버전 4.71. 애플리케이션 정의 값입니다.
cxHeader
형식: UINT
버전 4.71. 대역 헤더의 크기(픽셀)입니다. 밴드 헤더는 밴드 가장자리와 자식 창 가장자리 사이의 영역입니다. 지정된 경우 대역 텍스트 및 이미지가 표시되는 영역입니다. 이 값을 지정하면 컨트롤이 대역에 대해 계산하는 일반 헤더 차원을 재정의합니다.
rcChevronLocation
형식: RECT
버전 6. 펼침 단추의 위치입니다.
uChevronState
형식: UINT
설명
cxMinChild, cyMinChild 및 cx 멤버는 컨트롤의 방향을 기준으로 차원에 대한 정보를 제공합니다. 즉, 가로 철근 컨트롤의 경우 cxMinChild 및 cx 는 수평 측정이고 cyMinChild 는 세로 측정입니다. 그러나 컨트롤이 CCS_VERT 스타일을 사용하는 경우 cxMinChild 및 cx 는 세로 측정이고 cyMinChild 는 가로 측정값입니다.
참고
commctrl.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 REBARBANDINFO를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 머리글 | commctrl.h |
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기