Estrutura DESKBANDINFO (shobjidl_core.h)

Recebe informações sobre um objeto de banda. Essa estrutura é usada com o método IDeskBand::GetBandInfo preterido.

Sintaxe

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

Membros

dwMask

Tipo: DWORD

O conjunto de sinalizadores que determinam quais membros dessa estrutura estão sendo solicitados pelo chamador. Um ou mais dos seguintes valores:

DBIM_MINSIZE

ptMinSize é solicitado.

DBIM_MAXSIZE

ptMaxSize é solicitado.

DBIM_INTEGRAL

ptIntegral é solicitado.

DBIM_ACTUAL

ptActual é solicitado.

DBIM_TITLE

wszTitle é solicitado.

DBIM_MODEFLAGS

dwModeFlags é solicitado.

DBIM_BKCOLOR

crBkgnd é solicitado.

ptMinSize

Tipo: POINTL

Uma estrutura POINTL que recebe o tamanho mínimo do objeto de banda. A largura mínima é fornecida no membro x da estrutura POINTL e a altura mínima é fornecida no membro y.

ptMaxSize

Tipo: POINTL

Uma estrutura POINTL que recebe o tamanho máximo do objeto de banda. A altura máxima é fornecida no membro y da estrutura POINTL e o membro x é ignorado. Se o objeto de banda não tiver limite para sua altura máxima, (LONG)-1 deverá ser usado.

ptIntegral

Tipo: POINTL

Uma estrutura POINTL que recebe o valor da etapa de dimensionamento (incremento) no qual o objeto de banda é redimensionado. O valor da etapa vertical é fornecido no membro y da estrutura POINTL e o membro x é ignorado.

O membro dwModeFlags deve conter o sinalizador DBIMF_VARIABLEHEIGHT; caso contrário, ptIntegral será ignorado.

ptActual

Tipo: POINTL

Uma estrutura POINTL que recebe o tamanho ideal do objeto de banda. A largura ideal é fornecida no membro x da estrutura POINTL e a altura ideal é fornecida no membro y. O contêiner de banda tenta usar esses valores, mas não há garantia de que a banda seja desse tamanho.

wszTitle[256]

Tipo: WCHAR[256]

Um buffer WCHAR que recebe o título da banda.

dwModeFlags

Tipo: DWORD

Um valor que recebe um conjunto de sinalizadores que especificam o modo de operação para o objeto de banda. Um ou mais dos seguintes valores:

DBIMF_NORMAL

A banda usa propriedades padrão. Os outros sinalizadores de modo modificam esse sinalizador.

DBIMF_FIXED

Windows XP e posterior: O objeto de banda é de um tamanho fixo e uma posição. Com esse sinalizador, uma alça de dimensionamento não é exibida no objeto de banda.

DBIMF_FIXEDBMP

Windows XP e posterior: O objeto band usa um arquivo bitmap fixo (.bmp) como plano de fundo. Observe que não há suporte para planos de fundo em todos os casos, portanto, o bitmap pode não ser visto mesmo quando esse sinalizador é definido.

DBIMF_VARIABLEHEIGHT

A altura do objeto de banda pode ser alterada. O membro ptIntegral define o valor da etapa pelo qual o objeto de banda pode ser redimensionado.

DBIMF_UNDELETEABLE

Windows XP e posterior: O objeto de banda não pode ser removido do contêiner de banda.

DBIMF_DEBOSSED

O objeto de banda é exibido com uma aparência submersa.

DBIMF_BKCOLOR

A faixa é exibida com a cor da tela de fundo especificada em crBkgnd.

DBIMF_USECHEVRON

Windows XP e posterior: Se o objeto de banda completa não puder ser exibido (ou seja, o objeto de banda for menor que ptActual, uma divisa será mostrada para indicar que há mais opções disponíveis. Essas opções são exibidas quando a divisa é clicada.

DBIMF_BREAK

Windows XP e posterior: O objeto de banda é exibido em uma nova linha no contêiner de banda.

DBIMF_ADDTOFRONT

Windows XP e posterior: O objeto band é o primeiro objeto no contêiner de banda.

DBIMF_TOPALIGN

Windows XP e posterior: O objeto band é exibido na linha superior do contêiner de banda.

DBIMF_NOGRIPPER

Windows Vista e posterior: Nenhuma alça de dimensionamento é exibida para permitir que o usuário mova ou redimensione o objeto de banda.

DBIMF_ALWAYSGRIPPER

Windows Vista e posterior: Uma alça de dimensionamento que permite ao usuário mover ou redimensionar o objeto de banda é sempre mostrada, mesmo que esse objeto de banda seja o único no contêiner.

DBIMF_NOMARGINS

Windows Vista e posterior: O objeto de banda não deve exibir margens.

crBkgnd

Tipo: COLORREF

Uma estrutura COLORREF que recebe a cor da tela de fundo da banda. O membro dwModeFlags deve conter o sinalizador DBIMF_BKCOLOR ; caso contrário, crBkgnd será ignorado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)