Sdílet prostřednictvím


ControlCollection.AddMonthCalendar-Methode (Range, String) (2007 System)

Aktualisiert: November 2007

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

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v9.0 (in Microsoft.Office.Tools.Excel.v9.0.dll)

Syntax

'Declaration
Public Function AddMonthCalendar ( _
    range As Range, _
    name As String _
) As MonthCalendar
'Usage
Dim instance As ControlCollection
Dim range As Range
Dim name As String
Dim returnValue As MonthCalendar

returnValue = instance.AddMonthCalendar(range, _
    name)
public MonthCalendar AddMonthCalendar(
    Range range,
    string name
)

Parameter

Rückgabewert

Typ: Microsoft.Office.Tools.Excel.Controls.MonthCalendar

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

Ausnahmen

Ausnahme Bedingung
ArgumentNullException

Das Argument für den Namen oder den Bereich ist nullNULL-Verweis (Nothing in Visual Basic), 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.

Hinweise

Mithilfe der AddMonthCalendar-Methode können Sie MonthCalendar-Objekte am Ende der ControlCollection hinzufügen. Um ein MonthCalendar-Steuerelement zu entfernen, das zuvor programmgesteuert hinzugefügt wurde, verwenden Sie die Remove()-Methode. Die Größe des Steuerelements wird automatisch geändert, wenn sich die Größe des Bereichs ändert.

Beispiele

Im folgenden Codebeispiel wird den Zellen A1 bis C10 ein MonthCalendar-Steuerelement hinzugefügt, und dann wird die FirstDayOfWeek-Eigenschaft auf Monday festgelegt.

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
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;
}

Berechtigungen

Siehe auch

Referenz

ControlCollection-Klasse

ControlCollection-Member

AddMonthCalendar-Überladung

Microsoft.Office.Tools.Excel-Namespace