Inconsistent docking behavior for document panes

280

Ingeborg Andersson posted over 12 years ago

The layout below produces inconsistent results depending on whether documents are tabbed or floating. Select Document1, drag it to position it to the right of document2. Now you have two documents side by side. Fine!

Now float document1. Document 2 is still docked.

Now try to dock document1 to the right of document2 again. This is not possible. You have to first place document1 on top of document2.

If you remove AllowDocking=False, it's possible to dock Document1, but it is not docked in the documenthost in this case (it looks different from document2)

This behavior is inconsistent from a usage perspective. I should be able to dock panes in the location they came from, shouldn't I?

        <docking:XamDockManager>
 
            <docking:XamDockManager.Panes>
                <docking:SplitPane SplitterOrientation="Horizontal" Width="auto">
                    <docking:TabGroupPane>
                        <docking:ContentPane AllowInDocumentHost="False">
                            <Label Content="Left"/>
                        </docking:ContentPane>
                    </docking:TabGroupPane>
                </docking:SplitPane>
                <docking:SplitPane SplitterOrientation="Horizontal" docking:XamDockManager.InitialLocation="DockedRight" Width="auto">
                    <docking:TabGroupPane >
                        <docking:ContentPane AllowInDocumentHost="False">
                            <Label Content="Right"/>
                        </docking:ContentPane>      
                    </docking:TabGroupPane>
                </docking:SplitPane>
                <docking:SplitPane docking:XamDockManager.InitialLocation="DockedTop" Height="auto">
                    <docking:TabGroupPane>
                        <docking:ContentPane AllowInDocumentHost="False">
                            <Label Content="Top"/>
                        </docking:ContentPane>
                    </docking:TabGroupPane>
                </docking:SplitPane>
                <docking:SplitPane docking:XamDockManager.InitialLocation="DockedBottom" Height="auto">
                    <docking:TabGroupPane >
                        <docking:ContentPane AllowInDocumentHost="False">
                            <Label Content="Bottom"/>
                        </docking:ContentPane>
                    </docking:TabGroupPane>
                </docking:SplitPane>
            </docking:XamDockManager.Panes>
 
            <docking:DocumentContentHost >
                <docking:SplitPane>
                    <docking:TabGroupPane>
                        <docking:ContentPane Header="Document1" AllowDocking="False" AllowDockingFloating="True" CloseAction="RemovePane">
                            <Label Content="Document1"/>
                        </docking:ContentPane>
                        <docking:ContentPane Header="Document2" AllowDocking="False" AllowDockingFloating="True" CloseAction="RemovePane">
                            <Label Content="Document2"/>
                        </docking:ContentPane>
                    </docking:TabGroupPane>
                </docking:SplitPane>
            </docking:DocumentContentHost>
        </docking:XamDockManager>

Parents

No Data

Reply

54937

Offline Andrew Smith [Infragistics] posted over 12 years ago

lemainan said:
Now float document1. Document 2 is still docked.
Technically Document 2 has a PaneLocation of Document and exists within the DocumentContentHost.

lemainan said:
Now try to dock document1 to the right of document2 again. This is not possible. You have to first place document1 on top of document2.
The behavior of the xamDockManager is consistent with VS 2008 which is the version of VS available when xamDockManager was designed and written. When one drags over one of the global indicators (the up, down, left or right arrow displayed along the outer edge of the xamDockManager), a new separate SplitPane is created along that outer edge to host the content. When one drags a dockable pane (in this case the floating pane is floating dockable) over a dockable pane (i.e. floating dockable, docked left, docked right, docked top or docked bottom), the center indicator is displayed with options of adding the pane to that pane or positioning it relative to that pane. When over the center content (the DocumentContentHost in this case), the center portion of that dock indicator is used to add the pane to that area (in this case add it to the tabgroup in the DocumentContentHost containing the ActiveDocument) and the left/right/top/bottom portion are used to create a new docked (i.e. PaneLocation of DockedLeft, DockedRight, DockedTop or DockedBottom) split pane along the inner edge of the xamDockManager. In VS 2010, MS added an extra set of docking indicators when over the panes in the tabbed document area. You may want to submit a feature request for adding this functionality to the xamDockManager.
Cancel
Reply

Cancel

Children

280

Offline Ingeborg Andersson posted over 12 years ago in reply to Andrew Smith [Infragistics]

I understand that it is consistent with VS2008 - but I still claim the behavior does not feel consistent to a user. If I also set AllowDocking=False for the document panes so they cannot be docked left/top/bottom/right (as is the desired behavior in our application), the behavior is even less understandable from a user perspective.

In this case, you will only see the center indicator (as expected). If the pane was dragged from a docked state, I can drop it on any of the five positions, and it is positioned in the document host. If the pane was dragged from a floating state, only the center position allows drop. It's hard to justify this behavior to our users.

I think that if I have a floating pane with AllowDocking=False, AllowInDocumentHost=True and AllowDockingFloating=True, the drop behavior should be to place it in the document host instead of a new split pane (or as is the current case, not allow the drop)
Cancel
Reply

Cancel
12875

[Infragistics] Marianne posted over 12 years ago in reply to Andrew Smith [Infragistics]

Hi,

I have taken the liberty of adding a product idea for your suggestion and included the details that you and Andrew provided, directly to our Product Management team. Our product team chooses new product ideas for development based on popular feedback from our customer base. Infragistics continues to monitor application development for all of our products so as trends appear in product ideas, we can plan accordingly.

We value your input, and our philosophy is to enhance our toolset based on customer feedback. If your features are chosen for development you will be notified at that time. Your reference number is PI12090020.

If you need any further assistance please do not hesitate to ask.
Cancel
Reply

Cancel