Partager via

ControlExtensions.AddMonthCalendar Méthode

  • Référence

Définition

Espace de noms:
Microsoft.Office.Tools.Excel
Assembly:
Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

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:
[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

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

ArgumentNullException

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

ControlNameAlreadyExistsException

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

InvalidRangeException

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 définit la FirstDayOfWeek propriété sur 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 précédemment ajouté par programmation, 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:
[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

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

ArgumentNullException

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

ControlNameAlreadyExistsException

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 définit la FirstDayOfWeek propriété sur 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 précédemment ajouté par programmation, utilisez la Remove méthode .

S’applique à