ControlExtensions.AddMonthCalendar Método

Definição

Namespace:

Microsoft.Office.Tools.Excel

Assembly:

Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Sobrecargas

AddMonthCalendar(ControlCollection, Range, String)	Adiciona um novo controle MonthCalendar à planilha no intervalo especificado.
AddMonthCalendar(ControlCollection, Double, Double, Double, Double, String)	Adiciona um novo controle MonthCalendar à planilha no local e no tamanho especificados.

AddMonthCalendar(ControlCollection, Range, String)

Adiciona um novo controle MonthCalendar à planilha no intervalo especificado.

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

Parâmetros

controls

ControlCollection

A coleção a ser adicionada ao controle. Não forneça esse parâmetro. Quando você chama esse método na coleção retornada pela propriedade Controls (em um projeto no nível de aplicativo) ou Controls (em um projeto no nível de documento), esse parâmetro é fornecido automaticamente.

range

Range

Um Range que fornece os limites do controle.

name

String

O nome do controle que pode ser usado para indexar o controle na instância de ControlCollection.

Retornos

MonthCalendar

O controle MonthCalendar adicionado à instância ControlCollection.

Exceções

ArgumentNullException

O argumento de nome ou intervalo é null, ou o argumento de nome tem comprimento zero.

ControlNameAlreadyExistsException

Um controle com o mesmo nome já está na instância de ControlCollection.

InvalidRangeException

O intervalo que foi especificado não é válido. Os intervalos de várias áreas não podem ser usados. O intervalo deve estar na mesma planilha que a instância de ControlCollection.

Exemplos

O exemplo de código a seguir adiciona um MonthCalendar controle às células A1 a C10 e define a FirstDayOfWeek propriedade como segunda-feira. Para usar esse exemplo, execute-o na classe Sheet1 em um projeto no nível de 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

Comentários

O AddMonthCalendar método permite que você adicione MonthCalendar objetos ao final do ControlCollection. Para remover um MonthCalendar controle que foi adicionado programaticamente anteriormente, use o Remove método . O controle redimensiona automaticamente quando o intervalo é redimensionado.

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

Adiciona um novo controle MonthCalendar à planilha no local e no tamanho especificados.

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

Parâmetros

controls

ControlCollection

A coleção a ser adicionada ao controle. Não forneça esse parâmetro. Quando você chama esse método na coleção retornada pela propriedade Controls (em um projeto no nível de aplicativo) ou Controls (em um projeto no nível de documento), esse parâmetro é fornecido automaticamente.

left

Double

A distância em pontos entre a borda esquerda do controle e a borda esquerda da planilha.

top

Double

A distância em pontos entre a borda superior do controle e a borda superior da planilha.

width

Double

A largura do controle em pontos.

height

Double

A altura do controle em pontos.

name

String

O nome do controle.

Retornos

MonthCalendar

O controle MonthCalendar adicionado à instância ControlCollection.

Exceções

ArgumentNullException

O argumento de nome é null ou tem comprimento zero.

ControlNameAlreadyExistsException

Um controle com o mesmo nome já está na instância de ControlCollection.

Exemplos

O exemplo de código a seguir adiciona um MonthCalendar controle à parte superior da planilha e define a FirstDayOfWeek propriedade como segunda-feira. Para usar esse exemplo, execute-o na classe Sheet1 em um projeto no nível de 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

Comentários

O AddMonthCalendar método permite que você adicione MonthCalendar objetos ao final do ControlCollection. Para remover um MonthCalendar controle que foi adicionado programaticamente anteriormente, use o Remove método .