DESKBANDINFO-Struktur (shobjidl_core.h)

Empfängt Informationen zu einem Bandobjekt. Diese Struktur wird mit der veralteten IDeskBand::GetBandInfo-Methode verwendet.

Syntax

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

Member

dwMask

Art: DWORD

Der Satz von Flags, die bestimmen, welche Member dieser Struktur vom Aufrufer angefordert werden. Mindestens einer der folgenden Werte:

DBIM_MINSIZE

ptMinSize wird angefordert.

DBIM_MAXSIZE

ptMaxSize wird angefordert.

DBIM_INTEGRAL

ptIntegral wird angefordert.

DBIM_ACTUAL

ptActual wird angefordert.

DBIM_TITLE

wszTitle wird angefordert.

DBIM_MODEFLAGS

dwModeFlags wird angefordert.

DBIM_BKCOLOR

crBkgnd wird angefordert.

ptMinSize

Typ: POINTL

Eine POINTL-Struktur , die die Mindestgröße des Bandobjekts empfängt. Die Mindestbreite wird im x-Element der POINTL-Struktur angegeben, und die minimale Höhe wird im y-Element angegeben.

ptMaxSize

Typ: POINTL

Eine POINTL-Struktur , die die maximale Größe des Bandobjekts empfängt. Die maximale Höhe wird im y-Element der POINTL-Struktur angegeben, und das x-Element wird ignoriert. Wenn das Bandobjekt keine Begrenzung für seine maximale Höhe aufweist, sollte (LONG)-1 verwendet werden.

ptIntegral

Typ: POINTL

Eine POINTL-Struktur , die den Größenschrittwert (Inkrement) empfängt, in dem die Größe des Bandobjekts geändert wird. Der wert für den vertikalen Schritt wird im y-Element der POINTL-Struktur angegeben, und das x-Element wird ignoriert.

Der dwModeFlags-Member muss das flag DBIMF_VARIABLEHEIGHT enthalten. andernfalls wird ptIntegral ignoriert.

ptActual

Typ: POINTL

Eine POINTL-Struktur , die die ideale Größe des Bandobjekts empfängt. Die ideale Breite wird im x-Element der POINTL-Struktur angegeben, und die ideale Höhe wird im y-Element angegeben. Der Bandcontainer versucht, diese Werte zu verwenden, aber es ist nicht garantiert, dass das Band diese Größe aufweist.

wszTitle[256]

Typ: WCHAR[256]

Ein WCHAR-Puffer , der den Titel des Bandes empfängt.

dwModeFlags

Art: DWORD

Ein -Wert, der eine Reihe von Flags empfängt, die den Betriebsmodus für das Bandobjekt angeben. Mindestens einer der folgenden Werte:

DBIMF_NORMAL

Das Band verwendet Standardeigenschaften. Die anderen Modusflags ändern dieses Flag.

DBIMF_FIXED

Windows XP und höher: Das Bandobjekt hat eine feste Größe und Position. Mit diesem Flag wird kein Größengriff auf dem Bandobjekt angezeigt.

DBIMF_FIXEDBMP

Windows XP und höher: Das Bandobjekt verwendet eine feste Bitmapdatei (.bmp) als Hintergrund. Beachten Sie, dass Hintergründe nicht in allen Fällen unterstützt werden, sodass die Bitmap möglicherweise nicht angezeigt wird, auch wenn dieses Flag festgelegt ist.

DBIMF_VARIABLEHEIGHT

Die Höhe des Bandobjekts kann geändert werden. Der ptIntegral-Member definiert den Schrittwert, um den die Größe des Bandobjekts geändert werden kann.

DBIMF_UNDELETEABLE

Windows XP und höher: Das Bandobjekt kann nicht aus dem Bandcontainer entfernt werden.

DBIMF_DEBOSSED

Das Bandobjekt wird mit einer abgesenkten Darstellung angezeigt.

DBIMF_BKCOLOR

Das Band wird mit der in crBkgnd angegebenen Hintergrundfarbe angezeigt.

DBIMF_USECHEVRON

Windows XP und höher: Wenn das vollständige Bandobjekt nicht angezeigt werden kann (d. h. das Bandobjekt ist kleiner als ptActual, wird ein Chevron angezeigt, um anzugeben, dass mehr Optionen verfügbar sind. Diese Optionen werden angezeigt, wenn auf das Chevron geklickt wird.

DBIMF_BREAK

Windows XP und höher: Das Bandobjekt wird in einer neuen Zeile im Bandcontainer angezeigt.

DBIMF_ADDTOFRONT

Windows XP und höher: Das Bandobjekt ist das erste Objekt im Bandcontainer.

DBIMF_TOPALIGN

Windows XP und höher: Das Bandobjekt wird in der obersten Zeile des Bandcontainers angezeigt.

DBIMF_NOGRIPPER

Windows Vista und höher: Es wird kein Größengriff angezeigt, um dem Benutzer das Verschieben oder Ändern der Größe des Bandobjekts zu ermöglichen.

DBIMF_ALWAYSGRIPPER

Windows Vista und höher: Ein Griff zur Größenanpassung, der es dem Benutzer ermöglicht, das Bandobjekt zu verschieben oder die Größe zu ändern, wird immer angezeigt, auch wenn dieses Bandobjekt das einzige im Container ist.

DBIMF_NOMARGINS

Windows Vista und höher: Das Bandobjekt sollte keine Ränder anzeigen.

crBkgnd

Typ: COLORREF

Eine COLORREF-Struktur , die die Hintergrundfarbe des Bandes empfängt. Das dwModeFlags-Element muss das DBIMF_BKCOLOR-Flag enthalten. andernfalls wird crBkgnd ignoriert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)