CustomTaskPane.DockPosition Свойство

Определение

Пространство имен:

Microsoft.Office.Tools

Сборки:

Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll, Microsoft.Office.Tools.Outlook.v4.0.Utilities.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Возвращает или задает значение, которое указывает, где находится настраиваемая область задач относительно окна приложения.

public:
 property Microsoft::Office::Core::MsoCTPDockPosition DockPosition { Microsoft::Office::Core::MsoCTPDockPosition get(); void set(Microsoft::Office::Core::MsoCTPDockPosition value); };

public Microsoft.Office.Core.MsoCTPDockPosition DockPosition { get; set; }

member this.DockPosition : Microsoft.Office.Core.MsoCTPDockPosition with get, set

Public Property DockPosition As MsoCTPDockPosition

Значение свойства

MsoCTPDockPosition

Одно из значений Microsoft.Office.Core.MsoCTPDockPosition. Значение по умолчанию — Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight.

Исключения

ObjectDisposedException

Метод Microsoft.Office.Tools.CustomTaskPane.Dispose объекта CustomTaskPane уже вызван.

COMException

Значение DockPositionRestrict свойства — Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRestrictNoChange при попытке изменить значение DockPosition свойства.-or-You try to set this property in the event handler for the DockPositionChanged or VisibleChanged event.

Примеры

В следующем примере кода создается настраиваемая область задач и настраиваются различные размеры по умолчанию для отображения панели перед активным окном приложения и при закреплении. Этот пример кода является частью более крупного примера, предоставленного для CustomTaskPane.

private MyUserControl myUserControl1;
private Microsoft.Office.Tools.CustomTaskPane myCustomTaskPane;

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    myUserControl1 = new MyUserControl();
    myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1,
        "New Task Pane");

    myCustomTaskPane.DockPosition =
        Office.MsoCTPDockPosition.msoCTPDockPositionFloating;
    myCustomTaskPane.Height = 500;
    myCustomTaskPane.Width = 500;

    myCustomTaskPane.DockPosition =
        Office.MsoCTPDockPosition.msoCTPDockPositionRight;
    myCustomTaskPane.Width = 300;

    myCustomTaskPane.Visible = true;
    myCustomTaskPane.DockPositionChanged +=
        new EventHandler(myCustomTaskPane_DockPositionChanged);
}

Private myUserControl1 As MyUserControl
Private WithEvents myCustomTaskPane As Microsoft.Office.Tools.CustomTaskPane

Private Sub ThisAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Startup

    myUserControl1 = New MyUserControl()
    myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl1, "New Task Pane")

    With myCustomTaskPane
        .DockPosition = Office.MsoCTPDockPosition.msoCTPDockPositionFloating
        .Height = 500
        .Width = 500
        .DockPosition = Office.MsoCTPDockPosition.msoCTPDockPositionRight
        .Width = 300
        .Visible = True
    End With
End Sub

Комментарии

В следующей таблице перечислены значения перечисления Microsoft.Office.Core.MsoCTPDockPosition .

Значение	Описание
msoCTPDockPositionLeft	Закрепляет настраиваемую область задач в левой части окна.
msoCTPDockPositionTop	Закрепляет настраиваемую область задач в верхней части окна.
msoCTPDockPositionRight	Закрепляет настраиваемую область задач в правой части окна.
msoCTPDockPositionBottom	Закрепляет настраиваемую область задач в нижней части окна.
msoCTPDockPositionFloating	Отображает настраиваемую область задач перед окном. Пользователь может перетащить область задач в любое место в окне.