CustomTaskPaneCollection Arabirim

Makale
02/17/2014

Bir Microsoft Office uygulamasında özel görev bölmeleri koleksiyonunu temsil eder.

Ad alanı: Microsoft.Office.Tools
Derleme: Microsoft.Office.Tools.Common (Microsoft.Office.Tools.Common.dll içinde)

Sözdizimi

'Bildirim
<GuidAttribute("c3a84bf1-e95b-4d23-952d-59e35673958e")> _
Public Interface CustomTaskPaneCollection _
    Inherits IEnumerable(Of CustomTaskPane), IEnumerable, IDisposable

[GuidAttribute("c3a84bf1-e95b-4d23-952d-59e35673958e")]
public interface CustomTaskPaneCollection : IEnumerable<CustomTaskPane>, 
    IEnumerable, IDisposable

CustomTaskPaneCollection türü aşağıdaki üyeleri ortaya koyar.

Özellikler

	Ad	Açıklama
	Count	Sayısını alır CustomTaskPane geçerli veritabanındaki nesneleri CustomTaskPaneCollection.
	Item	Alır CustomTaskPane belirtilen dizindeki.

Üst

Yöntemler

	Ad	Açıklama
	Add(UserControl, String)	Yeni bir oluşturur CustomTaskPane ve geçerli ekler CustomTaskPaneCollection.Özel görev bölmesini temel üzerinde belirtilen UserControl ve belirtilen başlığa sahip.
	Add(UserControl, String, Object)	Yeni bir oluşturur CustomTaskPane ve geçerli ekler CustomTaskPaneCollection.Özel görev bölmesini temel üzerinde belirtilen UserControl, belirtilen başlığa sahip ve belirtilen uygulama penceresiyle ilişkilendirilir.
	BeginInit	Altyapı.
	Dispose	Yönetilmeyen kaynakları boşaltma, serbest bırakma veya sıfırlama ile ilişkili uygulama tanımlı görevleri gerçekleştirir. (IDisposable kaynağından devralındı.)
	EndInit	Altyapı.
	GetEnumerator	Bir Numaralandırıcı topluluk içinde yineleme döndürür. (IEnumerable<CustomTaskPane> kaynağından devralındı.)
	Remove	Belirtilen kaldırır CustomTaskPane gelen CustomTaskPaneCollection.
	RemoveAt	Kaldırır CustomTaskPane belirtilen dizindeki CustomTaskPaneCollection.

Üst

Notlar

Kullanım CustomTaskPaneCollection uygulama düzeyi uygulamaya özel görev bölmesi ekleme, özel görev bölmesi kaldırmak veya varolan bir özel görev bölmesini erişmek için eklenti nesnesi.Erişim için CustomTaskPaneCollection nesne, kullanın CustomTaskPanes alanı ThisAddIn sınıfı projenizdeki eklentisi.Daha fazla bilgi için bkz. Uygulama Düzeyi Eklentileri Programlama.

Görev bölmeleri, genellikle uygulama penceresinin bir tarafına yerleştirilmiş kullanıcı arabirimi panelleridir.Özel görev bölmelerini oluşturma hakkında daha fazla bilgi için bkz: Özel Görev Bölmeleri.

[!NOT]

Bu arabirim, Office için Visual Studio Araçları çalışma zamanı modülü tarafından uygulanır. Kodunuzda gerçekleştirilmesi amaçlanmamıştır. Daha fazla bilgi için bkz. Office Çalışma Zamanı İçin Visual Studio Araçlarına Genel Bakış.

Kullanım

Bu belgelerde, .NET Framework 4 ve .NET Framework 4.5'i hedefleyen Office projelerinde kullanılan bu türün sürümü açıklanır. .NET Framework 3.5'i hedefleyen projelerde, bu türün üyeleri farklı olabilir ve bu tür için sağlanan kod örnekleri çalışmayabilir. .NET Framework 3.5'i hedefleyen projelerde bu tür hakkındaki belgeler için Visual Studio 2008 belgelerinde aşağıdaki başvuru bölümüne bakın: https://go.microsoft.com/fwlink/?LinkId=160658.

Örnekler

Aşağıdaki kod örneği kullanarak özel görev bölmesi oluşturmak nasıl gösterir Add(UserControl, String) yöntem.Örnek özelliklerini de kullanır CustomTaskPane özel görev bölmesini varsayılan görünümünü değiştirmek için nesne.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);
}