CustomTaskPaneCollection Arabirim

Makale
08/01/2011

Bir Microsoft Office uygulamasında özel görev bölmeleri topluluğu 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 bir dizin.

Üst

Yöntemler

	Ad	Açıklama
	Add(UserControl, String)	Yeni bir oluşturur CustomTaskPane Geçerli ekler ve CustomTaskPaneCollection.Özel görev bölmesini temel üzerinde belirtilen UserControl ve belirtilen bir başlık.
	Add(UserControl, String, Object)	Yeni bir oluşturur CustomTaskPane Geçerli ekler ve CustomTaskPaneCollection.Özel görev bölmesini temel üzerinde belirtilen UserControl, belirtilen başlık ve ilişkilendirilmiş belirtilen uygulama penceresi.
	BeginInit	Altyapı.
	Dispose	Boşaltma, serbest bırakma veya yönetilmeyen kaynakları sıfırlama ile ilişkilendirilmiş 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ı.)
	GetEnumerator()	Bir Numaralandırıcı topluluk içinde yineleme döndürür. (IEnumerable kaynağından devralındı.)
	Remove	Belirtilen kaldırır CustomTaskPane dan CustomTaskPaneCollection.
	RemoveAt	Kaldırır CustomTaskPane belirtilen dizin adresindeki CustomTaskPaneCollection.

Üst

Açıklamalar

Use CustomTaskPaneCollection nesnesi içinde bir uygulama düzeyi eklemek, bir uygulama için bir özel görev bölmesini ekleme, kaldırma bir özel görev bölmesini veya erişim bir varolan özel görev bölmesi. Access CustomTaskPaneCollection nesnesini, kullanmak CustomTaskPanes alanının ThisAddIn class eklenti projesi. Daha fazla bilgi için bkz. Uygulama Düzeyi Eklentileri Programlama.

Görev bölmeleri, genellikle bir uygulama penceresinin bir tarafında yuvaya kullanıcı arabirimi panellerini sunulmuştur. Özel görev bölmeleri oluşturma hakkında daha fazla bilgi için bkz: Özel Görev Bölmelerine Genel Bakış.

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 için Visual Studio Araçları Çalışma Zamanına Genel Bakış.

Kullanım

Bu belgelerde, .NET Framework 4'ü hedefleyen projelerde 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, bir özel görev bölmesini kullanarak oluşturmak gösterilmiştir Add(UserControl, String) yöntemi. Örnek özelliklerini de kullanır CustomTaskPane nesne değiştirme varsayılan görünümünü özel görev bölmesi. Bu kod örneği için sağlanan büyük bir örnek bir 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);
}