ControlExtensions.AddMonthCalendar Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
- name
- String
Nom du contrôle qui peut être utilisé pour indexer le contrôle dans l'instance ControlCollection.
Retours
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
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.