VSTO Outlook：无法通过编程方式设置自定义任务窗格高度

尝试通过编程方式设置自定义任务窗格的高度，在Visual Studio调试模式下，设置高度（如140）后，实际高度变为未知来源的80，而非设定值。

自定义任务窗格初始化代码如下：

this.myUserControl = new myUserControl();
this.myCustomTaskPane = Globals.ThisAddIn.CustomTaskPanes.Add(this.myUserControl, Properties.Resources.myText, this.Window);
this.myCustomTaskPane.DockPosition = Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop;
this.myCustomTaskPane.DockPositionRestrict = Microsoft.Office.Core.MsoCTPDockPositionRestrict.msoCTPDockPositionRestrictNoChange;
this.myCustomTaskPane.Height = 120;
this.myCustomTaskPane.Visible = false;

后续修改高度的代码为：

this.myCustomTaskPane.Height = 140;

请问为何会出现这种忽略设定值的情况？如何将自定义任务窗格高度设置为用户控件的高度？

问题原因 #

• UserControl布局参数限制：Office自定义任务窗格的高度会受内部UserControl的MinimumSize或默认尺寸影响。如果你的myUserControl默认最小高度为80，Office会强制将任务窗格高度限制在该值，覆盖你设置的数值。
• Visible属性时机问题：初始化时先设置高度再设Visible=false，后续修改高度时若任务窗格仍不可见，Office不会立即应用新高度，直到控件可见时读取UserControl的布局参数，导致设置被覆盖。
• DockPositionRestrict的作用范围：该属性仅限制用户手动调整任务窗格位置，不影响Office内部布局逻辑对高度的自动修正。

解决方法 #

方法1：先配置UserControl尺寸，再关联任务窗格 #

在创建任务窗格前，明确设置UserControl的高度或最小高度，让Office读取到正确的尺寸基准：

this.myUserControl = new myUserControl();
// 设置UserControl的固定高度及最小高度
this.myUserControl.Height = 140;
this.myUserControl.MinimumSize = new Size(0, 140);
// 后续创建任务窗格及配置保持不变
this.myCustomTaskPane = Globals.ThisAddIn.CustomTaskPanes.Add(this.myUserControl, Properties.Resources.myText, this.Window);
this.myCustomTaskPane.DockPosition = Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop;
this.myCustomTaskPane.DockPositionRestrict = Microsoft.Office.Core.MsoCTPDockPositionRestrict.msoCTPDockPositionRestrictNoChange;
this.myCustomTaskPane.Visible = false;

方法2：修改高度时确保任务窗格可见 #

若需在任务窗格不可见时修改高度，可先临时设置可见再调整，之后恢复原状态：

bool originalVisible = this.myCustomTaskPane.Visible;
// 临时显示任务窗格以应用高度设置
if (!originalVisible)
{
    this.myCustomTaskPane.Visible = true;
}
this.myCustomTaskPane.Height = 140;
// 恢复原可见状态
if (!originalVisible)
{
    this.myCustomTaskPane.Visible = false;
}

方法3：同步任务窗格与UserControl高度 #

让任务窗格高度始终跟随UserControl的实际高度，可绑定SizeChanged事件：

// 初始化时绑定事件
this.myUserControl.SizeChanged += (sender, e) =>
{
    if (this.myCustomTaskPane != null)
    {
        this.myCustomTaskPane.Height = this.myUserControl.Height;
    }
};

内容的提问来源于stack exchange，提问作者Willy