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
range
Typ: Microsoft.Office.Interop.Excel.RangeEin Range, der die Begrenzungen des Steuerelements angibt.
name
Typ: System.StringDer Name des Steuerelements, der zum Indizieren des Steuerelements in der ControlCollection-Instanz verwendet werden kann.
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
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.