Структура DESKBANDINFO (shobjidl_core.h)

Получает сведения об объекте полосы. Эта структура используется с устаревшим методом IDeskBand::GetBandInfo .

Синтаксис

typedef struct DESKBANDINFO {
  DWORD    dwMask;
  POINTL   ptMinSize;
  POINTL   ptMaxSize;
  POINTL   ptIntegral;
  POINTL   ptActual;
  WCHAR    wszTitle[256];
  DWORD    dwModeFlags;
  COLORREF crBkgnd;
} DESKBANDINFO;

Члены

dwMask

Тип: DWORD

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

DBIM_MINSIZE

Запрашивается ptMinSize.

DBIM_MAXSIZE

Запрашивается ptMaxSize.

DBIM_INTEGRAL

Запрашивается ptIntegral.

DBIM_ACTUAL

Запрашивается ptActual.

DBIM_TITLE

Запрашивается wszTitle.

DBIM_MODEFLAGS

Запрашивается dwModeFlags.

DBIM_BKCOLOR

Запрос crBkgnd.

ptMinSize

Тип: POINTL

Структура POINTL , которая получает минимальный размер объекта band. Минимальная ширина указана в элементе x структуры POINTL, а минимальная высота — в элементе y.

ptMaxSize

Тип: POINTL

Структура POINTL , которая получает максимальный размер объекта band. Максимальная высота задается в элементе y структуры POINTL, а элемент x игнорируется. Если объект band не имеет ограничений на максимальную высоту, следует использовать значение (LONG)-1.

ptIntegral

Тип: POINTL

Структура POINTL , получающая значение шага изменения размера (приращение), в котором изменяется размер объекта полосы. Значение вертикального шага задается в элементе y структуры POINTL, а элемент x игнорируется.

Член dwModeFlags должен содержать флаг DBIMF_VARIABLEHEIGHT; в противном случае ptIntegral игнорируется.

ptActual

Тип: POINTL

Структура POINTL , которая получает идеальный размер объекта band. Идеальная ширина задается в элементе x структуры POINTL, а идеальная высота — в элементе y. Контейнер группы пытается использовать эти значения, но размер полосы не гарантируется.

wszTitle[256]

Тип: WCHAR[256]

Буфер WCHAR , получающий название группы.

dwModeFlags

Тип: DWORD

Значение типа , получающее набор флагов, определяющих режим работы для объекта band. Одно или несколько из следующих значений:

DBIMF_NORMAL

Полоса использует свойства по умолчанию. Другие флаги режима изменяют этот флаг.

DBIMF_FIXED

Windows XP и более поздних версий: Объект полосы имеет фиксированный размер и положение. При использовании этого флага захват размера не отображается на объекте полосы.

DBIMF_FIXEDBMP

Windows XP и более поздних версий: Объект band использует фиксированный файл растрового изображения (.bmp) в качестве фона. Обратите внимание, что фоны поддерживаются не во всех случаях, поэтому растровое изображение может не видеться, даже если этот флаг установлен.

DBIMF_VARIABLEHEIGHT

Высоту объекта полосы можно изменить. Член ptIntegral определяет значение шага, с помощью которого можно изменить размер объекта band.

DBIMF_UNDELETEABLE

Windows XP и более поздних версий: Объект band не может быть удален из контейнера band.

DBIMF_DEBOSSED

Объект полосы отображается с затопленным внешним видом.

DBIMF_BKCOLOR

Полоса отображается с цветом фона, указанным в crBkgnd.

DBIMF_USECHEVRON

Windows XP и более поздних версий: Если не удается отобразить полный объект band (то есть объект band меньше , чем ptActual), отображается шеврон, указывающий на наличие дополнительных доступных параметров. Эти параметры отображаются при щелчке шеврона.

DBIMF_BREAK

Windows XP и более поздних версий: Объект band отображается в новой строке в контейнере полосы.

DBIMF_ADDTOFRONT

Windows XP и более поздних версий: Объект band является первым объектом в контейнере band.

DBIMF_TOPALIGN

Windows XP и более поздних версий: Объект band отображается в верхней строке контейнера полосы.

DBIMF_NOGRIPPER

Windows Vista и более поздних версий: Сцепление размера не отображается, чтобы позволить пользователю перемещать или изменять размер объекта полосы.

DBIMF_ALWAYSGRIPPER

Windows Vista и более поздних версий: Контроль размера, позволяющий пользователю перемещать или изменять размер объекта полосы, отображается всегда, даже если этот объект является единственным в контейнере.

DBIMF_NOMARGINS

Windows Vista и более поздних версий: Объект band не должен отображать поля.

crBkgnd

Тип: COLORREF

Структура COLORREF , которая получает цвет фона полосы. Элемент dwModeFlags должен содержать флаг DBIMF_BKCOLOR ; в противном случае параметр crBkgnd игнорируется.

Требования