CHeaderCtrl::GetItemDropDownRect
Obtiene el rectángulo delimitador del botón desplegable para un elemento de encabezado del control de encabezado actual.
BOOL GetItemDropDownRect(
int iItem,
LPRECT lpRect
) const;
Parámetros
Parámetro |
Descripción |
|---|---|
[in] iItem |
índice de base cero de un elemento de encabezado cuyo estilo es HDF_SPLITBUTTON. Para obtener más información, vea el miembro de fmt de la estructura de HDITEM . |
[out] lpRect |
Puntero a una estructura de RECT para recibir información sobre el rectángulo delimitador. |
Valor devuelto
true si esta función es correcta; si no, false.
Comentarios
este método envía el mensaje de HDM_GETITEMDROPDOWNRECT , que se describe en Windows SDK.
Requisitos
encabezado: afxcmn.h
Este método se admite en Windows Vista y posterior.
los requisitos adicionales para este método se describen en Requisitos de compilación para los controles comunes de Windows Vista.
Ejemplo
El ejemplo de código siguiente define la variable, m_headerCtrl, que se utiliza para tener acceso al control de encabezado actual. esta variable se utiliza en el ejemplo siguiente.
CHeaderCtrl m_headerCtrl;
CSplitButton m_splitButton;
En el ejemplo de código siguiente se muestra el método GetItemDropDownRect. En una sección de código anterior, creamos un control de encabezado con cinco columnas. El ejemplo de código siguiente se dibuja un rectángulo 3D alrededor de la ubicación en la primera columna que se reserva para el botón desplegable del encabezado.
void CNVC_MFC_CHeaderCtrl_s4Dlg::OnXGetitemdropdownrect()
{
if (controlCreated == FALSE) {
MessageBox(_T("Header control has not been created yet."));
return;
}
// Get the dropdown rect for the first column.
CRect rect;
BOOL bRetVal = m_headerCtrl.GetItemDropDownRect(0, &rect);
if (bRetVal == TRUE) {
// Draw around the dropdown rect a rectangle that has red
// left and top sides, and blue right and bottom sides.
CDC* pDC = m_headerCtrl.GetDC();
pDC->Draw3dRect(rect, RGB(255, 0, 0), RGB(0, 0, 255));
}
}