用户控件对接属性

Question

我正在尝试制作自己的用户控件，并且几乎已经完成，只是想添加一些润色。 我希望设计器中的选项“停靠在父容器中”。 有谁知道如何做到这一点，我找不到例子。 我认为这与对接属性有关。

Answer 1

我还建议查看 对接属性。

[Docking(DockingBehavior.Ask)]
public class MyControl : UserControl
{
    public MyControl() { }
}

这还会在控件的右上角显示“操作箭头”。

此选项早在 .NET 2.0 中就可用，如果您要查找的只是“在父容器中停靠/取消停靠”功能，则该选项要简单得多。 在这种情况下，Designer 类就显得大材小用了。

它还提供了 DockingBehavior.Never 和 DockingBehavior.AutoDock 选项。 Never 不显示箭头并以其默认的 Dock 行为加载新控件，而 AutoDock 显示箭头但自动将控件停靠为填充。

PS：对于死灵术线程感到抱歉。 我一直在寻找类似的解决方案，这是谷歌上出现的第一个解决方案。 这
设计师属性给了我一个想法，所以我开始挖掘并
找到了 DockingAttribute，它看起来比接受的要干净得多
具有相同要求结果的解决方案。 希望这会有所帮助
未来的某个人。

Answer 2

为了实现这一点，您需要实现几个类； 首先，您需要一个自定义 ControlDesigner然后您将需要一个自定义的 DesignerActionList。 两者都相当简单。

ControlDesigner：

public class MyUserControlDesigner : ControlDesigner
{

    private DesignerActionListCollection _actionLists;
    public override System.ComponentModel.Design.DesignerActionListCollection ActionLists
    {
        get
        {
            if (_actionLists == null)
            {
                _actionLists = new DesignerActionListCollection();
                _actionLists.Add(new MyUserControlActionList(this));
            }
            return _actionLists;
        }
    }
}

DesignerActionList：

public class MyUserControlActionList : DesignerActionList
{
    public MyUserControlActionList(MyUserControlDesigner designer) : base(designer.Component) { }

    public override DesignerActionItemCollection GetSortedActionItems()
    {
        DesignerActionItemCollection items = new DesignerActionItemCollection();
        items.Add(new DesignerActionPropertyItem("DockInParent", "Dock in parent"));
        return items;
    }

    public bool DockInParent
    {
        get
        {
            return ((MyUserControl)base.Component).Dock == DockStyle.Fill;
        }
        set
        {
            TypeDescriptor.GetProperties(base.Component)["Dock"].SetValue(base.Component, value ? DockStyle.Fill : DockStyle.None);
        }
    }    
}

最后，您需要将设计器附加到您的控件：

[Designer("NamespaceName.MyUserControlDesigner, AssemblyContainingTheDesigner")]
public partial class MyUserControl : UserControl
{
    // all the code for your control

简要说明

该控件有一个与其关联的 Designer 属性，该属性指出我们的自定义设计师。 该设计器中唯一的自定义是公开的DesignerActionList。 它创建我们的自定义操作列表的实例并将其添加到公开的操作列表集合中。

自定义操作列表包含一个 bool 属性 (DockInParent)，并为该属性创建一个操作项。 如果正在编辑的组件的 Dock 属性为 DockStyle.Fill，则该属性本身将返回 true，否则返回 false ，如果 DockInParent 设置为 true，则组件的 Dock 属性设置为 DockStyle.Fill，否则DockStyle.None。

这将在设计器中靠近控件右上角的位置显示一个小“操作箭头”，单击该箭头将弹出任务菜单。

Answer 3

如果您的控件继承自UserControl（或大多数其他可用控件），则只需将Dock 属性设置为DockStyle.Fill。