Metodo IDeskBand::GetBandInfo (shobjidl_core.h)

Articolo
03/13/2024

Ottiene le informazioni sullo stato per un oggetto band.

Importante È consigliabile usare le barre degli strumenti di anteprima in un nuovo sviluppo al posto delle bande di scrivania, che non sono supportate a partire da Windows 7.

Sintassi

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

Parametri

dwBandID

Tipo: DWORD

Identificatore della banda, assegnato dal contenitore. L'oggetto band può conservare questo valore se necessario.

dwViewMode

Tipo: DWORD

Modalità di visualizzazione dell'oggetto band. Uno dei valori seguenti:

DBIF_VIEWMODE_NORMAL

L'oggetto band viene visualizzato in una banda orizzontale.

DBIF_VIEWMODE_VERTICAL

L'oggetto band viene visualizzato in una banda verticale.

DBIF_VIEWMODE_FLOATING

L'oggetto band viene visualizzato in una banda mobile.

DBIF_VIEWMODE_TRANSPARENT

L'oggetto band viene visualizzato in una banda trasparente.

pdbi

Tipo: DESKBANDINFO*

Puntatore a una struttura DESKBANDINFO che riceve le informazioni sulla banda per l'oggetto. Il membro dwMask di questa struttura indica le informazioni specifiche richieste.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (includere Shlobj.h)
DLL	Shell32.dll (versione 4.71 o successiva)

Condividi tramite