Compartilhar via


ListView_GetGroupInfoByIndex macro (commctrl.h)

Obtém informações sobre um grupo especificado. Use essa macro ou envie a mensagem LVM_GETGROUPINFOBYINDEX explicitamente.

Sintaxe

LRESULT ListView_GetGroupInfoByIndex(
  [in]      HWND     hwnd,
  [in]      int      iIndex,
  [in, out] PLVGROUP pgrp
);

Parâmetros

[in] hwnd

Tipo: HWND

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

[in] iIndex

Tipo: int

O índice do grupo.

[in, out] pgrp

Tipo: PLVGROUP

Um ponteiro para uma estrutura de LVGROUP para receber informações sobre o grupo especificado por iIndex. O aplicativo de chamada é responsável por alocar memória para a estrutura e quaisquer buffers na estrutura, como aquele apontado por pszHeader. Defina todos os membros contingentes da estrutura, como, cchHeader— o tamanho do buffer apontado por pszHeader nododo WCHAR , incluindo o null. Defina cbSize com o tamanho de LVGROUP em bytes.

O receptor da mensagem é responsável por definir os membros da estrutura com informações para o grupo especificado por iIndex.

Valor de retorno

Tipo: LRESULT

Retorna 1 se bem-sucedido ou 0 de outra forma.

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