macro ListView_GetGroupRect (commctrl.h)

  • Artigo

Obtém o retângulo de um grupo especificado. Use essa macro ou envie a mensagem LVM_GETGROUPRECT explicitamente.

Sintaxe

void ListView_GetGroupRect(
  [in]       hwnd,
  [in]       iGroupId,
  [in]       type,
  [in, out]  prc
);

Parâmetros

[in] hwnd

Tipo: HWND

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

[in] iGroupId

Tipo: int

Especifica o grupo por iGroupId (consulte estrutura LVGROUP ).

[in] type

Tipo: LONG

Especifica o tipo de retângulo a ser recuperado. Esse parâmetro deve usar um dos valores a seguir.

Valor Significado
LVGGR_GROUP
 Coordenadas de todo o grupo expandido.
LVGGR_HEADER
 Coordenadas somente do cabeçalho (grupo recolhido).
LVGGR_LABEL
 Apenas coordenadas do rótulo.
LVGGR_SUBSETLINK
 Coordenadas somente do link de subconjunto (subconjunto de marcação). Um controle de exibição de lista pode limitar o número de itens visíveis exibidos em cada grupo. Um link é apresentado ao usuário para permitir que o usuário expanda o grupo. Esse sinalizador retornará o retângulo delimitador do link do subconjunto se o grupo for um subconjunto (estado de grupo de LVGS_SUBSETED, consulte estrutura LVGROUP, estado membro). Esse sinalizador é fornecido para que os aplicativos de acessibilidade possam localizar o link.

[in, out] prc

Tipo: RECT*

Um ponteiro para uma estrutura RECT para receber informações sobre o grupo especificado por iGroupId. O receptor da mensagem é responsável por definir os membros da estrutura com informações para o grupo especificado por iGroupId. O aplicativo de chamada é responsável por alocar memória para a estrutura.

Valor retornado

Nenhum

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho commctrl.h