ListView_GetGroupRect macro (commctrl.h)

  • Artigo

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

Sintaxe

BOOL ListView_GetGroupRect(
  [in]      HWND hwnd,
  [in]      int  iGroupId,
  [in]      LONG type,
  [in, out] RECT *prc
);

Parâmetros

[in] hwnd

Tipo: HWND

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

[in] iGroupId

Tipo: int

Especifica o grupo iGroupId (consulte estrutura de LVGROUP).

[in] type

Tipo: LONG

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

Valor Significado
LVGGR_GROUP
 Coordenadas de todo o grupo expandido.
LVGGR_HEADER
 Coordenadas somente do cabeçalho (grupo recolhido).
LVGGR_LABEL
 Coordenadas somente do rótulo.
LVGGR_SUBSETLINK
 Coordenadas somente do link do 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 do grupo de LVGS_SUBSETED, consulte a estrutura LVGROUP, membro estado). 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 de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

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