ControlExtensions.AddMonthCalendar Methode

Definition

Namespace:

Microsoft.Office.Tools.Excel

Assembly:

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

Überlädt

AddMonthCalendar(ControlCollection, Range, String)	Fügt dem Arbeitsblatt im angegebenen Bereich ein neues MonthCalendar-Steuerelement hinzu.
AddMonthCalendar(ControlCollection, Double, Double, Double, Double, String)	Fügt dem Arbeitsblatt an der angegebenen Position ein neues MonthCalendar-Steuerelement in der angegebenen Größe hinzu.

AddMonthCalendar(ControlCollection, Range, String)

Fügt dem Arbeitsblatt im angegebenen Bereich ein neues MonthCalendar-Steuerelement hinzu.

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

Parameter

controls

ControlCollection

Die Auflistung, der das Steuerelement hinzugefügt werden soll. Geben Sie diesen Parameter nicht selbst an. Wenn Sie diese Methode für die von der Controls-Eigenschaft (in einem Projekt auf Anwendungsebene) oder von der Controls-Eigenschaft (in einem Projekt auf Dokumentebene) zurückgegebene Auflistung aufrufen, wird dieser Parameter automatisch angegeben.

range

Range

Ein Range, der die Begrenzungen des Steuerelements angibt.

name

String

Der Name des Steuerelements, der zum Indizieren des Steuerelements in der ControlCollection-Instanz verwendet werden kann.

Gibt zurück

MonthCalendar

Das MonthCalendar-Steuerelement, das der ControlCollection-Instanz hinzugefügt wurde.

Ausnahmen

ArgumentNullException

Das Argument für den Namen oder den Bereich ist null, oder das Argument für den Namen hat die Länge 0 (null).

ControlNameAlreadyExistsException

Ein Steuerelement mit dem gleichen Namen ist bereits in der ControlCollection-Instanz vorhanden.

InvalidRangeException

Der angegebene Bereich ist nicht gültig. Bereiche, die mehrere Bereiche enthalten, können nicht verwendet werden. Der Bereich muss sich auf dem gleichen Arbeitsblatt wie die ControlCollection-Instanz befinden.

Beispiele

Im folgenden Codebeispiel wird ein MonthCalendar Steuerelement zu den Zellen A1 bis C10 hinzugefügt, und die Eigenschaft wird dann auf Monday festgelegt FirstDayOfWeek . Um dieses Beispiel zu verwenden, führen Sie es in der Sheet1 -Klasse in einem Projekt auf Dokumentebene aus.

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

Hinweise

Mit AddMonthCalendar der -Methode können Sie Objekte am Ende von ControlCollectionhinzufügenMonthCalendar. Verwenden Sie die -Methode, um ein MonthCalendar Steuerelement zu entfernen, das Remove zuvor programmgesteuert hinzugefügt wurde. Das Steuerelement ändert die Größe automatisch, wenn die Größe des Bereichs geändert wird.

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

Fügt dem Arbeitsblatt an der angegebenen Position ein neues MonthCalendar-Steuerelement in der angegebenen Größe hinzu.

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

Parameter

controls

ControlCollection

Die Auflistung, der das Steuerelement hinzugefügt werden soll. Geben Sie diesen Parameter nicht selbst an. Wenn Sie diese Methode für die von der Controls-Eigenschaft (in einem Projekt auf Anwendungsebene) oder von der Controls-Eigenschaft (in einem Projekt auf Dokumentebene) zurückgegebene Auflistung aufrufen, wird dieser Parameter automatisch angegeben.

left

Double

Die Entfernung zwischen dem linken Rand des Steuerelements und dem linken Rand des Arbeitsblatts in Punkt.

top

Double

Die Entfernung zwischen dem oberen Rand des Steuerelements und dem oberen Rand des Arbeitsblatts in Punkt.

width

Double

Die Breite des Steuerelements in Punkt.

height

Double

Die Höhe des Steuerelements in Punkt.

name

String

Der Name des Steuerelements.

Gibt zurück

MonthCalendar

Das MonthCalendar-Steuerelement, das der ControlCollection-Instanz hinzugefügt wurde.

Ausnahmen

ArgumentNullException

Das Argument für den Namen ist null oder hat die Länge 0 (null).

ControlNameAlreadyExistsException

Ein Steuerelement mit dem gleichen Namen ist bereits in der ControlCollection-Instanz vorhanden.

Beispiele

Im folgenden Codebeispiel wird oben auf dem Arbeitsblatt ein MonthCalendar Steuerelement hinzugefügt, und die Eigenschaft wird dann auf Montag festgelegt FirstDayOfWeek . Um dieses Beispiel zu verwenden, führen Sie es in der Sheet1 -Klasse in einem Projekt auf Dokumentebene aus.

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

Hinweise

Mit AddMonthCalendar der -Methode können Sie Objekte am Ende von ControlCollectionhinzufügenMonthCalendar. Verwenden Sie die -Methode, um ein MonthCalendar Steuerelement zu entfernen, das Remove zuvor programmgesteuert hinzugefügt wurde.