diff --git a/knowledge-base/dock-hide-docking-guide-indicators.md b/knowledge-base/dock-hide-docking-guide-indicators.md new file mode 100644 index 000000000..8bc6f1ae4 --- /dev/null +++ b/knowledge-base/dock-hide-docking-guide-indicators.md @@ -0,0 +1,70 @@ +--- +title: How to Hide DockingGuide Indicators +description: Learn how to hide DockingGuide Indicators that appear in the center and manage their position. +type: how-to +page_title: How to Hide DockingGuide Indicators that Appear in Center in RadDock for WinForms +slug: dock-hide-docking-guide-indicators +tags: dock, docking, indicator, hints, position, drag, drop +res_type: kb +ticketid: 1661136 +--- + +## Environment + +|Product Version|Product|Author| +|----|----|----| +|2024.3.806|RadDock for WinForms|[Nadya Todorova](https://www.telerik.com/blogs/author/nadya-karaivanova)| + +## Description + +By default, when the user starts dragging a window in RadDock, Docking Assistant appears. Docking Assistant uses DockingGuidesTemplates to show hints to help the user to relocate the window. For more information please refer to [Using the DragDropService]({%slug winforms/controls/dock/architecture-and-features/using-the-dragdropservice%}) + +>caption Figure 1: Before. + +![dock-hide-docking-guide-indicators](images/dock-hide-docking-guide-indicators001.png) + +A common requirement is to hide some of the docking guide indicators. This article demonstrates how one can manage the docking hints appearance and achieve the look as the image below: + +>caption Figure 2: After + +![dock-hide-docking-guide-indicators](images/dock-hide-docking-guide-indicators002.png) + +## Solution + +To achieve this, you should handle the **DragDropService.PreviewDockPosition** event of RadDock. **AllowedDockPosition** property gets or sets the allowed dock position for the hit-tested drop target which you can customize and set only the relevant positions for you. + +Please refer to the following code snippet: + +````C# + +DragDropService service = this.radDock1.GetService(); +service.PreviewDockPosition += Service_PreviewDockPosition; + +private void Service_PreviewDockPosition(object sender, DragDropDockPositionEventArgs e) +{ + if (e.GuidePosition == DockingGuidesPosition.Center) + { + e.AllowedDockPosition = AllowedDockPosition.None; + } +} + +```` +````VB.NET +Dim service As DragDropService = Me.radDock1.GetService(Of DragDropService)() +AddHandler service.PreviewDockPosition, AddressOf Service_PreviewDockPosition + +Private Sub Service_PreviewDockPosition(ByVal sender As Object, ByVal e As DragDropDockPositionEventArgs) + If e.GuidePosition = DockingGuidesPosition.Center Then + e.AllowedDockPosition = AllowedDockPosition.None + End If + End Sub + +```` + +>note Feel free to customize further the **AllowedDockPositions** with different options according to your needs. + + +## See Also + +[Using the DragDropService]({%slug winforms/controls/dock/architecture-and-features/using-the-dragdropservice%}) +[DockingGuidesTemplate]({%slug winforms/controls/dock/architecture-and-features/dockingguidestemplate%}) diff --git a/knowledge-base/images/dock-hide-docking-guide-indicators001.png b/knowledge-base/images/dock-hide-docking-guide-indicators001.png new file mode 100644 index 000000000..816986d78 Binary files /dev/null and b/knowledge-base/images/dock-hide-docking-guide-indicators001.png differ diff --git a/knowledge-base/images/dock-hide-docking-guide-indicators002.png b/knowledge-base/images/dock-hide-docking-guide-indicators002.png new file mode 100644 index 000000000..2e59f5ea8 Binary files /dev/null and b/knowledge-base/images/dock-hide-docking-guide-indicators002.png differ