Compartir a través de

ControlExtensions.AddMonthCalendar Método

  • Referencia

Definición

Espacio de nombres:
Microsoft.Office.Tools.Excel
Ensamblado:
Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Sobrecargas

AddMonthCalendar(ControlCollection, Range, String)

Agrega a la hoja de cálculo un nuevo control MonthCalendar en el rango especificado.
AddMonthCalendar(ControlCollection, Double, Double, Double, Double, String)

Agrega a la hoja de cálculo un nuevo control MonthCalendar con el tamaño y en la ubicación especificados.

AddMonthCalendar(ControlCollection, Range, String)

Agrega a la hoja de cálculo un nuevo control MonthCalendar en el rango 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

Colección a la que se va a agregar el control. No proporcione este parámetro personalmente. Cuando se llama a este método en la colección devuelta por la propiedad Controls (en un proyecto de nivel de aplicación) o la propiedad Controls (en un proyecto de nivel de documento), este parámetro se proporciona automáticamente.

range
Range

Objeto Range que proporciona los límites del control.

name
String

Nombre del control que puede utilizarse para indizar el control en la instancia de ControlCollection.

Devoluciones

MonthCalendar

Control MonthCalendar agregado a la instancia del objeto ControlCollection.

Excepciones

ArgumentNullException

El argumento de nombre o rango es null, o el argumento de nombre tiene longitud cero.

ControlNameAlreadyExistsException

Ya existe un control con el mismo nombre en la instancia de ControlCollection.

InvalidRangeException

El intervalo especificado no es válido. No pueden utilizarse rangos multiárea. El rango debe estar en la misma hoja de cálculo que la instancia de ControlCollection.

Ejemplos

En el ejemplo de código siguiente se agrega un MonthCalendar control a las celdas A1 a C10 y, a continuación, se establece la FirstDayOfWeek propiedad en Monday. Para usar este ejemplo, ejecútelo desde la Sheet1 clase en un proyecto de nivel 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

Comentarios

El AddMonthCalendar método permite agregar MonthCalendar objetos al final de ControlCollection. Para quitar un MonthCalendar control que se agregó anteriormente mediante programación, use el Remove método . El control cambia automáticamente el tamaño cuando se cambia el tamaño del intervalo.

Se aplica a

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

Agrega a la hoja de cálculo un nuevo control MonthCalendar con el tamaño y en la ubicación 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

Colección a la que se va a agregar el control. No proporcione este parámetro personalmente. Cuando se llama a este método en la colección devuelta por la propiedad Controls (en un proyecto de nivel de aplicación) o la propiedad Controls (en un proyecto de nivel de documento), este parámetro se proporciona automáticamente.

left
Double

Distancia, expresada en puntos, entre el borde izquierdo del control y el borde izquierdo de la hoja de cálculo.

top
Double

Distancia, expresada en puntos, entre el borde superior del control y el borde superior de la hoja de cálculo.

width
Double

Ancho del control, expresado en puntos.

height
Double

Alto del control, expresado en puntos.

name
String

Nombre del control.

Devoluciones

MonthCalendar

Control MonthCalendar agregado a la instancia del objeto ControlCollection.

Excepciones

ArgumentNullException

El argumento de nombre es null o tiene longitud cero.

ControlNameAlreadyExistsException

Ya existe un control con el mismo nombre en la instancia de ControlCollection.

Ejemplos

En el ejemplo de código siguiente se agrega un MonthCalendar control a la parte superior de la hoja de cálculo y, a continuación, se establece la FirstDayOfWeek propiedad en Monday. Para usar este ejemplo, ejecútelo desde la Sheet1 clase en un proyecto de nivel 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

Comentarios

El AddMonthCalendar método permite agregar MonthCalendar objetos al final de ControlCollection. Para quitar un MonthCalendar control que se agregó anteriormente mediante programación, use el Remove método .

Se aplica a