Struttura DESKBANDINFO (shobjidl_core.h)

Riceve informazioni su un oggetto band. Questa struttura viene usata con il metodo IDeskBand::GetBandInfo deprecato.

Sintassi

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

Members

dwMask

Tipo: DWORD

Set di flag che determinano quali membri di questa struttura vengono richiesti dal chiamante. Uno o più dei valori seguenti:

DBIM_MINSIZE

ptMinSize è richiesto.

DBIM_MAXSIZE

ptMaxSize è richiesto.

DBIM_INTEGRAL

ptIntegral viene richiesto.

DBIM_ACTUAL

ptActual viene richiesto.

DBIM_TITLE

wszTitle viene richiesto.

DBIM_MODEFLAGS

dwModeFlags è richiesto.

DBIM_BKCOLOR

crBkgnd è richiesto.

ptMinSize

Tipo: POINTL

Struttura POINTL che riceve la dimensione minima dell'oggetto banda. La larghezza minima viene specificata nel membro x della struttura POINTL e l'altezza minima viene assegnata nel membro y.

ptMaxSize

Tipo: POINTL

Struttura POINTL che riceve la dimensione massima dell'oggetto banda. L'altezza massima viene assegnata nel membro y della struttura POINTL e il membro x viene ignorato. Se l'oggetto banda non ha limiti per l'altezza massima, è necessario usare (LONG)-1.

ptIntegral

Tipo: POINTL

Struttura POINTL che riceve il valore del passaggio di ridimensionamento (incremento) in cui viene ridimensionato l'oggetto banda. Il valore del passaggio verticale viene assegnato nel membro y della struttura POINTL e il membro x viene ignorato.

Il membro dwModeFlags deve contenere il flag DBIMF_VARIABLEHEIGHT; in caso contrario, ptIntegral viene ignorato.

ptActual

Tipo: POINTL

Struttura POINTL che riceve le dimensioni ideali dell'oggetto banda. La larghezza ideale viene data nel membro x della struttura POINTL e l'altezza ideale viene data nel membro y. Il contenitore band tenta di usare questi valori, ma non è garantito che la banda sia questa dimensione.

wszTitle[256]

Tipo: WCHAR[256]

Buffer WCHAR che riceve il titolo della banda.

dwModeFlags

Tipo: DWORD

Valore che riceve un set di flag che specificano la modalità di operazione per l'oggetto banda. Uno o più dei valori seguenti:

DBIMF_NORMAL

La banda usa le proprietà predefinite. Gli altri flag di modalità modificano questo flag.

DBIMF_FIXED

Windows XP e versioni successive: L'oggetto banda è di una dimensione fissa e di una posizione. Con questo flag, un grip di ridimensionamento non viene visualizzato sull'oggetto banda.

DBIMF_FIXEDBMP

Windows XP e versioni successive: L'oggetto band usa un file bitmap fisso (.bmp) come sfondo. Si noti che gli sfondi non sono supportati in tutti i casi, quindi la bitmap potrebbe non essere visualizzata anche quando questo flag è impostato.

DBIMF_VARIABLEHEIGHT

L'altezza dell'oggetto banda può essere modificata. Il membro ptIntegral definisce il valore del passaggio in base al quale l'oggetto banda può essere ridimensionato.

DBIMF_UNDELETEABLE

Windows XP e versioni successive: L'oggetto band non può essere rimosso dal contenitore band.

DBIMF_DEBOSSED

L'oggetto banda viene visualizzato con un aspetto incassato.

DBIMF_BKCOLOR

La banda viene visualizzata con il colore di sfondo specificato in crBkgnd.

DBIMF_USECHEVRON

Windows XP e versioni successive: Se non è possibile visualizzare l'oggetto full band, ovvero l'oggetto banda è più piccolo di ptActual, viene visualizzata una freccia di espansione per indicare che sono disponibili più opzioni. Queste opzioni vengono visualizzate quando si fa clic sulla freccia di espansione.

DBIMF_BREAK

Windows XP e versioni successive: L'oggetto band viene visualizzato in una nuova riga nel contenitore band.

DBIMF_ADDTOFRONT

Windows XP e versioni successive: L'oggetto band è il primo oggetto nel contenitore band.

DBIMF_TOPALIGN

Windows XP e versioni successive: L'oggetto banda viene visualizzato nella riga superiore del contenitore band.

DBIMF_NOGRIPPER

Windows Vista e versioni successive: Non viene mai visualizzata alcuna presa di ridimensionamento per consentire all'utente di spostare o ridimensionare l'oggetto banda.

DBIMF_ALWAYSGRIPPER

Windows Vista e versioni successive: Viene sempre visualizzata una presa di ridimensionamento che consente all'utente di spostare o ridimensionare l'oggetto banda, anche se tale oggetto banda è l'unico nel contenitore.

DBIMF_NOMARGINS

Windows Vista e versioni successive: L'oggetto banda non deve visualizzare i margini.

crBkgnd

Tipo: COLORREF

Struttura COLORREF che riceve il colore di sfondo della banda. Il membro dwModeFlags deve contenere il flag DBIMF_BKCOLOR ; in caso contrario, crBkgnd viene ignorato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	shobjidl_core.h (include Shobjidl.h)