AccordionControl.ShowPopupForm(AccordionControlElement) Method

Shows the pop-up form.

Namespace: DevExpress.XtraBars.Navigation

Assembly: DevExpress.XtraBars.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

public void ShowPopupForm(
    AccordionControlElement element
)

VB.NET

Public Sub ShowPopupForm(
    element As AccordionControlElement
)

Parameters

Name	Type	Description
element	AccordionControlElement	An object that specifies the element for which to show the pop-up form.

Remarks

If the control is minimized (see AccordionControl.OptionsMinimizing.State), it displays a pop-up form when the user clicks an element.

You can use the AccordionControl.OptionsMinimizing.PopupFormAutoHeightMode property to specify how the control calculates the form height.

To open the pop-up form in code, call the ShowPopupForm method. For instance, you can open the form when the mouse pointer hovers an item. To check if the form is already displayed, use the IsPopupFormShown property. To close the form, call the ClosePopupForm() method.

Examples

The code below shows how to automatically display the pop-up form for an element when the user hovers the element with the mouse pointer.

C#

using DevExpress.XtraBars.Navigation;

accordionControl1.MouseMove += AccordionControl1_MouseMove;

AccordionControlElement hoveredElement = null;
private void AccordionControl1_MouseMove(object sender, MouseEventArgs e) {
    AccordionControl accordionControl = sender as AccordionControl;
    var hitInfo = accordionControl.CalcHitInfo(e.Location);
    if(hitInfo.IsInElement) {
        if(hoveredElement == hitInfo.ItemInfo.Element && accordion.IsPopupFormShown) {
            return;
        }
        accordion.ShowPopupForm(hitInfo.ItemInfo.Element);
        hoveredElement = hitInfo.ItemInfo.Element;
    }
}

VB.NET

Imports DevExpress.XtraBars.Navigation

Private hoveredElement As AccordionControlElement = Nothing
Private Sub AccordionControl1_MouseMove(ByVal sender As Object, ByVal e As MouseEventArgs) Handles accordionControl1.MouseMove
    Dim accordionControl As AccordionControl = TryCast(sender, AccordionControl)
    Dim hitInfo = accordionControl.CalcHitInfo(e.Location)
    If hitInfo.IsInElement Then
        If hoveredElement Is hitInfo.ItemInfo.Element AndAlso accordionControl1.IsPopupFormShown Then
            Return
        End If
        accordionControl1.ShowPopupForm(hitInfo.ItemInfo.Element)
        hoveredElement = hitInfo.ItemInfo.Element
    End If
End Sub

The code below shows how to close the pop-up form when the user clicks an item.

C#

using DevExpress.XtraBars.Navigation;

accordionControl1.OptionsHamburgerMenu.DisplayMode = AccordionControlDisplayMode.Inline;
accordionControl1.ViewType = AccordionControlViewType.HamburgerMenu;

private void accordionControl1_ElementClick(object sender, DevExpress.XtraBars.Navigation.ElementClickEventArgs e) {
    AccordionControl accordionControl = sender as AccordionControl;
    if (e.MouseButton == MouseButtons.Left && accordionControl.IsPopupFormShown) {
        accordionControl.ClosePopupForm();
        e.Handled = true;
    }
}

VB.NET

Imports DevExpress.XtraBars.Navigation

accordionControl1.OptionsHamburgerMenu.DisplayMode = AccordionControlDisplayMode.Inline
accordionControl1.ViewType = AccordionControlViewType.HamburgerMenu

Private Sub accordionControl1_ElementClick(ByVal sender As Object, ByVal e As ElementClickEventArgs) _
    Handles accordionControl1.ElementClick
    Dim accordionControl As AccordionControl = TryCast(sender, AccordionControl)
    If e.MouseButton = MouseButtons.Left AndAlso accordionControl.IsPopupFormShown Then
        accordionControl.ClosePopupForm()
        e.Handled = True
    End If
End Sub