CustomTaskPaneCollection.Add أسلوب (UserControl, String)

مقالة
09/21/2010

قم بإنشاء جديد CustomTaskPaneو يضيفه إلى الحالي CustomTaskPaneCollection. جزء المهام المخصص هو استناداً إلى المعين UserControlوتحتوي تشغيل عنوان المحدد.

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

بناء الجملة

'إقرار
Function Add ( _
    control As UserControl, _
    title As String _
) As CustomTaskPane

CustomTaskPane Add(
    UserControl control,
    string title
)

المعلمات

control
النوع: System.Windows.Forms.UserControl
UserControlالذي يوفر واجهة مستخدم المخصصة الجديدة جزء المهام.

title
النوع: System.String
نص الذي يظهر في شريط عنوان مخصص جديد جزء المهام.

القيمة المُرجعة

النوع: Microsoft.Office.Tools.CustomTaskPane
CustomTaskPaneالذي يمثل مخصص جديد جزء المهام.

استثناءات

استثناء:	شرط
ArgumentNullException	controlأوtitleهوnullمرجع خالٍ (لا شيء في Visual Basic).
ObjectDisposedException	Dispose()أسلوب لقد تم استدعاء تشغيل CustomTaskPaneCollection.

ملاحظات

استخدام ترتيب هو الأسلوب لإنشاء جديد CustomTaskPaneالتي هو المقترنة بنافذة نشطة لتطبيق Microsoft المكتب 2010 Suite.

على الرغم من أن CustomTaskPaneCollectionالكائن هو مجموعة من CustomTaskPaneالكائنات، Addالأسلوب يقبل UserControlالكائنات بدلاً من CustomTaskPaneالكائنات. لمزيد من المعلومات، راجع نظرة عامة على أجزاء المهام المخصصة.

إذا كنت تريد إلى تحديد نافذة معين وربط جزء المهام cusإلىm معه، استخدم Add(UserControl, String, Object)الأسلوب.

أمثلة

يوضح مثال التعليمة البرمجية التالية كيف إلى إنشاء جزء مهام 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);
}

أمن NET Framework.

الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.