ControlCollection.AddLabel メソッド (Double, Double, Double, Double, String) (2007 System)
更新 : 2007 年 11 月
新しい Label コントロールを指定されたサイズおよび位置でワークシートに追加します。
名前空間 : Microsoft.Office.Tools.Excel
アセンブリ : Microsoft.Office.Tools.Excel.v9.0 (Microsoft.Office.Tools.Excel.v9.0.dll 内)
構文
'宣言
Public Function AddLabel ( _
left As Double, _
top As Double, _
width As Double, _
height As Double, _
name As String _
) As Label
'使用
Dim instance As ControlCollection
Dim left As Double
Dim top As Double
Dim width As Double
Dim height As Double
Dim name As String
Dim returnValue As Label
returnValue = instance.AddLabel(left, _
top, width, height, name)
public Label AddLabel(
double left,
double top,
double width,
double height,
string name
)
パラメータ
left
型 : System.Doubleコントロールの左端からワークシートの左端までの間隔 (ポイント単位)。
top
型 : System.Doubleコントロールの上端からワークシートの上端までの距離 (ポイント単位)。
width
型 : System.Doubleコントロールの幅 (ポイント単位)。
height
型 : System.Doubleコントロールの高さ (ポイント単位)。
name
型 : System.Stringコントロールの名前。
戻り値
型 : Microsoft.Office.Tools.Excel.Controls.Label
ControlCollection インスタンスに追加された Label コントロール。
例外
例外 | 条件 |
---|---|
ArgumentNullException | name 引数が nullnull 参照 (Visual Basic では Nothing) か、または長さが 0 である場合。 |
ControlNameAlreadyExistsException | 同じ名前のコントロールが既に ControlCollection インスタンスに存在する場合。 |
解説
AddLabel メソッドを使用すると、Label オブジェクトを ControlCollection の最後に追加できます。以前にプログラムで追加された Label コントロールを削除するには、Remove() メソッドを使用します。
例
次のコード例は、Label コントロールをワークシートの一番上に追加し、テキストを First Name に変更します。
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";
}
アクセス許可
- 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。