IDeskBand::GetBandInfo-Methode (shobjidl_core.h)

Artikel
08/26/2023

Ruft Zustandsinformationen für ein Bandobjekt ab.

Wichtig Sie sollten Miniaturansichtssymbolleisten in der Neuentwicklung anstelle von Schreibtischbändern verwenden, die ab Windows 7 nicht mehr unterstützt werden.

Syntax

HRESULT GetBandInfo(
  DWORD        dwBandID,
  DWORD        dwViewMode,
  DESKBANDINFO *pdbi
);

Parameter

dwBandID

Art: DWORD

Der Bezeichner des Bandes, der vom Container zugewiesen wird. Das Bandobjekt kann diesen Wert beibehalten, wenn er erforderlich ist.

dwViewMode

Art: DWORD

Der Ansichtsmodus des Bandobjekts. Einer der folgenden Werte:

DBIF_VIEWMODE_NORMAL

Das Bandobjekt wird in einem horizontalen Band angezeigt.

DBIF_VIEWMODE_VERTICAL

Das Bandobjekt wird in einem vertikalen Band angezeigt.

DBIF_VIEWMODE_FLOATING

Das Bandobjekt wird in einem schwebenden Band angezeigt.

DBIF_VIEWMODE_TRANSPARENT

Das Bandobjekt wird in einem transparenten Band angezeigt.

pdbi

Typ: DESKBANDINFO*

Zeiger auf eine DESKBANDINFO-Struktur , die die Bandinformationen für das Objekt empfängt. Der dwMask-Member dieser Struktur gibt die spezifischen Informationen an, die angefordert werden.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

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]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shlobj.h einschließen)
DLL	Shell32.dll (Version 4.71 oder höher)

Freigeben über