Структура 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

Флаги, указывающие, какие элементы этой структуры являются допустимыми или должны быть заполнены. Это значение может быть сочетанием следующих значений:

Значение Значение
RBBIM_BACKGROUND
Элемент hbmBack является допустимым или должен быть задан.
RBBIM_CHILD
Элемент hwndChild является допустимым или должен быть задан.
RBBIM_CHILDSIZE
Члены cxMinChild, cyMinChild, cyChild, cyMaxChild и cyIntegral являются допустимыми или должны быть заданы.
RBBIM_COLORS
Члены clrFore и clrBack являются допустимыми или должны быть заданы.
RBBIM_HEADERSIZE

Версия 4.71. Элемент cxHeader является допустимым или должен быть задан.

RBBIM_IDEALSIZE

Версия 4.71. Элемент cxIdeal является допустимым или должен быть задан.

RBBIM_ID
Элемент wID является допустимым или должен быть задан.
RBBIM_IMAGE
Элемент iImage является допустимым или должен быть задан.
RBBIM_LPARAM

Версия 4.71. Элемент lParam является допустимым или должен быть задан.

RBBIM_SIZE
Элемент cx является допустимым или должен быть задан.
RBBIM_STYLE
Элемент fStyle является допустимым или должен быть задан.
RBBIM_TEXT
Элемент lpText является допустимым или должен быть задан.
RBBIM_CHEVRONLOCATION
Член rcChevronLocation является допустимым или должен быть задан.
RBBIM_CHEVRONSTATE
Элемент uChevronState является допустимым или должен быть задан.

fStyle

Тип: UINT

Флаги, указывающие стиль полосы. Это значение может быть сочетанием следующих значений:

Значение Значение
RBBS_BREAK
Группа находится на новой линии.
RBBS_CHILDEDGE
Полоса имеет край в верхней и нижней части дочернего окна.
RBBS_FIXEDBMP
Фоновое растровое изображение не перемещается при изменении размера полосы.
RBBS_FIXEDSIZE
Группа не может быть размера. При использовании этого стиля захват размера не отображается на полосе.
RBBS_GRIPPERALWAYS

Версия 4.71. Группа всегда будет иметь размер захвата, даже если это единственная полоса в панели.

RBBS_HIDDEN
Полоса не будет видна.
RBBS_NOGRIPPER

Версия 4.71. Группа никогда не будет иметь размер захвата, даже если есть более одной полосы в ребаре.

RBBS_USECHEVRON

Версия 5.80. Показывать шевронную кнопку, если диапазон меньше cxIdeal.

RBBS_VARIABLEHEIGHT

Версия 4.71. Размер полосы можно изменить с помощью элемента управления "Панель". cyIntegral и cyMaxChild влияют на изменение размера полосы на панели.

RBBS_NOVERT
Не показывать по вертикали.
RBBS_HIDETITLE
Держите название группы скрытым.
RBBS_TOPALIGN
Держите полосу в верхнем ряду.

clrFore

Тип: COLORREF

Цвета переднего плана полосы.

clrBack

Тип: COLORREF

Цвета фона полосы. Если hbmBack указывает фоновое растровое изображение, эти члены игнорируются. По умолчанию в полосе используется цвет фона элемента управления ,заданного с сообщением RB_SETBKCOLOR . Если здесь указан цвет фона, вместо него будет использоваться этот цвет фона.

lpText

Тип: LPTSTR

Указатель на буфер, содержащий отображаемый текст для полосы. Если сведения о полосе запрашиваются из элемента управления и RBBIM_TEXT указана в fMask, этот элемент должен быть инициализирован с адресом буфера, который будет получать текст.

cch

Тип: UINT

Размер буфера в lpText, в байтах. Если сведения не запрашиваются из элемента управления, этот элемент игнорируется.

iImage

Тип: int

Отсчитываемый от нуля индекс любого изображения, которое должно отображаться в диапазоне. Список изображений задается с помощью сообщения 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), элемент управления "Панель" попытается сделать полосу такой ширины.

lParam

Тип: LPARAM

Версия 4.71. Определяемое приложением значение.

cxHeader

Тип: UINT

Версия 4.71. Размер заголовка полосы в пикселях. Верхний колонтитул — это область между краем полосы и краем дочернего окна. Это область, в которой отображается текст полосы и изображения, если они указаны. Если это значение указано, оно переопределяет обычные измерения заголовков, вычисляемые элементом управления для диапазона.

rcChevronLocation

Тип: RECT

Версия 6. Расположение шеврона.

uChevronState

Тип: UINT

Версия 6. Сочетание констант состояния объекта.

Комментарии

Члены cxMinChild, cyMinChild и cx предоставляют сведения об измерениях относительно ориентации элемента управления. То есть для элемента управления горизонтальной панели cxMinChild и cx являются горизонтальными измерениями, а cyMinChild — вертикальным измерением. Однако если элемент управления использует стиль CCS_VERT , cxMinChild и cx являются вертикальными измерениями, а cyMinChild — горизонтальным измерением.

Примечание

Заголовок commctrl.h определяет REBARBANDINFO в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть commctrl.h