CustomTaskPane.Height Properti

Referensi

Definisi

Ruang nama:: Microsoft.Office.Tools

Rakitan:: Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll, Microsoft.Office.Tools.Outlook.v4.0.Utilities.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur tinggi panel tugas kustom, dalam poin.

public:
 property int Height { int get(); void set(int value); };

public int Height { get; set; }

member this.Height : int with get, set

Public Property Height As Integer

Nilai Properti

Int32

Tinggi panel tugas kustom, dalam titik.

Pengecualian

COMException

Nilai DockPosition properti adalah Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight atau Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft saat Anda mencoba mengatur Height properti.--atau-Anda mencoba mengatur Height properti di penanganan aktivitas untuk DockPositionChanged atau VisibleChanged kejadian.

ObjectDisposedException

Metode Microsoft.Office.Tools.CustomTaskPane.Dispose dari CustomTaskPane telah dipanggil.

Contoh

Contoh kode berikut membuat panel tugas kustom yang memiliki tinggi tertentu saat ditampilkan di depan jendela aplikasi aktif. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk CustomTaskPane.

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);
}

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

Keterangan

Jangan gunakan Height properti jika panel tugas kustom ditampar ke kiri atau kanan jendela dokumen. DockPosition Jika properti adalah Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight atau Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft, Height properti mengembalikan 0 dan melempar COMException jika Anda mencoba mengaturnya.

Tinggi maksimum tergantung pada posisi dermaga. Saat panel tugas kustom ditampung ke bagian atas atau bawah jendela dokumen, tinggi maksimum sekitar setengah dari tinggi layar. Saat panel tugas kustom mengambang, tidak ada tinggi maksimum.

Tinggi minimum tergantung pada beberapa faktor, dan dapat berubah dalam rilis Microsoft Office di masa mendatang. Jika Anda mencoba mengatur Height properti ke nilai yang kurang dari tinggi minimum, aplikasi akan secara otomatis menetapkan Height ulang properti ke tinggi minimum.

Berlaku untuk

Bagikan melalui