次の方法で共有


ControlExtensions.AddMonthCalendar メソッド (ControlCollection, Range, String)

新しい MonthCalendar コントロールをワークシートの指定の範囲に追加します。

名前空間:  Microsoft.Office.Tools.Excel
アセンブリ:  Microsoft.Office.Tools.Excel.v4.0.Utilities (Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 内)

構文

'宣言
<ExtensionAttribute> _
Public Shared Function AddMonthCalendar ( _
    controls As ControlCollection, _
    range As Range, _
    name As String _
) As MonthCalendar
public static MonthCalendar AddMonthCalendar(
    this ControlCollection controls,
    Range range,
    string name
)

パラメーター

  • controls
    型: Microsoft.Office.Tools.Excel.ControlCollection
    コントロールを追加するコレクション。このパラメーターは手動で指定しないでください。(アプリケーション レベルのプロジェクトの) Worksheet.Controls プロパティまたは (ドキュメント レベルのプロジェクトの) WorksheetBase.Controls プロパティによって返されたコレクションでこのメソッドを呼び出す場合、このパラメーターは自動的に指定されます。
  • name
    型: System.String
    ControlCollection インスタンス内のコントロールにインデックスを付けるために使用できるコントロールの名前。

戻り値

型: Microsoft.Office.Tools.Excel.Controls.MonthCalendar
ControlCollection インスタンスに追加された MonthCalendar コントロール。

使用上の注意

Visual Basic および Visual C# では、このメソッドを、ControlCollection 型のオブジェクトのインスタンス メソッドとして呼び出すことができます。 インスタンス メソッド構文を使用してこのメソッドを呼び出す場合は、最初のパラメーターを省略します。 詳細については、「拡張メソッド (Visual Basic)」または「拡張メソッド (C# プログラミング ガイド)」を参照してください。

例外

例外 条件
ArgumentNullException

name 引数または range 引数が nullnull 参照 (Visual Basic では Nothing)。または、name 引数の長さが 0 の場合。

ControlNameAlreadyExistsException

同じ名前のコントロールが既に ControlCollection インスタンスに存在します。

InvalidRangeException

指定された範囲が無効である場合。 複数の領域で構成される範囲は使用できません。 範囲は、ControlCollection インスタンスと同じワークシート上であることが必要です。

解説

AddMonthCalendar メソッドを使用すると、MonthCalendar オブジェクトを ControlCollection の最後に追加できます。 以前にプログラムで追加された MonthCalendar コントロールを削除するには、Remove メソッドを使用します。 範囲のサイズが変更されると、コントロールのサイズが自動的に変更されます。

次のコード例は、MonthCalendar コントロールをセル A1C10 に追加し、FirstDayOfWeek プロパティを月曜日に設定します。 この例を使用するには、これをドキュメント レベルのプロジェクトの Sheet1 クラスから実行します。

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
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;
}

.NET Framework セキュリティ

  • 直前の呼び出し元に対する完全な信頼。 このメンバーは、部分的に信頼されているコードから使用することはできません。 詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

参照

ControlExtensions クラス

AddMonthCalendar オーバーロード

Microsoft.Office.Tools.Excel 名前空間