ControlExtensions.AddMonthCalendar 方法

定義

多載

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 執行個體的 ControlCollection 控制項中。

例外狀況

名稱或範圍引數為 null,或者名稱引數的長度為 0。

具有相同名稱的控制項已經存在於 ControlCollection 執行個體中。

指定的範圍無效。 無法使用多區域範圍。 範圍必須放在和 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 執行個體的 ControlCollection 控制項中。

例外狀況

名稱引數為 null,或者長度為 0。

具有相同名稱的控制項已經存在於 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 方法。

適用於