LinkLabel.LinkArea プロパティとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

LinkLabel.LinkArea プロパティ

テキスト内でリンクとして処理される領域を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Property LinkArea As
 LinkArea

Visual Basic (使用法)

Dim instance As LinkLabel
Dim value As LinkArea

value = instance.LinkArea

instance.LinkArea = value

[LocalizableAttribute(true)] 
public LinkArea LinkArea { get; set;
 }

C++

[LocalizableAttribute(true)] 
public:
property LinkArea LinkArea {
    LinkArea get ();
    void set (LinkArea value);
}

/** @property */
public LinkArea get_LinkArea ()

/** @property */
public void set_LinkArea (LinkArea value)

JScript

public function get LinkArea
 () : LinkArea

public function set LinkArea
 (value : LinkArea)

プロパティ値
リンクとして処理される領域を表す LinkArea。

例外

例外の種類	条件
ArgumentOutOfRangeException	LinkArea オブジェクトの Start プロパティが 0 未満です。または LinkArea オブジェクトの Length プロパティが -1 未満です。

例外の種類

条件

ArgumentOutOfRangeException

LinkArea オブジェクトの Start プロパティが 0 未満です。

または

LinkArea オブジェクトの Length プロパティが -1 未満です。

解説

LinkArea プロパティを使用すると、LinkLabel コントロールのテキスト内に表示する 1 つのハイパーリンクを簡単に指定できます。LinkArea オブジェクトは、コントロールのテキスト内のリンクの先頭位置と、ハイパーリンクのテキストの長さを指定するプロパティを提供します。LinkArea プロパティを使用してハイパーリンクを指定すると、指定されたハイパーリンクがコントロールの LinkLabel.LinkCollection に追加されます。LinkArea プロパティは、割り当てられた LinkArea オブジェクトを前出のコレクションに格納される LinkLabel.Link オブジェクトに変換します。

コントロールのテキストに複数のハイパーリンクを追加するには、Links プロパティを使用します。Links プロパティを使用すると、コントロールに指定されているリンクを格納する LinkLabel.LinkCollection のプロパティとメソッドにアクセスできます。LinkLabel にリンクを追加するメソッドを使用すると、作成中のリンクに関連付けるデータを LinkData プロパティに指定することもできます。LinkData プロパティの値は、表示するファイルの位置や Web サイトのアドレスを格納するために使用できます。

LinkLabel コントロールを作成すると、LinkLabel コントロールのテキスト全体を含む既定のハイパーリンクが LinkLabel.LinkCollection に追加されます。LinkArea プロパティで新しいリンク領域を指定して、この既定のリンクをオーバーライドするか、LinkLabel.LinkCollection の Add メソッドを使用してリンクを指定できます。既定のハイパーリンクは、LinkLabel.LinkCollection クラスの Remove メソッドを使用して削除することもできます。

メモ
LinkArea プロパティは、コレクションへのハイパーリンクの追加方法に関係なく、必ず LinkLabel.LinkCollection の最初の項目を返します。

使用例

複数の LinkArea セクションが定義されている LinkLabel クラスを使用して、フォームにラベルを表示する例を次に示します。AutoSize、LinkBehavior、DisabledLinkColor、LinkColor、および VisitedLinkColor などの各プロパティを設定して LinkLabel の外観をカスタマイズする例を次に示します。最初の LinkArea は、LinkLabel.LinkArea プロパティを使用して指定されます。追加のリンクは、LinkLabel.LinkCollection.Add メソッドを使用して LinkLabel に追加されます。この例では、LinkClicked イベントを使用して、Web ブラウザを起動してハイパーリンクにアクセスし、その他のリンクを示す MessageBox を表示しています。

Visual Basic

Imports System
Imports System.Drawing
Imports System.Windows.Forms

Public NotInheritable Class
 Form1
    Inherits System.Windows.Forms.Form

    Friend WithEvents LinkLabel1 As
 System.Windows.Forms.LinkLabel

    <System.STAThread()> _
    Public Shared Sub Main()
        System.Windows.Forms.Application.Run(New Form1)
    End Sub 'Main

    Public Sub New()
        MyBase.New()


        Me.LinkLabel1 = New System.Windows.Forms.LinkLabel

        ' Configure the LinkLabel's size and location. Specify that
 the
        ' size should be automatically determined by the content.
        Me.linkLabel1.Location = New System.Drawing.Point(34,
 56) 
        Me.linkLabel1.Size = New System.Drawing.Size(224,
 16) 
        Me.linkLabel1.AutoSize = True 

        ' Configure the appearance.
        ' Set the DisabledLinkColor so that a disabled link will show
 up against the form's background.
        Me.linkLabel1.DisabledLinkColor = System.Drawing.Color.Red
 
        Me.linkLabel1.VisitedLinkColor = System.Drawing.Color.Blue
 
        Me.linkLabel1.LinkBehavior = System.Windows.Forms.LinkBehavior.HoverUnderline
 
        Me.linkLabel1.LinkColor = System.Drawing.Color.Navy 
        
        Me.linkLabel1.TabIndex = 0 
        Me.linkLabel1.TabStop = True 
        
        ' Identify what the first Link is.
        Me.linkLabel1.LinkArea = New System.Windows.Forms.LinkArea(0,
 8)

        ' Identify that the first link is visited already.
        Me.linkLabel1.Links(0).Visited = true
        
        ' Set the Text property to a string.
        Me.linkLabel1.Text = "Register Online.
  Visit Microsoft.  Visit MSN."

        ' Create new links using the Add method of the LinkCollection
 class.
        ' Underline the appropriate words in the LinkLabel's Text property.
        ' The words 'Register', 'Microsoft', and 'MSN' will 
        ' all be underlined and behave as hyperlinks.

        ' First check that the Text property is long enough to accommodate
        ' the desired hyperlinked areas.  If it's not, don't add hyperlinks.
        If Me.LinkLabel1.Text.Length >=
 45 Then
            Me.LinkLabel1.Links(0).LinkData = "Register"
            Me.LinkLabel1.Links.Add(24, 9, "www.microsoft.com")
            Me.LinkLabel1.Links.Add(42, 3, "www.msn.com")
            ' The second link is disabled and will appear as red.
            Me.linkLabel1.Links(1).Enabled = False
        End If

        ' Set up how the form should be displayed and adds the controls
 to the form.
        Me.ClientSize = New System.Drawing.Size(292,
 266)
        Me.Controls.AddRange(New System.Windows.Forms.Control()
 {Me.LinkLabel1})
        Me.Text = "Link Label Example"
    End Sub

    Private Sub linkLabel1_LinkClicked(ByVal
 sender As Object, _
                ByVal e As System.Windows.Forms.LinkLabelLinkClickedEventArgs)
 Handles LinkLabel1.LinkClicked

        ' Determine which link was clicked within the LinkLabel.
        Me.LinkLabel1.Links(LinkLabel1.Links.IndexOf(e.Link)).Visited
 = True

        ' Displays the appropriate link based on the value of the LinkData
 property of the Link object.
        Dim target As String
 = CType(e.Link.LinkData, String)

        ' If the value looks like a URL, navigate to it.
        ' Otherwise, display it in a message box.
        If (Nothing <> target) And
 (target.StartsWith("www")) Then
            System.Diagnostics.Process.Start(target)
        Else
            MessageBox.Show(("Item clicked: " + target))
        End If

    End Sub

End Class

using System;
using System.Drawing;
using System.Windows.Forms;

public class Form1 : System.Windows.Forms.Form
{
    private System.Windows.Forms.LinkLabel linkLabel1;
    
    [STAThread]
    static void Main() 
    {
        Application.Run(new Form1());
    }

    public Form1()
    {
        // Create the LinkLabel.
        this.linkLabel1 = new System.Windows.Forms.LinkLabel();

        // Configure the LinkLabel's size and location. Specify that
 the
        // size should be automatically determined by the content.
        this.linkLabel1.Location = new System.Drawing.Point(34,
 56);
        this.linkLabel1.Size = new System.Drawing.Size(224,
 16);
        this.linkLabel1.AutoSize = true;

        // Configure the appearance. 
        // Set the DisabledLinkColor so that a disabled link will show
 up against the form's background.
        this.linkLabel1.DisabledLinkColor = System.Drawing.Color.Red;
        this.linkLabel1.VisitedLinkColor = System.Drawing.Color.Blue;
        this.linkLabel1.LinkBehavior = System.Windows.Forms.LinkBehavior.HoverUnderline;
        this.linkLabel1.LinkColor = System.Drawing.Color.Navy;
        
        this.linkLabel1.TabIndex = 0;
        this.linkLabel1.TabStop = true;
        

        // Add an event handler to do something when the links are clicked.
        this.linkLabel1.LinkClicked += new
 System.Windows.Forms.LinkLabelLinkClickedEventHandler(this.linkLabel1_LinkClicked);

        // Identify what the first Link is.
        this.linkLabel1.LinkArea = new System.Windows.Forms.LinkArea(0,
 8);

        // Identify that the first link is visited already.
        this.linkLabel1.Links[0].Visited = true;
        
        // Set the Text property to a string.
        this.linkLabel1.Text = "Register Online.  Visit Microsoft.
  Visit MSN.";

        // Create new links using the Add method of the LinkCollection
 class.
        // Underline the appropriate words in the LinkLabel's Text property.
        // The words 'Register', 'Microsoft', and 'MSN' will 
        // all be underlined and behave as hyperlinks.

        // First check that the Text property is long enough to accommodate
        // the desired hyperlinked areas.  If it's not, don't add hyperlinks.
        if(this.linkLabel1.Text.Length >=
 45)
        {
            this.linkLabel1.Links[0].LinkData = "Register";
            this.linkLabel1.Links.Add(24, 9, "www.microsoft.com");
            this.linkLabel1.Links.Add(42, 3, "www.msn.com");
        //  The second link is disabled and will appear as red.
            this.linkLabel1.Links[1].Enabled = false;
        }
        
        // Set up how the form should be displayed and add the controls
 to the form.
        this.ClientSize = new System.Drawing.Size(292,
 266);
        this.Controls.AddRange(new System.Windows.Forms.Control[]
 {this.linkLabel1});
        this.Text = "Link Label Example";
    }

    private void linkLabel1_LinkClicked(object
 sender, System.Windows.Forms.LinkLabelLinkClickedEventArgs e)
    {
        // Determine which link was clicked within the LinkLabel.
        this.linkLabel1.Links[linkLabel1.Links.IndexOf(e.Link)].Visited
 = true;

        // Display the appropriate link based on the value of the 
        // LinkData property of the Link object.
        string target = e.Link.LinkData as string;

        // If the value looks like a URL, navigate to it.
        // Otherwise, display it in a message box.
        if(null != target && target.StartsWith("www"))
        {
            System.Diagnostics.Process.Start(target);
        }
        else
        {    
            MessageBox.Show("Item clicked: " + target);
        }
    }
}

C++

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::Windows::Forms;
public ref class Form1: public
 System::Windows::Forms::Form
{
private:
   System::Windows::Forms::LinkLabel^ linkLabel1;

public:
   Form1()
   {
      
      // Create the LinkLabel.
      this->linkLabel1 = gcnew System::Windows::Forms::LinkLabel;
      
      // Configure the LinkLabel's size and location. Specify that the
      // size should be automatically determined by the content.
      this->linkLabel1->Location = System::Drawing::Point(
 34, 56 );
      this->linkLabel1->Size = System::Drawing::Size( 224,
 16 );
      this->linkLabel1->AutoSize = true;
      
      // Configure the appearance.
      this->linkLabel1->DisabledLinkColor = System::Drawing::Color::Red;
      this->linkLabel1->VisitedLinkColor = System::Drawing::Color::Blue;
      this->linkLabel1->LinkBehavior = System::Windows::Forms::LinkBehavior::HoverUnderline;
      this->linkLabel1->LinkColor = System::Drawing::Color::Navy;
      this->linkLabel1->TabIndex = 0;
      this->linkLabel1->TabStop = true;
      
      // Add an event handler to do something when the links are clicked.
      this->linkLabel1->LinkClicked += gcnew System::Windows::Forms::LinkLabelLinkClickedEventHandler(
 this, &Form1::linkLabel1_LinkClicked );
      
      // Identify what the first Link is.
      this->linkLabel1->LinkArea = System::Windows::Forms::LinkArea(
 0, 8 );
      
      // Identify that the first link is visited already.
      this->linkLabel1->Links[ 0 ]->Visited = true;
      
      // Set the Text property to a String*.
      this->linkLabel1->Text = "Register Online.  Visit
 Microsoft.  Visit MSN.";
      
      // Create new links using the Add method of the LinkCollection
 class.
      // Underline the appropriate words in the LinkLabel's Text property.
      // The words 'Register', 'Microsoft', and 'MSN' will
      // all be underlined and behave as hyperlinks.
      // First check that the Text property is long enough to accommodate
      // the desired hyperlinked areas.  If it's not, don't add hyperlinks.
      if ( this->linkLabel1->Text->Length
 >= 45 )
      {
         this->linkLabel1->Links[ 0 ]->LinkData = "Register";
         this->linkLabel1->Links->Add( 24, 9, "www.microsoft.com"
 );
         this->linkLabel1->Links->Add( 42, 3, "www.msn.com"
 );
         this->linkLabel1->Links[ 1 ]->Enabled = false;
      }

      
      // Set up how the form should be displayed and add the controls
 to the form.
      this->ClientSize = System::Drawing::Size( 292, 266 );
      array<System::Windows::Forms::Control^>^temp0 = {this->linkLabel1};
      this->Controls->AddRange( temp0 );
      this->Text = "Link Label Example";
   }


private:
   void linkLabel1_LinkClicked( Object^ /*sender*/, System::Windows::Forms::LinkLabelLinkClickedEventArgs^
 e )
   {
      // Determine which link was clicked within the LinkLabel.
      this->linkLabel1->Links[ linkLabel1->Links->IndexOf(
 e->Link ) ]->Visited = true;
      
      // Display the appropriate link based on the value of the
      // LinkData property of the Link Object*.
      String^ target = dynamic_cast<String^>(e->Link->LinkData);
      
      // If the value looks like a URL, navigate to it.
      // Otherwise, display it in a message box.
      if ( nullptr != target && target->StartsWith(
 "www" ) )
      {
         System::Diagnostics::Process::Start( target );
      }
      else
      {
         MessageBox::Show( "Item clicked: {0}", target );
      }
   }
};

[STAThread]
int main()
{
   Application::Run( gcnew Form1 );
}

import System.*;
import System.Drawing.*;
import System.Windows.Forms.*;

public class Form1 extends System.Windows.Forms.Form
{
    private System.Windows.Forms.LinkLabel linkLabel1;

    /** @attribute STAThread()
     */
    public static void main(String[]
 args)
    {
        Application.Run(new Form1());
    } //main

    public Form1()
    {
        // Create the LinkLabel.
        this.linkLabel1 = new System.Windows.Forms.LinkLabel();
        // Configure the LinkLabel's size and location. Specify that
 the
        // size should be automatically determined by the content.
        this.linkLabel1.set_Location(new System.Drawing.Point(34,
 56));
        this.linkLabel1.set_Size(new System.Drawing.Size(224,
 16));
        this.linkLabel1.set_AutoSize(true);
        // Configure the appearance. 
        // Set the DisabledLinkColor so that a disabled link will show
 up 
        // against the form's background.
        this.linkLabel1.set_DisabledLinkColor(System.Drawing.Color.get_Red());
        this.linkLabel1.set_VisitedLinkColor(System.Drawing.Color.get_Blue());
        this.linkLabel1.set_LinkBehavior(
            System.Windows.Forms.LinkBehavior.HoverUnderline);
        this.linkLabel1.set_LinkColor(System.Drawing.Color.get_Navy());

        this.linkLabel1.set_TabIndex(0);
        this.linkLabel1.set_TabStop(true);
        // Add an event handler to do something when the links are clicked.
        this.linkLabel1.add_LinkClicked(new
 System.Windows.Forms.
            LinkLabelLinkClickedEventHandler(this.linkLabel1_LinkClicked));
        // Identify what the first Link is.
        this.linkLabel1.set_LinkArea(new System.Windows.Forms.LinkArea(0,
 8));
        // Identify that the first link is visited already.
        this.linkLabel1.get_Links().get_Item(0).set_Visited(true);
        // Set the Text property to a string.
        this.linkLabel1.set_Text("Register Online.  Visit
 Microsoft." 
            + "  Visit MSN.");
        // Create new links using the Add method of the LinkCollection
 class.
        // Underline the appropriate words in the LinkLabel's Text property.
        // The words 'Register', 'Microsoft', and 'MSN' will 
        // all be underlined and behave as hyperlinks.
        // First check that the Text property is long enough to accommodate
        // the desired hyperlinked areas.  If it's not, don't add hyperlinks.
        if (this.linkLabel1.get_Text().get_Length()
 >= 45) {
            this.linkLabel1.get_Links().get_Item(0).set_LinkData("Register");
            this.linkLabel1.get_Links().Add(24, 9, "www.microsoft.com");
            this.linkLabel1.get_Links().Add(42, 3, "www.msn.com");
            //  The second link is disabled and will appear as red.
            this.linkLabel1.get_Links().get_Item(1).set_Enabled(false);
        }
        // Set up how the form should be displayed and add the controls
 to 
        // the form.
        this.set_ClientSize(new System.Drawing.Size(292,
 266));
        this.get_Controls().AddRange(new System.Windows.Forms.Control[]
 { 
            this.linkLabel1 });
        this.set_Text("Link Label Example");
    } //Form1

    private void linkLabel1_LinkClicked(Object
 sender, 
        System.Windows.Forms.LinkLabelLinkClickedEventArgs e)
    {
        // Determine which link was clicked within the LinkLabel.
        this.linkLabel1.get_Links().get_Item(linkLabel1.get_Links().
            IndexOf(e.get_Link())).set_Visited(true);
        // Display the appropriate link based on the value of the 
        // LinkData property of the Link object.
        String target = (String)e.get_Link().get_LinkData();
        // If the value looks like a URL, navigate to it.
        // Otherwise, display it in a message box.
        if (null != target && target.StartsWith("www"))
 {
            System.Diagnostics.Process.Start(target);
        }
        else {
            MessageBox.Show("Item clicked: " + target);
        }
    } //linkLabel1_LinkClicked
} //Form1

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
LinkLabel クラス
LinkLabel メンバ
System.Windows.Forms 名前空間
Point

このページでは「.NET Framework クラスライブラリリファレンス」からLinkLabel.LinkArea プロパティを検索した結果を表示しています。
Weblioに収録されているすべての辞書からLinkLabel.LinkArea プロパティを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からLinkLabel.LinkArea プロパティを検索

>> 「LinkLabel.LinkArea プロパティ」を含む用語の索引
LinkLabel.LinkArea プロパティのページへのリンク

LinkLabel.LinkArea プロパティとは？わかりやすく解説

LinkLabel.LinkArea プロパティ

「LinkLabel.LinkArea プロパティ」の関連用語


	© 2024 Microsoft.All rights reserved.

LinkLabel.LinkArea プロパティとは？ わかりやすく解説

LinkLabel.LinkArea プロパティ

急上昇のことば

「LinkLabel.LinkArea プロパティ」の関連用語

LinkLabel.LinkArea プロパティとは？わかりやすく解説