Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

BaseView.ShowingDockGuides Event

Allows you to hide dock guides and hints that appear when a user drags a Document or a DockPanel.

Namespace: DevExpress.XtraBars.Docking2010.Views

Assembly: DevExpress.XtraBars.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

public event ShowingDockGuidesEventHandler ShowingDockGuides

#Event Data

The ShowingDockGuides event's data class is DevExpress.XtraBars.Docking2010.Views.ShowingDockGuidesEventArgs.

#Remarks

The figure below illustrates all hints displayed when a user drags a panel.

panel

When a user drags a Document, only 5 central hints appear (hints #1, 2, 3, 4 and 5) since unlike panels, Documents cannot be docked anywhere but the DocumentManager.

All hints are stored inside guides. The are 5 global guides - a central guide that stores hints 1 to 9 (1 to 5 if a user drags a Document), and four side guides that store hints 10, 11, 12 and 13.

The ShowingDockGuidesEventArgs arguments class provides the Configuration property that exposes various public methods. These methods allow you to hide individual hints or guides that include multiple dock hints.

Dock hint 1

e.Configuration.Disable(DockHint.Center);

Dock hints 2, 3, 4 and 5

e.Configuration.Disable(DockHint.CenterLeft); //hint #2
e.Configuration.Disable(DockHint.CenterTop); //hint #3
e.Configuration.Disable(DockHint.CenterRight); //hint #4
e.Configuration.Disable(DockHint.CenterBottom); //hint #5

Dock hints 6, 7, 8 and 9

e.Configuration.Disable(DockHint.CenterSideLeft); //hint #6
e.Configuration.Disable(DockHint.CenterSideTop); //hint #7
e.Configuration.Disable(DockHint.CenterSideRight); //hint #8
e.Configuration.Disable(DockHint.CenterSideBottom); //hint #9

Dock hints 10, 11, 12 and 13

e.Configuration.Disable(DockHint.SideLeft); //hint #10
e.Configuration.Disable(DockHint.SideTop); //hint #11
e.Configuration.Disable(DockHint.SideRight); //hint #12
e.Configuration.Disable(DockHint.SideBottom); //hint #13

All outer side hints for panels (hints 6 to 13)

e.Configuration.DisableSideHints();

Central guide for Documents only (includes hints 1 to 5)

e.Configuration.Disable(DockGuide.Center);

Central guide for panels only (includes hints 1 to 9)

e.Configuration.Disable(DockGuide.CenterDock);

Side guides for panels (includes hints 10 to 13)

e.Configuration.DisableSideGuides();

Snap guides

These guides appear when you drag a Document or a panel to the edge of a screen.

e.Configuration.Disable(DockGuide.SnapLeft);
e.Configuration.Disable(DockGuide.SnapTop);
e.Configuration.Disable(DockGuide.SnapRight);
e.Configuration.Disable(DockGuide.SnapBottom);
//or
e.Configuration.DisableSnapGuides();
See Also