ListView_SetGroupState macro (commctrl.h)

  • Artigo

Define o estado de um grupo especificado.

Sintaxe

LRESULT ListView_SetGroupState(
  [in] HWND hwnd,
  [in] UINT dwGroupId,
  [in] UINT dwMask,
  [in] UINT dwState
);

Parâmetros

[in] hwnd

Tipo: HWND

Um identificador para o controle de exibição de lista.

[in] dwGroupId

Tipo: UINT

Especifica o grupo iGroupId (consulte estrutura de LVGROUP).

[in] dwMask

Tipo: UINT

Especifica os valores de estado a serem definidos ou desmarcados. Essa é uma combinação dos sinalizadores listados para o estado membro do LVGROUP.

[in] dwState

Tipo: UINT

Especifica os valores de estado a serem definidos. Os estados que não estão incluídos aqui, mas estão incluídos no dwMask estão limpos.

Valor de retorno

Tipo: LRESULT

Retorna a ID do grupo (iGroupId) se bem-sucedido ou -1 caso contrário.

Observações

Observação Para usar essa macro, você deve fornecer um manifesto especificando Comctl32.dll versão 6.0. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.
 
Você também pode definir o estado do grupo usando ListView_SetGroupInfo.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho commctrl.h