CustomTaskPane.Height الخاصية

الحصول أو تعيين ارتفاع جزء مهام مخصص، في نقاط.

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

بناء الجملة

'إقرار
Property Height As Integer
    Get
    Set

int Height { get; set; }

قيمة الخاصية

النوع: System.Int32
ارتفاع جزء المهام المخصص، في نقاط.

استثناءات

استثناء:	شرط
COMException	الالقيمة DockPositionخاصية هو Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRightأو Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeftعند محاولة تعيين Heightخاصية. -أو- حاولت إلى تعيين Heightخاصية في معالج الأحداث الخاص DockPositionChangedأو VisibleChangedحدث.
ObjectDisposedException	Dispose()طريقة CustomTaskPaneلقد تم استدعاء.

ملاحظات

لا تستخدم Heightالخاصية إذا كان جزء مهام مخصصة هو رأسي يسار أو يمين من نافذة مستند. إذا DockPositionخاصية هو Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRightأو Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft، Heightخاصية بإرجاع 0 ويطرح COMExceptionإذا حاولت تعيين it.

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

الحد الأدنى لارتفاع يعتمد تشغيل عدة عوامل، ويمكن تشغيل تغيير الإصدارات المستقبلية من Microsoft المكتب. إذا حاولت تعيين Heightبالقيمة خاصية التي هو أصغر من من إعادة الحد الأدنى لارتفاع، تطبيق سيتم تلقائياً تعيين Heightخاصية إلى ارتفاع الحد الأدنى.

أمثلة

يلي تعليمات برمجية المثال، يتم إنشاء جزء مهام مخصص له ارتفاع معين عند عرض أمام إطار تطبيق النشط. هذا المثال تعليمات برمجية جزء من بقعة صغيرة مثال عن توفير 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.

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

راجع أيضًَا

المرجع

CustomTaskPane واجهة

CustomTaskPane الأعضاء

Microsoft.Office.Tools مساحة الاسم