CustomTaskPaneCollection الواجهة

مقالة
09/21/2010

يمثل مجموعة من أجزاء المهام المخصصة في Microsoft المكتب التطبيق.

مساحة الاسم: Microsoft.Office.Tools
التجميع: Microsoft.Office.Tools.Common (في Microsoft.Office.Tools.Common.dll)

بناء الجملة

'إقرار
<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الكائن في المستوى تطبيق إضافة-في ل إضافة جزء مهام مخصص لتطبيق ما، قم بإزالة جزء مهام مخصص أو الوصول موجودة المهام المخصصة جزء. الوصول إلى CustomTaskPaneCollectionكائن، تستخدم CustomTaskPanesالحقل من ThisAddInالفئة في الخاص بك الوظيفة الإضافية في مشروع. لمزيد من المعلومات، راجع برمجة تطبيق مستوى والوظائف الإضافية.

تقوم أجزاء المهام واجهة مستخدم اللوحات التي يتم إرساء عادة على جانب واحد من نافذة برنامج تطبيق. لمزيد من المعلومات حول كيفية إلى إنشاء cusإلىm أجزاء المهام، راجع نظرة عامة على أجزاء المهام المخصصة.

ملاحظة

يتم تطبيق هذه الواجهة بواسطة Visual Studio Tools لوقت تشغيل Office. ولم يتم تصميمها لتطبيقها في التعليمة البرمجية الخاصة بك. لمزيد من المعلومات، راجع أدوات Visual Studio نظرة عامة وقت تشغيل Office.

الاستخدام

توضح هذه الوثائق الإصدار الخاص بهذا النوع المستخدم في مشاريع Office والذي يستهدف .NET Framework 4. وفي المشاريع التي تستهدف .NET Framework 3.5، قد يكون لدى هذا النوع أعضاء مختلفون وقد لا تعمل نماذج التعليمات البرمجية الخاصة بهذا النوع. للحصول على وثائق حول هذا النوع في المشاريع التي تستهدف .NET Framework 3.5، اطلع على جزء المرجع التالي في وثائق Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

أمثلة

يوضح مثال التعليمة البرمجية التالية كيف إلى إنشاء جزء مهام cusإلىm باستخدام Add(UserControl, String)الأسلوب. يستخدم المثال أيضا خصائص CustomTaskPaneالكائن إلى تعديل المظهر الافتراضي لجزء المهمة cusإلىm. هذا المثال تعليمات برمجية جزء من بقعة صغيرة مثال عن توفير 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);
}