ControlExtensions.AddMonthCalendar Metoda

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Excel

Zestaw:

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

Przeciążenia

AddMonthCalendar(ControlCollection, Range, String)	Dodaje nową MonthCalendar kontrolkę do arkusza w określonym zakresie.
AddMonthCalendar(ControlCollection, Double, Double, Double, Double, String)	Dodaje nową MonthCalendar kontrolkę do arkusza w określonym rozmiarze i lokalizacji.

AddMonthCalendar(ControlCollection, Range, String)

Dodaje nową MonthCalendar kontrolkę do arkusza w określonym zakresie.

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

Zbiór, do którego należy dodać formant. Nie należy samodzielnie dostarczać parametru. Po wywołaniu tej metody w kolekcji zwróconej przez Controls właściwość (w projekcie na poziomie aplikacji) lub Controls właściwości (w projekcie na poziomie dokumentu) ten parametr jest dostarczany automatycznie.

range

Range

Element Range , który zapewnia granice dla kontrolki.

name

String

Nazwa kontrolki, która może służyć do indeksowania kontrolki w wystąpieniu ControlCollection .

Zwraca

MonthCalendar

Kontrolka MonthCalendar , która została dodana do ControlCollection wystąpienia.

Wyjątki

ArgumentNullException

Argument nazwy lub zakresu to null, lub argument nazwy ma zerową długość.

ControlNameAlreadyExistsException

Kontrolka o tej samej nazwie jest już w wystąpieniu ControlCollection .

InvalidRangeException

Określony zakres jest nieprawidłowy. Nie można użyć zakresów wielu obszarów. Zakres powinien znajdować się w tym samym arkuszu ControlCollection co wystąpienie.

Przykłady

Poniższy przykład kodu dodaje kontrolkę MonthCalendar do komórek A1 do C10, a następnie ustawia FirstDayOfWeek właściwość na poniedziałek. Aby użyć tego przykładu Sheet1 , uruchom go z klasy w projekcie na poziomie 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

Uwagi

Metoda AddMonthCalendar umożliwia dodawanie MonthCalendar obiektów na końcu obiektu ControlCollection. Aby usunąć kontrolkę MonthCalendar , która została wcześniej dodana programowo, użyj Remove metody . Kontrolka automatycznie zmienia rozmiar po zmianie rozmiaru zakresu.

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

Dodaje nową MonthCalendar kontrolkę do arkusza w określonym rozmiarze i lokalizacji.

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

Zbiór, do którego należy dodać formant. Nie należy samodzielnie dostarczać parametru. Po wywołaniu tej metody w kolekcji zwróconej przez Controls właściwość (w projekcie na poziomie aplikacji) lub Controls właściwości (w projekcie na poziomie dokumentu) ten parametr jest dostarczany automatycznie.

left

Double

Odległość między lewą krawędzią kontrolki a lewą krawędzią arkusza.

top

Double

Odległość między górną krawędzią kontrolki a górną krawędzią arkusza.

width

Double

Szerokość formantu w punktach.

height

Double

Wysokość formantu w punktach.

name

String

Nazwa formantu.

Zwraca

MonthCalendar

Kontrolka MonthCalendar , która została dodana do ControlCollection wystąpienia.

Wyjątki

ArgumentNullException

Argument nazwy to null lub ma zerową długość.

ControlNameAlreadyExistsException

Kontrolka o tej samej nazwie jest już w wystąpieniu ControlCollection .

Przykłady

Poniższy przykład kodu dodaje kontrolkę MonthCalendar do góry arkusza, a następnie ustawia FirstDayOfWeek właściwość na poniedziałek. Aby użyć tego przykładu Sheet1 , uruchom go z klasy w projekcie na poziomie 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

Uwagi

Metoda AddMonthCalendar umożliwia dodawanie MonthCalendar obiektów na końcu obiektu ControlCollection. Aby usunąć kontrolkę MonthCalendar , która została wcześniej dodana programowo, użyj Remove metody .