link

ページへのリンク、または同一ページ内の参照先へのリンクを作成します。

構文

            {link
                [target=target-browser-name,]
                href={url url-string},
                link-display}

説明

リンク先のファイル名を指定することで目的のページにハイパーリンクを作成するために link を使用します。

ハイパーリンクの表示にプレーンテキストを使用する場合、このように下線付き青いテキストで表示されます。

リンク先のページをロードして特定の行にスクロールする場合、destination を使用してその行を指定する必要があります。

非ローカルオプションの context-menu-for-link を使用して link のコンテキストメニューを指定することもできます。

target-browser-name: 参照先をロードするブラウザの固有の名前。値を指定しない場合には、現在のブラウザを使用して url-string で指定したページがロードされます。値を指定した場合には、指定した名前のブラウザウィンドウが使用されます。指定した名前のブラウザウィンドウが存在しない場合は、ブラウザウィンドウが作成されその名前が割り当てられます。(これらの名前は内部的にのみ使用され、ウィンドウのタイトルフレームは他の場所には表示されないことに注意してください。)

url-string: URL フォーマットのページ、またはページ内におけるスクロール先の行。特定の行にジャンプするリンクを作成するには、#destination-name を参照先の文字列に追加する必要があります。たとえば、

次を入力してファイル c:/work-file/ebusiness.curl がロードされるように指定します。
```
        "file:///c:/work-files/ebusiness.curl"
```
次を入力して同じファイルをロードし、特定の行 — つまり eplumbing の参照先として指定された行にスクロールします。
```
        "file:///c:/work-files/ebusiness.curl#eplumbing"
```
次を入力して現在のファイル (リンクが存在するファイル) 内の特定行にスクロールします。
```
        "#my-dest"
```

link-display: ハイパーリンクとなる表示。Click Me のように単にテキストを入力することができます。{text . . .} を使用してリンクの外観を指定することも可能です

戻り値

リンクを表示する TextVisual。

このオブジェクトは Visual を受け入れられるものであれば追加することができます。

例

例: Creating a Link

{paragraph Just {link href = {url "http://www.curl.com/"}, click me} to get to Curl's Home Page. }

You can control the appearance of the link in the same way that you control other text formatting. Blue color and underline are the default settings for a link.

例: Changing the Appearance of a Link

{paragraph
    Try
    {link
        href = {url "http://www.curl.com/"},
        cursor = cursor-help,
        tooltip = {Tooltip "Welcome to Curl's Home Page!"},
        {text color = "orange", this fancy link}
    }
    also. Check out its tooltip and cursor.
}
{paragraph
    And
    {link
        href = {url "http://www.curl.com/"},
        {text
            color = "black",
            text-underline? = false,
            font-style = "italic",
            font-size = 1.2em,
            this link
        }
    }
    has a completely different style.
}

A hyperlink to a destination within the same applet can have this form:

{link href = {url "#my-dest"}, My Destination}

ビジュアルテスト

このプロシージャにより返されるハイパーリンクは CurlLink ビジュアルテスト型を実装します。

全ての Visual がサポートする既定のビジュアルテストアクションに加え、このクラスのオブジェクトは次のアクションもサポートします。

アクション	引数	説明
Activate	<none>	リンクをアクティベートします。

全ての Visual がサポートする既定のビジュアルテストプロパティに加え、このクラスのオブジェクトは次のプロパティもサポートします。

プロパティ	説明
url:String	リンクの Url 文字列

注意事項

このオブジェクトは、"link"のスタイルルールを記述することでスタイル化することが出来ます。