CustomTaskPane.Height Properti
Definisi
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
Tinggi panel tugas kustom, dalam titik.
Pengecualian
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.
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.