Hyperlink.NavigateUri プロパティ

定義

Hyperlink がアクティブになったときの移動先の URI を取得または設定します。

public:
 property Uri ^ NavigateUri { Uri ^ get(); void set(Uri ^ value); };
[System.ComponentModel.Bindable(true)]
[System.Windows.Localizability(System.Windows.LocalizationCategory.Hyperlink)]
public Uri NavigateUri { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.Hyperlink)>]
member this.NavigateUri : Uri with get, set
Public Property NavigateUri As Uri

プロパティ値

Uri

がアクティブになったときに移動する Hyperlink URI。 既定値は、null です。

属性

次の例は、 要素の 属性を使用する NavigateUri 方法を Hyperlink 示しています。

<Paragraph>
  <Run>Text preceding the hyperlink.</Run>
  <Hyperlink
    NavigateUri="http://search.msn.com"
  >
    Link text.
  </Hyperlink>
  <Run Name="test">Text following the hyperlink.</Run>
</Paragraph>

次の例では、NavigateUri プロパティをプログラムで設定する方法を示しています。

Paragraph parx = new Paragraph();
Run run1 = new Run("Text preceding the hyperlink.");
Run run2 = new Run("Text following the hyperlink.");
Run run3 = new Run("Link Text.");

Hyperlink hyperl = new Hyperlink(run3);
hyperl.NavigateUri = new Uri("http://search.msn.com");

parx.Inlines.Add(run1);
parx.Inlines.Add(hyperl);
parx.Inlines.Add(run2);
Dim parx As New Paragraph()
Dim run1 As New Run("Text preceeding the hyperlink.")
Dim run2 As New Run("Text following the hyperlink.")
Dim run3 As New Run("Link Text.")

Dim hyperl As New Hyperlink(run3)
hyperl.NavigateUri = New Uri("http://search.msn.com")

parx.Inlines.Add(run1)
parx.Inlines.Add(hyperl)
parx.Inlines.Add(run2)

次の例は 、mailto: uniform resource identifier (URI) を使用して、メール アドレス、メール アドレスと件名、メール アドレス、件名、本文を含む新しいメール ウィンドウを開く方法を示しています。

<Hyperlink NavigateUri="mailto:username@domainname">mailto: With Email Address</Hyperlink>
<Hyperlink NavigateUri="mailto:username@domainname?subject=SubjectText">mailto: With Email Address and Subject</Hyperlink>
<Hyperlink NavigateUri="mailto:username@domainname?subject=SubjectText&body=BodyText">mailto: With Email Address, Subject, and Body</Hyperlink>

注釈

特定のインライン要素にリンクするには、先頭にシャープ記号 (#) が付いた要素名を指定します。

Hyperlinkの直接または間接のNavigateUri親が、または XBAP をホストできる任意のHyperlinkブラウザーを含むNavigationWindowFrameナビゲーション ホストである場合にのみ、 プロパティの値に移動できます。 詳細については、「ナビゲーションの 概要」の「ナビゲーション ホスト」セクションを参照してください。

ユーザーが XBAP の の 上 Hyperlink にマウス ポインターを置くと、 プロパティに NavigateUri 格納されている URI がステータス バーに表示されます。 Hyperlink ユーザーが をクリックすると、この URI に移動します Hyperlink。 ユーザーが をクリックHyperlinkした後、および後続のナビゲーション要求の前にプロパティのNavigateUri値が変更された場合、Hyperlinkプロパティの新しい値はNavigateUri無視され、ユーザーが をクリックHyperlinkしたときにプロパティのNavigateUri値であった URI に移動します。

注意

ナビゲーションを実行するために のみを使用 Hyperlink するように制限されているわけではありません。 添付プロパティも使用NavigateUriできますが、使用FixedPageできるのは、、PathCanvas、、および Glyphsのみです。

依存プロパティ情報

識別子フィールド NavigateUriProperty
に設定されたメタデータ プロパティ true なし

適用対象