Condividi tramite

ControlExtensions.AddMonthCalendar Metodo

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.Office.Tools.Excel
Assembly:
Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Overload

AddMonthCalendar(ControlCollection, Range, String)

Aggiunge un nuovo controllo MonthCalendar al foglio di lavoro in corrispondenza dell'intervallo specificato.
AddMonthCalendar(ControlCollection, Double, Double, Double, Double, String)

Aggiunge un nuovo controllo MonthCalendar al foglio di lavoro con le dimensioni e la posizione specificate.

AddMonthCalendar(ControlCollection, Range, String)

Aggiunge un nuovo controllo MonthCalendar al foglio di lavoro in corrispondenza dell'intervallo specificato.

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

Parametri

controls
ControlCollection

Raccolta a cui aggiungere il controllo. Non indicare questo parametro autonomamente. Quando questo metodo viene chiamato sulla raccolta restituita dalla proprietà Controls (in un progetto a livello di applicazione) o dalla proprietà Controls (in un progetto a livello di documento), questo parametro viene fornito automaticamente.

range
Range

Oggetto Range che fornisce i limiti per il controllo.

name
String

Nome del controllo che può essere utilizzato per indicizzare il controllo nell'istanza di ControlCollection.

Restituisce

MonthCalendar

Controllo MonthCalendar aggiunto all'istanza di ControlCollection.

Eccezioni

ArgumentNullException

L'argomento relativo al nome o all'intervallo è null oppure la lunghezza dell'argomento relativo al nome è zero.

ControlNameAlreadyExistsException

Nell'istanza di ControlCollection è già presente un controllo con lo stesso nome.

InvalidRangeException

L'intervallo specificato non è valido. Impossibile utilizzare gli intervalli di più aree. L'intervallo deve trovarsi nello stesso foglio di lavoro dell'istanza di ControlCollection.

Esempio

L'esempio di codice seguente aggiunge un MonthCalendar controllo alle celle A1 a C10 e quindi imposta la FirstDayOfWeek proprietà su Lunedì. Per usare questo esempio, eseguirlo dalla Sheet1 classe in un progetto a livello di documento.

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

Commenti

Il AddMonthCalendar metodo consente di aggiungere MonthCalendar oggetti alla fine di ControlCollection. Per rimuovere un MonthCalendar controllo aggiunto in precedenza a livello di codice, utilizzare il Remove metodo. Il controllo ridimensiona automaticamente quando l'intervallo viene ridimensionato.

Si applica a

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

Aggiunge un nuovo controllo MonthCalendar al foglio di lavoro con le dimensioni e la posizione specificate.

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

Parametri

controls
ControlCollection

Raccolta a cui aggiungere il controllo. Non indicare questo parametro autonomamente. Quando questo metodo viene chiamato sulla raccolta restituita dalla proprietà Controls (in un progetto a livello di applicazione) o dalla proprietà Controls (in un progetto a livello di documento), questo parametro viene fornito automaticamente.

left
Double

Distanza, espressa in punti, tra il bordo sinistro del controllo e il bordo sinistro del foglio di lavoro.

top
Double

Distanza, espressa in punti, tra il bordo superiore del controllo e il bordo superiore del foglio di lavoro.

width
Double

Larghezza del controllo espressa in punti.

height
Double

Altezza del controllo espressa in punti.

name
String

Nome del controllo.

Restituisce

MonthCalendar

Controllo MonthCalendar aggiunto all'istanza di ControlCollection.

Eccezioni

ArgumentNullException

L'argomento relativo al nome è null oppure ha lunghezza zero.

ControlNameAlreadyExistsException

Nell'istanza di ControlCollection è già presente un controllo con lo stesso nome.

Esempio

L'esempio di codice seguente aggiunge un MonthCalendar controllo all'inizio del foglio di lavoro e quindi imposta la FirstDayOfWeek proprietà su Lunedì. Per usare questo esempio, eseguirlo dalla Sheet1 classe in un progetto a livello di documento.

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

Commenti

Il AddMonthCalendar metodo consente di aggiungere MonthCalendar oggetti alla fine di ControlCollection. Per rimuovere un MonthCalendar controllo aggiunto in precedenza a livello di codice, utilizzare il Remove metodo.

Si applica a