次の方法で共有


ControlExtensions.AddLinkLabel メソッド (ControlCollection, Single, Single, Single, Single, String)

サイズと位置を指定して、新しい LinkLabel コントロールを文書に追加します。

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

構文

'宣言
<ExtensionAttribute> _
Public Shared Function AddLinkLabel ( _
    controls As ControlCollection, _
    left As Single, _
    top As Single, _
    width As Single, _
    height As Single, _
    name As String _
) As LinkLabel
public static LinkLabel AddLinkLabel(
    this ControlCollection controls,
    float left,
    float top,
    float width,
    float height,
    string name
)

パラメーター

  • controls
    型 : Microsoft.Office.Tools.Word.ControlCollection
    コントロールを追加するコレクション。このパラメーターは手動で指定しないでください。(アプリケーション レベルのプロジェクトの) Document.Controls プロパティまたは (ドキュメント レベルのプロジェクトの) DocumentBase.Controls プロパティによって返されたコレクションでこのメソッドを呼び出す場合、このパラメーターは自動的に指定されます。
  • left
    型 : System.Single
    コントロールの左端から文書の左端までの間隔 (ポイント単位)。
  • top
    型 : System.Single
    コントロールの上端から文書の上端までの間隔 (ポイント単位)。
  • width
    型 : System.Single
    コントロールの幅 (ポイント単位)。
  • height
    型 : System.Single
    コントロールの高さ (ポイント単位)。
  • name
    型 : System.String
    ControlCollection インスタンス内のコントロールにインデックスを作成するために使用できる名前。

戻り値

型 : Microsoft.Office.Tools.Word.Controls.LinkLabel
文書に追加されたコントロール。

使用上の注意

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

例外

例外 条件
ArgumentNullException

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

ControlNameAlreadyExistsException

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

解説

このメソッドを使用すると、LinkLabel オブジェクトを ControlCollection の最後に追加できます。

プログラムで追加された LinkLabel を削除するには、Remove メソッドを使用します。

次のコード例は、LinkLabel コントロールを文書の先頭に追加し、テキストを First Name に変更します。次にコードは、リンクの色を青色に変更し、LinkBehavior プロパティを LinkBehavior 列挙体の HoverUnderline 値に設定します。この例を使用するには、これをドキュメント レベルのプロジェクトの ThisDocument クラスから実行します。

Private Sub WordAddLinkLabel()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim LinkLabel1 As Microsoft.Office.Tools.Word.Controls. _
        LinkLabel = Me.Controls.AddLinkLabel(0, 0, 75, 17.25F, _
        "LinkLabel1")
    LinkLabel1.Text = "First Name"
    LinkLabel1.LinkColor = Color.Blue
    LinkLabel1.LinkBehavior = LinkBehavior.HoverUnderline
End Sub 
private void WordAddLinkLabel()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.LinkLabel
         linkLabel1 = this.Controls.AddLinkLabel(
         0, 0, 75, 17.25F, "linkLabel1");
    linkLabel1.Text = "First Name";
    linkLabel1.LinkColor = Color.Blue;
    linkLabel1.LinkBehavior = LinkBehavior.HoverUnderline;
}

.NET Framework セキュリティ

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

参照

関連項目

ControlExtensions クラス

AddLinkLabel オーバーロード

Microsoft.Office.Tools.Word 名前空間