CustomTaskPane.DockPosition Özellik
Alır veya ilişkili uygulama penceresi özel görev bölmesini bulunduğu belirten bir değeri ayarlar.
Ad alanı: Microsoft.Office.Tools
Derleme: Microsoft.Office.Tools.Common (Microsoft.Office.Tools.Common.dll içinde)
Sözdizimi
'Bildirim
Property DockPosition As MsoCTPDockPosition
MsoCTPDockPosition DockPosition { get; set; }
Özellik Değeri
Tür: Microsoft.Office.Core.MsoCTPDockPosition
Microsoft.Office.Core.MsoCTPDockPosition değerlerinden biri.Varsayılan, Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight değeridir.
Özel Durumlar
Exception | Koşul |
---|---|
ObjectDisposedException | Dispose Yöntemi, CustomTaskPane zaten çağrıldı. |
COMException | Değeri DockPositionRestrict özelliği Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRestrictNoChange değeri değiştirmeye çalıştığınızda DockPosition özelliği. -veya- Bu özellik için olay işleyicisi ayarlamak deneyin DockPositionChanged veya VisibleChanged olay. |
Notlar
Aşağıdaki tablo değerleri listeler Microsoft.Office.Core.MsoCTPDockPosition numaralandırma.
Value |
Tanımlama |
---|---|
msoCTPDockPositionLeft |
Özel görev bölmesi pencerenin sol kenarına dayanır. |
msoCTPDockPositionTop |
Özel görev bölmesi pencerenin üst kısmına dayanır. |
msoCTPDockPositionRight |
Özel görev bölmesi pencerenin sağ tarafında dayanır. |
msoCTPDockPositionBottom |
Özel görev bölmesi pencerenin alt kısmına dayanır. |
msoCTPDockPositionFloating |
Pencerenin önünde özel görev bölmesini görüntüler.Kullanıcı görev bölmesinin pencerede istediğiniz yere sürükleyebilirsiniz. |
Örnekler
Aşağıdaki kod örneğinde özel görev bölmesi oluşturur ve bölmesi ve etkin uygulama penceresinin önünde yerleştirildiğinde, görüntüler, farklı varsayılan boyutları için yapılandırır.Bu kod örneği için sağlanan daha büyük bir örneğin parçasıdır CustomTaskPane.
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
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);
}
.NET Framework Güvenliği
- Anında arayanlar için tam güven. Bu üye kısmen güvenilen kodla kullanılamaz. Daha fazla bilgi için bkz. Kısmen Güvenilen Koddan Kitaplıkları Kullanma.