CustomTaskPane الواجهة
يمثل مخصص جزء المهام في تطبيق Microsoft المكتب 2010 Suite.
مساحة الاسم: Microsoft.Office.Tools
التجميع: Microsoft.Office.Tools.Common (في Microsoft.Office.Tools.Common.dll)
بناء الجملة
'إقرار
<GuidAttribute("881b42fd-484d-4494-8500-779de4e4aac1")> _
Public Interface CustomTaskPane _
Inherits IDisposable
[GuidAttribute("881b42fd-484d-4494-8500-779de4e4aac1")]
public interface CustomTaskPane : IDisposable
ملاحظات
استخدام CustomTaskPaneالكائن في المستوى تطبيق إضافة-بتعديل جزء مهام مخصص، أو الاستجابة عند الموقع أو رؤية التغييرات جزء المهام المخصص. تقوم أجزاء المهام واجهة مستخدم اللوحات التي يتم إرساء عادة على جانب واحد من نافذة برنامج تطبيق. لمعلومات حول كيفية إلى إنشاء cusإلىm أجزاء المهام، راجع نظرة عامة على أجزاء المهام المخصصة.
إلى التحكم في الحجم أو الموقع جزء المهام cusإلىm، يمكنك استخدام الخصائص مثل Height، Width، و Visible.
إلى استجابة عند cusإلىm جزء المهام بنقل أو تغيير رؤية، يمكنك معالجة DockPositionChangedو VisibleChangedالأحداث.
ملاحظة
يتم تطبيق هذه الواجهة بواسطة 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، وأنه يقوم بتعريف معالج حدث DockPositionChangedالحدث. إلى ترجمة هذا المثال، قم بنسخ التعليمة البرمجية في إلى ThisAddInالفئة في مشروع الوظيفة الإضافية لأحد التطبيقات التي تدعم أجزاء المهام cusإلىm. استبدال افتراضي ThisAddIn_Startupأسلوب في ThisAddInلفئة باستخدام ThisAddIn_Startupأسلوب في هذا المثال. يفترض هذا المثال أيضا أن يحتوي مشروع على UserControlباسم MyUserControl، و UserControlيحتوي على FlowLayoutPanelباسم FlowPanel.
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 Sub myCustomTaskPane_DockPositionChanged(ByVal sender As Object, _
ByVal e As EventArgs) Handles myCustomTaskPane.DockPositionChanged
Dim taskPane As Microsoft.Office.Tools.CustomTaskPane = _
TryCast(sender, Microsoft.Office.Tools.CustomTaskPane)
If taskPane IsNot Nothing Then
' Adjust sizes of user control and flow panel to fit current task pane size.
Dim userControl As MyUserControl = TryCast(taskPane.Control, MyUserControl)
Dim paneSize As System.Drawing.Size = _
New System.Drawing.Size(taskPane.Width, taskPane.Height)
userControl.Size = paneSize
userControl.FlowPanel.Size = paneSize
' Adjust flow direction of controls on the task pane.
If taskPane.DockPosition = _
Office.MsoCTPDockPosition.msoCTPDockPositionTop Or _
taskPane.DockPosition = _
Office.MsoCTPDockPosition.msoCTPDockPositionBottom Then
userControl.FlowPanel.FlowDirection = _
System.Windows.Forms.FlowDirection.LeftToRight
Else
userControl.FlowPanel.FlowDirection = _
System.Windows.Forms.FlowDirection.TopDown
End If
End If
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);
}
private void myCustomTaskPane_DockPositionChanged(object sender, EventArgs e)
{
Microsoft.Office.Tools.CustomTaskPane taskPane =
sender as Microsoft.Office.Tools.CustomTaskPane;
if (taskPane != null)
{
// Adjust sizes of user control and flow panel to fit current task pane size.
MyUserControl userControl = taskPane.Control as MyUserControl;
System.Drawing.Size paneSize = new System.Drawing.Size(taskPane.Width, taskPane.Height);
userControl.Size = paneSize;
userControl.FlowPanel.Size = paneSize;
// Adjust flow direction of controls on the task pane.
if (taskPane.DockPosition ==
Office.MsoCTPDockPosition.msoCTPDockPositionTop ||
taskPane.DockPosition ==
Office.MsoCTPDockPosition.msoCTPDockPositionBottom)
{
userControl.FlowPanel.FlowDirection =
System.Windows.Forms.FlowDirection.LeftToRight;
}
else
{
userControl.FlowPanel.FlowDirection =
System.Windows.Forms.FlowDirection.TopDown;
}
}
}
راجع أيضًَا
المرجع
Microsoft.Office.Tools مساحة الاسم
موارد أخرى
الحصول على الوظائف الإضافية يبدأ برمجة التطبيقات ذات المستوى
نظرة عامة على أجزاء المهام المخصصة
إدارة أجزاء المهام المخصصة في Windows التطبيقات متعددة