Estructura DESKBANDINFO (shobjidl_core.h)

Recibe información sobre un objeto de banda. Esta estructura se usa con el método IDeskBand::GetBandInfo en desuso.

Sintaxis

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

Miembros

dwMask

Tipo: DWORD

Conjunto de marcas que determinan qué miembros de esta estructura solicita el autor de la llamada. Uno o varios de los siguientes valores:

DBIM_MINSIZE

se solicita ptMinSize .

DBIM_MAXSIZE

se solicita ptMaxSize .

DBIM_INTEGRAL

se solicita ptIntegral .

DBIM_ACTUAL

ptActual se solicita.

DBIM_TITLE

se solicita wszTitle .

DBIM_MODEFLAGS

dwModeFlags se solicita.

DBIM_BKCOLOR

se solicita crBkgnd .

ptMinSize

Tipo: POINTL

Estructura POINTL que recibe el tamaño mínimo del objeto de banda. El ancho mínimo se da en el miembro x de la estructura POINTL y el alto mínimo se da en el miembro y.

ptMaxSize

Tipo: POINTL

Estructura POINTL que recibe el tamaño máximo del objeto de banda. El alto máximo se da en el miembro y de la estructura POINTL y se omite el miembro x. Si el objeto de banda no tiene límite para su alto máximo, se debe usar (LONG)-1.

ptIntegral

Tipo: POINTL

Estructura POINTL que recibe el valor del paso de ajuste de tamaño (incremento) en el que se cambia el tamaño del objeto de banda. El valor del paso vertical se proporciona en el miembro y de la estructura POINTL y se omite el miembro x.

El miembro dwModeFlags debe contener la marca DBIMF_VARIABLEHEIGHT; de lo contrario, se omite ptIntegral .

ptActual

Tipo: POINTL

Estructura POINTL que recibe el tamaño ideal del objeto de banda. El ancho ideal se da en el miembro x de la estructura POINTL y el alto ideal se da en el miembro y. El contenedor de bandas intenta usar estos valores, pero no se garantiza que la banda sea de este tamaño.

wszTitle[256]

Tipo: WCHAR[256]

Un búfer WCHAR que recibe el título de la banda.

dwModeFlags

Tipo: DWORD

Valor que recibe un conjunto de marcas que especifican el modo de operación para el objeto de banda. Uno o varios de los siguientes valores:

DBIMF_NORMAL

La banda usa propiedades predeterminadas. Las otras marcas de modo modifican esta marca.

DBIMF_FIXED

Windows XP y versiones posteriores: El objeto band es de un tamaño fijo y una posición. Con esta marca, no se muestra un control de tamaño en el objeto de banda.

DBIMF_FIXEDBMP

Windows XP y versiones posteriores: El objeto band usa un archivo de mapa de bits fijo (.bmp) como fondo. Tenga en cuenta que los fondos no se admiten en todos los casos, por lo que es posible que el mapa de bits no se vea incluso cuando se establece esta marca.

DBIMF_VARIABLEHEIGHT

Se puede cambiar el alto del objeto de banda. El miembro ptIntegral define el valor del paso por el que se puede cambiar el tamaño del objeto de banda.

DBIMF_UNDELETEABLE

Windows XP y versiones posteriores: El objeto de banda no se puede quitar del contenedor de bandas.

DBIMF_DEBOSSED

El objeto band se muestra con una apariencia hundida.

DBIMF_BKCOLOR

La banda se muestra con el color de fondo especificado en crBkgnd.

DBIMF_USECHEVRON

Windows XP y versiones posteriores: Si no se puede mostrar el objeto de banda completa (es decir, el objeto de banda es menor que ptActual, se muestra un botón de contenido adicional para indicar que hay más opciones disponibles. Estas opciones se muestran cuando se hace clic en el botón de contenido adicional.

DBIMF_BREAK

Windows XP y versiones posteriores: El objeto band se muestra en una nueva fila del contenedor de bandas.

DBIMF_ADDTOFRONT

Windows XP y versiones posteriores: El objeto band es el primer objeto del contenedor de bandas.

DBIMF_TOPALIGN

Windows XP y versiones posteriores: El objeto band se muestra en la fila superior del contenedor de bandas.

DBIMF_NOGRIPPER

Windows Vista y versiones posteriores: Nunca se muestra ningún control de tamaño para permitir que el usuario mueva o cambie el tamaño del objeto de banda.

DBIMF_ALWAYSGRIPPER

Windows Vista y versiones posteriores: Siempre se muestra un control de tamaño que permite al usuario mover o cambiar el tamaño del objeto de banda, incluso si ese objeto de banda es el único del contenedor.

DBIMF_NOMARGINS

Windows Vista y versiones posteriores: El objeto band no debe mostrar márgenes.

crBkgnd

Tipo: COLORREF

Estructura COLORREF que recibe el color de fondo de la banda. El miembro dwModeFlags debe contener la marca DBIMF_BKCOLOR ; de lo contrario, se omite crBkgnd .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	shobjidl_core.h (include Shobjidl.h)