Método IDeskBand::GetBandInfo (shobjidl_core.h)

  • Artigo

Obtém informações de estado para um objeto de banda.

Importante Você deve usar barras de ferramentas em miniatura em um novo desenvolvimento no lugar de faixas de mesa, que não têm suporte a partir do Windows 7.
 

Sintaxe

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

Parâmetros

dwBandID

Tipo: DWORD

O identificador da banda, atribuído pelo contêiner. O objeto de banda poderá reter esse valor se for necessário.

dwViewMode

Tipo: DWORD

O modo de exibição do objeto de banda. Um dos seguintes valores:

DBIF_VIEWMODE_NORMAL

O objeto de banda está sendo exibido em uma faixa horizontal.

DBIF_VIEWMODE_VERTICAL

O objeto de banda está sendo exibido em uma faixa vertical.

DBIF_VIEWMODE_FLOATING

O objeto de banda está sendo exibido em uma banda flutuante.

DBIF_VIEWMODE_TRANSPARENT

O objeto de banda está sendo exibido em uma faixa transparente.

pdbi

Tipo: DESKBANDINFO*

Ponteiro para uma estrutura DESKBANDINFO que recebe as informações de banda do objeto. O membro dwMask dessa estrutura indica as informações específicas que estão sendo solicitadas.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

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]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shlobj.h)
DLL Shell32.dll (versão 4.71 ou posterior)