次の方法で共有

ControlExtensions.AddLabel メソッド (ControlCollection, Double, Double, Double, Double, String)

  • [アーティクル]

新しい Label コントロールを指定されたサイズおよび位置でワークシートに追加します。

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

構文

'宣言
<ExtensionAttribute> _
Public Shared Function AddLabel ( _
    controls As ControlCollection, _
    left As Double, _
    top As Double, _
    width As Double, _
    height As Double, _
    name As String _
) As Label

public static Label AddLabel(
    this ControlCollection controls,
    double left,
    double top,
    double width,
    double height,
    string name
)

パラメーター

  • controls
    型: Microsoft.Office.Tools.Excel.ControlCollection
    コントロールを追加するコレクション。このパラメーターは手動で指定しないでください。(アプリケーション レベルのプロジェクトの) Worksheet.Controls プロパティまたは (ドキュメント レベルのプロジェクトの) WorksheetBase.Controls プロパティによって返されたコレクションでこのメソッドを呼び出す場合、このパラメーターは自動的に指定されます。
  • left
    型: System.Double
    コントロールの左端からワークシートの左端までの間隔 (ポイント単位)。
  • top
    型: System.Double
    コントロールの上端からワークシートの上端までの距離 (ポイント単位)。
  • width
    型: System.Double
    コントロールの幅 (ポイント単位)。
  • height
    型: System.Double
    コントロールの高さ (ポイント単位)。

戻り値

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

使用上の注意

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

例外

例外 条件
ArgumentNullException

name 引数が nullnull 参照 (Visual Basic では Nothing) か、または長さが 0 である場合。
ControlNameAlreadyExistsException

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

解説

AddLabel メソッドを使用すると、Label オブジェクトを ControlCollection の最後に追加できます。 以前にプログラムで追加された Label コントロールを削除するには、Remove メソッドを使用します。

例

次のコード例は、Label コントロールをワークシートの一番上に追加し、テキストを First Name に変更します。 この例を使用するには、これをドキュメント レベルのプロジェクトの Sheet1 クラスから実行します。

    Private Sub ExcelAddLabel()

        Dim Label1 As Microsoft.Office.Tools.Excel. _
            Controls.Label = Me.Controls.AddLabel( _
            0, 0, 75, 17.25, "Label1")
        Label1.Text = "First Name"

    End Sub


private void ExcelAddLabel()
{

    Microsoft.Office.Tools.Excel.Controls.Label
        label1 = this.Controls.AddLabel(
        0, 0, 75, 17.25, "label1");
    label1.Text = "First Name";
}

.NET Framework セキュリティ

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

参照

参照

ControlExtensions クラス

AddLabel オーバーロード

Microsoft.Office.Tools.Excel 名前空間