ControlExtensions.AddMonthCalendar Méthode

Définition

Surcharges

AddMonthCalendar(ControlCollection, Range, String)

Ajoute un nouveau contrôle MonthCalendar à la feuille de calcul à la plage spécifiée.

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

Ajoute un nouveau contrôle MonthCalendar à la feuille de calcul selon la taille et l'emplacement spécifiés.

AddMonthCalendar(ControlCollection, Range, String)

Ajoute un nouveau contrôle MonthCalendar à la feuille de calcul à la plage spécifiée.

public static Microsoft.Office.Tools.Excel.Controls.MonthCalendar AddMonthCalendar (this Microsoft.Office.Tools.Excel.ControlCollection controls, Microsoft.Office.Interop.Excel.Range range, string name);

Paramètres

controls
ControlCollection

Collection à laquelle le contrôle doit être ajouté. Ne spécifiez pas ce paramètre vous-même. Lorsque vous appelez cette méthode sur la collection retournée par la propriété Controls (dans un projet au niveau de l'application) ou la propriété Controls (dans un projet au niveau du document), ce paramètre est fourni automatiquement.

range
Range

Range qui fournit les limites du contrôle.

name
String

Nom du contrôle qui peut être utilisé pour indexer le contrôle dans l'instance ControlCollection.

Retours

MonthCalendar

Contrôle MonthCalendar qui a été ajouté à l'instance de ControlCollection.

Exceptions

L'argument de nom ou de plage a la valeur null ou l'argument de nom a une longueur nulle.

Un contrôle du même nom se trouve déjà dans l'instance de ControlCollection.

La plage spécifiée n'est pas valide. Les plages sur plusieurs zones ne peuvent pas être utilisées. La plage doit se trouver dans la même feuille de calcul que l'instance de ControlCollection.

Exemples

L’exemple de code suivant ajoute un MonthCalendar contrôle aux cellules a1 à C10, puis affecte à la FirstDayOfWeek propriété la valeur Monday. Pour utiliser cet exemple, exécutez-le à partir de la Sheet1 classe dans un projet au niveau du document.

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

Remarques

La AddMonthCalendar méthode vous permet d’ajouter MonthCalendar des objets à la fin de ControlCollection . Pour supprimer un MonthCalendar contrôle qui a été précédemment ajouté par programme, utilisez la Remove méthode. Le contrôle se redimensionne automatiquement lorsque la plage est redimensionnée.

S’applique à

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

Ajoute un nouveau contrôle MonthCalendar à la feuille de calcul selon la taille et l'emplacement spécifiés.

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

Paramètres

controls
ControlCollection

Collection à laquelle le contrôle doit être ajouté. Ne spécifiez pas ce paramètre vous-même. Lorsque vous appelez cette méthode sur la collection retournée par la propriété Controls (dans un projet au niveau de l'application) ou la propriété Controls (dans un projet au niveau du document), ce paramètre est fourni automatiquement.

left
Double

Distance, en points, entre le bord gauche du contrôle et le bord gauche de la feuille de calcul.

top
Double

Distance, en points, entre le bord supérieur du contrôle et le bord supérieur de la feuille de calcul.

width
Double

Largeur du contrôle en points.

height
Double

Hauteur du contrôle en points.

name
String

Nom du contrôle.

Retours

MonthCalendar

Contrôle MonthCalendar qui a été ajouté à l'instance de ControlCollection.

Exceptions

L'argument de nom a la valeur null ou une longueur nulle.

Un contrôle du même nom se trouve déjà dans l'instance de ControlCollection.

Exemples

L’exemple de code suivant ajoute un MonthCalendar contrôle en haut de la feuille de calcul, puis affecte FirstDayOfWeek à la propriété la valeur Monday. Pour utiliser cet exemple, exécutez-le à partir de la Sheet1 classe dans un projet au niveau du document.

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

Remarques

La AddMonthCalendar méthode vous permet d’ajouter MonthCalendar des objets à la fin de ControlCollection . Pour supprimer un MonthCalendar contrôle qui a été précédemment ajouté par programme, utilisez la Remove méthode.

S’applique à