CListCtrl::GetGroupRect
Recupera o retângulo delimitador de um grupo especificado no controle atual de exibição de lista.
BOOL GetGroupRect(
int iGroupId,
LPRECT lpRect,
int iCoords = LVGGR_GROUP
) const;
Parâmetros
Parâmetro |
Descrição |
|---|---|
[in] iGroupId |
Especifica um grupo. |
Em, [out] lpRect |
Ponteiro a estrutura de RECT . Se esse método é bem-sucedida, a estrutura recebe coordenadas do retângulo de grupo que é especificado por iGroupId. |
[in] iCoords |
Especifica as coordenadas do retângulo para recuperar. Use um de esses valores:
|
Valor de retorno
true se este método é com êxito; caso contrário, false.
Comentários
O chamador é responsável para atribuir a estrutura de RECT apontada pelo parâmetro de pRect .
Este método envia a mensagem de LVM_GETGROUPRECT , que é descrita em Windows SDK.
Requisitos
Cabeçalho: afxcmn.h
Esse controle é suportado em Windows Vista e posteriormente.
Os requisitos adicionais para o método são descritos em Requisitos de compilação para controles comuns do Windows Vista.
Exemplo
O exemplo de código a seguir define uma variável, m_listCtrl, que é usada para acessar o controle atual de exibição de lista. Esta variável é usado no exemplo a seguir.
public:
// Variable used to access the list control.
CListCtrl m_listCtrl;
O exemplo de código demonstra o método de GetGroupRect . Em uma seção anterior de este exemplo de código, nós criaremos um controle de exibição de lista que exibe duas colunas intitulassem “ClientID” e “classificar” em um visualizador de relatório. O exemplo de código a seguir desenha um retângulo 3D em torno do grupo cujo índice é 0, se esse grupo existe.
// GetGroupRect
// Get the graphics rectangle that surrounds group 0.
CRect rect;
BOOL bRet = m_listCtrl.GetGroupRect( 0, &rect, LVGGR_GROUP);
// Draw a blue rectangle around group 0.
if (bRet == TRUE) {
m_listCtrl.GetDC()->Draw3dRect( &rect, RGB(0, 0, 255), RGB(0, 0, 255));
}
else {
AfxMessageBox(_T("No group information was retrieved."), MB_ICONINFORMATION);
}