Bagikan melalui

ControlExtensions.AddMonthCalendar Metode

  • Referensi

Definisi

Ruang nama:
Microsoft.Office.Tools.Excel
Rakitan:
Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Overload

AddMonthCalendar(ControlCollection, Range, String)

Menambahkan kontrol baru MonthCalendar ke lembar kerja pada rentang yang ditentukan.
AddMonthCalendar(ControlCollection, Double, Double, Double, Double, String)

Menambahkan kontrol baru MonthCalendar ke lembar kerja dalam ukuran dan lokasi yang ditentukan.

AddMonthCalendar(ControlCollection, Range, String)

Menambahkan kontrol baru MonthCalendar ke lembar kerja pada rentang yang ditentukan.

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

Parameter

controls
ControlCollection

Koleksi untuk menambahkan kontrol. Jangan berikan parameter ini sendiri. Ketika Anda memanggil metode ini pada koleksi yang dikembalikan oleh Controls properti (dalam proyek tingkat aplikasi) atau Controls properti (dalam proyek tingkat dokumen), parameter ini disediakan secara otomatis.

range
Range

yang Range menyediakan batas untuk kontrol.

name
String

Nama kontrol yang dapat digunakan untuk mengindeks kontrol dalam ControlCollection instans.

Mengembalikan

MonthCalendar

MonthCalendar Kontrol yang ditambahkan ke ControlCollection instans.

Pengecualian

ArgumentNullException

Argumen nama atau rentang adalah null, atau argumen nama memiliki panjang nol.

ControlNameAlreadyExistsException

Kontrol dengan nama yang sama sudah ada dalam ControlCollection instans.

InvalidRangeException

Rentang yang ditentukan tidak valid. Rentang multi-area tidak dapat digunakan. Rentang harus berada pada lembar kerja yang sama dengan ControlCollection instans.

Contoh

Contoh kode berikut menambahkan MonthCalendar kontrol ke sel A1 hingga C10, lalu mengatur properti ke FirstDayOfWeek Senin. Untuk menggunakan contoh ini, jalankan dari Sheet1 kelas dalam proyek tingkat dokumen.

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

Keterangan

Metode ini AddMonthCalendar memungkinkan Anda untuk menambahkan MonthCalendar objek ke akhir ControlCollection. Untuk menghapus MonthCalendar kontrol yang sebelumnya ditambahkan secara terprogram, gunakan metode .Remove Kontrol secara otomatis mengubah ukuran saat rentang diubah ukurannya.

Berlaku untuk

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

Menambahkan kontrol baru MonthCalendar ke lembar kerja dalam ukuran dan lokasi yang ditentukan.

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

Parameter

controls
ControlCollection

Koleksi untuk menambahkan kontrol. Jangan berikan parameter ini sendiri. Ketika Anda memanggil metode ini pada koleksi yang dikembalikan oleh Controls properti (dalam proyek tingkat aplikasi) atau Controls properti (dalam proyek tingkat dokumen), parameter ini disediakan secara otomatis.

left
Double

Jarak dalam titik antara tepi kiri kontrol dan tepi kiri lembar kerja.

top
Double

Jarak dalam titik antara tepi atas kontrol dan tepi atas lembar kerja.

width
Double

Lebar kontrol dalam titik.

height
Double

Tinggi kontrol dalam titik.

name
String

Nama kontrol.

Mengembalikan

MonthCalendar

MonthCalendar Kontrol yang ditambahkan ke ControlCollection instans.

Pengecualian

ArgumentNullException

Argumen nama adalah null atau memiliki panjang nol.

ControlNameAlreadyExistsException

Kontrol dengan nama yang sama sudah ada dalam ControlCollection instans.

Contoh

Contoh kode berikut menambahkan MonthCalendar kontrol ke bagian atas lembar kerja, lalu mengatur properti ke FirstDayOfWeek Senin. Untuk menggunakan contoh ini, jalankan dari Sheet1 kelas dalam proyek tingkat dokumen.

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

Keterangan

Metode ini AddMonthCalendar memungkinkan Anda untuk menambahkan MonthCalendar objek ke akhir ControlCollection. Untuk menghapus MonthCalendar kontrol yang sebelumnya ditambahkan secara terprogram, gunakan metode .Remove

Berlaku untuk