ControlExtensions.AddMonthCalendar 方法

定义

命名空间:

Microsoft.Office.Tools.Excel

程序集:

Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

重载

AddMonthCalendar(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 MonthCalendar 控件。
AddMonthCalendar(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 MonthCalendar 控件。

AddMonthCalendar(ControlCollection, Range, String)

在工作表中的指定范围添加一个新的 MonthCalendar 控件。

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::Office::Tools::Excel::Controls::MonthCalendar ^ AddMonthCalendar(Microsoft::Office::Tools::Excel::ControlCollection ^ controls, Microsoft::Office::Interop::Excel::Range ^ range, System::String ^ name);

public static Microsoft.Office.Tools.Excel.Controls.MonthCalendar AddMonthCalendar(this Microsoft.Office.Tools.Excel.ControlCollection controls, Microsoft.Office.Interop.Excel.Range range, string name);

static member AddMonthCalendar : Microsoft.Office.Tools.Excel.ControlCollection * Microsoft.Office.Interop.Excel.Range * string -> Microsoft.Office.Tools.Excel.Controls.MonthCalendar

<Extension()>
Public Function AddMonthCalendar (controls As ControlCollection, range As Range, name As String) As MonthCalendar

参数

controls

ControlCollection

要添加控件的集合。 请勿自己提供此参数。 对 Controls 属性（在应用程序级项目中）或 Controls 属性（在文档级项目中）返回的集合调用此方法时，将自动提供此参数。

range

Range

提供控件的边界的 Range。

name

String

可用于索引 ControlCollection 实例中控件的控件名称。

返回

MonthCalendar

添加到 MonthCalendar 实例的 ControlCollection 控件。

例外

ArgumentNullException

名称参数或范围参数为 null，或者名称参数长度为零。

ControlNameAlreadyExistsException

ControlCollection 实例中已存在一个同名控件。

InvalidRangeException

指定的范围无效。 不能使用多区域范围。 该范围应与 ControlCollection 实例同在一个工作表中。

示例

下面的代码示例将 控件 MonthCalendar 添加到单元格 A1 到 C10，然后将 属性 FirstDayOfWeek 设置为 Monday。 若要使用此示例，请从文档级项目中的 Sheet1 类运行它。

private void ExcelRangeAddMonthCalendar()
{

    Microsoft.Office.Tools.Excel.Controls.MonthCalendar
         monthCalendar1 = this.Controls.AddMonthCalendar(
         this.Range["A1", "C10"], "monthCalendar1");
    monthCalendar1.FirstDayOfWeek = System.Windows.Forms.Day.Monday;
}

Private Sub ExcelRangeAddMonthCalendar()

    Dim MonthCalendar1 As Microsoft.Office.Tools. _
        Excel.Controls.MonthCalendar = Me.Controls. _
        AddMonthCalendar(Me.Range("A1", "C10"), _
        "MonthCalendar1")

    MonthCalendar1.FirstDayOfWeek = System.Windows. _
        Forms.Day.Monday

End Sub

注解

使用 AddMonthCalendar 方法可以将 对象添加到 MonthCalendar 的 ControlCollection末尾。 若要删除 MonthCalendar 以前以编程方式添加的控件，请使用 Remove 方法。 调整范围时，控件会自动调整大小。

AddMonthCalendar(ControlCollection, Double, Double, Double, Double, String)

按照指定的大小和位置向工作表添加一个新的 MonthCalendar 控件。

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::Office::Tools::Excel::Controls::MonthCalendar ^ AddMonthCalendar(Microsoft::Office::Tools::Excel::ControlCollection ^ controls, double left, double top, double width, double height, System::String ^ name);

public static Microsoft.Office.Tools.Excel.Controls.MonthCalendar AddMonthCalendar(this Microsoft.Office.Tools.Excel.ControlCollection controls, double left, double top, double width, double height, string name);

static member AddMonthCalendar : Microsoft.Office.Tools.Excel.ControlCollection * double * double * double * double * string -> Microsoft.Office.Tools.Excel.Controls.MonthCalendar

<Extension()>
Public Function AddMonthCalendar (controls As ControlCollection, left As Double, top As Double, width As Double, height As Double, name As String) As MonthCalendar

参数

controls

ControlCollection

要添加控件的集合。 请勿自己提供此参数。 对 Controls 属性（在应用程序级项目中）或 Controls 属性（在文档级项目中）返回的集合调用此方法时，将自动提供此参数。

left

Double

控件左边缘与工作表左边缘之间的距离（以磅为单位）。

top

Double

控件上边缘与工作表上边缘之间的距离（以磅为单位）。

width

Double

控件的宽度（以磅为单位）。

height

Double

控件的高度（以磅为单位）。

name

String

控件的名称。

返回

MonthCalendar

添加到 MonthCalendar 实例的 ControlCollection 控件。

例外

ArgumentNullException

名称参数为 null 或长度为零。

ControlNameAlreadyExistsException

ControlCollection 实例中已存在一个同名控件。

示例

下面的代码示例将 控件 MonthCalendar 添加到工作表的顶部，然后将 属性 FirstDayOfWeek 设置为 Monday。 若要使用此示例，请从文档级项目中的 Sheet1 类运行它。

private void ExcelAddMonthCalendar()
{

    Microsoft.Office.Tools.Excel.Controls.MonthCalendar
         monthCalendar1 = this.Controls.AddMonthCalendar(
         0, 0, 75, 15, "monthCalendar1");
    monthCalendar1.FirstDayOfWeek = System.Windows.Forms.Day.Monday;
}

Private Sub ExcelAddMonthCalendar()

    Dim MonthCalendar1 As Microsoft.Office.Tools. _
        Excel.Controls.MonthCalendar = Me.Controls. _
        AddMonthCalendar(0, 0, 75, 15, "MonthCalendar1")

    MonthCalendar1.FirstDayOfWeek = System.Windows. _
        Forms.Day.Monday

End Sub

注解

使用 AddMonthCalendar 方法可以将 对象添加到 MonthCalendar 的 ControlCollection末尾。 若要删除 MonthCalendar 以前以编程方式添加的控件，请使用 Remove 方法。