ControlExtensions.AddMonthCalendar Metoda

Definice

Obor názvů:

Microsoft.Office.Tools.Excel

Sestavení:

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

Přetížení

AddMonthCalendar(ControlCollection, Range, String)	Přidá do listu nový MonthCalendar ovládací prvek v zadaném rozsahu.
AddMonthCalendar(ControlCollection, Double, Double, Double, Double, String)	Přidá do listu nový MonthCalendar ovládací prvek v zadané velikosti a umístění.

AddMonthCalendar(ControlCollection, Range, String)

Přidá do listu nový MonthCalendar ovládací prvek v zadaném rozsahu.

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

Parametry

controls

ControlCollection

Kolekce, do které chcete přidat ovládací prvek. Nezadávejte tento parametr sami. Když zavoláte tuto metodu pro kolekci vrácenou Controls vlastností (v projektu na úrovni aplikace) nebo Controls vlastností (v projektu na úrovni dokumentu), je tento parametr zadán automaticky.

range

Range

A Range , který poskytuje hranice ovládacího prvku.

name

String

Název ovládacího prvku, který lze použít k indexování ovládacího prvku v ControlCollection instanci.

Návraty

MonthCalendar

Ovládací MonthCalendar prvek, který byl přidán do ControlCollection instance.

Výjimky

ArgumentNullException

Argument name nebo range je null, nebo argument name má nulovou délku.

ControlNameAlreadyExistsException

Ovládací prvek se stejným názvem se již v ControlCollection instanci nachází.

InvalidRangeException

Zadaný rozsah není platný. Rozsahy s více oblastmi nelze použít. Oblast by měla být na stejném listu jako ControlCollection instance.

Příklady

Následující příklad kódu přidá ovládací prvek MonthCalendar do buněk A1 až C10 a pak nastaví FirstDayOfWeek vlastnost na pondělí. Pokud chcete použít tento příklad, spusťte ho Sheet1 z třídy v projektu na úrovni dokumentu.

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

Poznámky

Metoda AddMonthCalendar umožňuje přidat MonthCalendar objekty na konec objektu ControlCollection. Pokud chcete odebrat MonthCalendar ovládací prvek, který byl dříve přidán programově, použijte metodu Remove . Při změně velikosti rozsahu ovládací prvek automaticky změní velikost.

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

Přidá do listu nový MonthCalendar ovládací prvek v zadané velikosti a umístění.

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

Parametry

controls

ControlCollection

Kolekce, do které chcete přidat ovládací prvek. Nezadávejte tento parametr sami. Když zavoláte tuto metodu pro kolekci vrácenou Controls vlastností (v projektu na úrovni aplikace) nebo Controls vlastností (v projektu na úrovni dokumentu), je tento parametr zadán automaticky.

left

Double

Vzdálenost v bodech mezi levým okrajem ovládacího prvku a levým okrajem listu

top

Double

Vzdálenost v bodech mezi horním okrajem ovládacího prvku a horním okrajem listu.

width

Double

Šířka ovládacího prvku v bodech

height

Double

Výška ovládacího prvku v bodech

name

String

Název ovládacího prvku

Návraty

MonthCalendar

Ovládací MonthCalendar prvek, který byl přidán do ControlCollection instance.

Výjimky

ArgumentNullException

Argument name je null nebo má nulovou délku.

ControlNameAlreadyExistsException

Ovládací prvek se stejným názvem se již v ControlCollection instanci nachází.

Příklady

Následující příklad kódu přidá ovládací prvek MonthCalendar do horní části listu a pak nastaví FirstDayOfWeek vlastnost na pondělí. Pokud chcete použít tento příklad, spusťte ho Sheet1 z třídy v projektu na úrovni dokumentu.

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

Poznámky

Metoda AddMonthCalendar umožňuje přidat MonthCalendar objekty na konec objektu ControlCollection. Pokud chcete odebrat MonthCalendar ovládací prvek, který byl dříve přidán programově, použijte metodu Remove .