Hyperlink.NavigateUri Hyperlink.NavigateUri Hyperlink.NavigateUri Hyperlink.NavigateUri Property

定義

Hyperlink がアクティブになったときの移動先の URI を取得または設定します。Gets or sets a URI to navigate to when the Hyperlink is activated.

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; }
member this.NavigateUri : Uri with get, set
Public Property NavigateUri As Uri

プロパティ値

Hyperlinkがアクティブになったときの移動先の URI。The URI to navigate to when the Hyperlink is activated. 既定値は、null です。The default is null.

Hyperlinkは、 NavigateUri NavigationWindowの直接または間接の親Frameがナビゲーションホストである場合にのみ、プロパティの値に移動できます。これには、、、またはxbapをホストできる任意のブラウザー(InternetExplorer6とを含む)が含まれます。Hyperlink新しいバージョン、Firefox 2.0 以降)。Hyperlink can navigate to the value of the NavigateUri property only if either the direct or indirect parent of a Hyperlink is a navigation host, including NavigationWindow, Frame, or any browser that can host XBAPs (which includes Internet Explorer 6 and later versions, and Firefox 2.0+). 詳細については、「ナビゲーションの概要」の「ナビゲーションホスト」セクションを参照してください。For more information, see the Navigation Hosts section in Navigation Overview.

要素の属性NavigateUriを使用する方法を次の例に示します。 HyperlinkThe following example shows how to use the NavigateUri attribute of a Hyperlink element.

<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使用してプロパティを設定する方法を示します。The following example shows how to set the NavigateUri property programmatically.

Paragraph parx = new Paragraph();
Run run1 = new Run("Text preceeding 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)uniform resource identifier (URI)を使用して、電子メールアドレス、電子メールアドレスと件名、電子メールアドレス、件名、および本文を含む新しいメールウィンドウを開く方法を示します。The following example shows how to use a mailto:Uniform Resource Identifier (URI)uniform resource identifier (URI) to open a new mail window that contains an email address, an email address and a subject, and an email address, subject, and body.

<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&amp;body=BodyText">mailto: With Email Address, Subject, and Body</Hyperlink>

注釈

特定のインライン要素にリンクするには、要素名の前にシャープ記号 (#) を指定します。To link to a particular inline element, specify the element name preceded by a pound symbol (#).

ユーザー Hyperlinkがのの上XBAPXBAPにマウスポインターを置くとNavigateUriURIURIプロパティに格納されているがステータスバーに表示されます。When a user hovers the mouse over a Hyperlink in an XBAPXBAP, the URIURI stored in the NavigateUri property is displayed in the status bar. HyperlinkユーザーがをURIURIクリックしたときにHyperlink、このに移動します。Hyperlink navigates to this URIURI when the user clicks the Hyperlink. ユーザーがをHyperlinkクリックしNavigateUriた後、後続のナビゲーション要求の前にプロパティの値がHyperlink変更された場合、 NavigateUriは、プロパティの新しいURIURI値を無視し、その値であったに移動します。ユーザーがをHyperlinkクリックしたときのプロパティの。NavigateUriIf the value of the NavigateUri property changes after the user clicks the Hyperlink and before the subsequent navigation request, Hyperlink ignores the new value of the NavigateUri property and navigates to the URIURI that was the value of the NavigateUri property when the user clicked the Hyperlink.

注意

を使用した移動のみに制限Hyperlinkされているわけではありません。You are not restricted to only using a Hyperlink to do navigation. NavigateUri添付プロパティも使用できますが、、、 Canvas、およびGlyphsのみFixedPage Pathを使用できます。You can use the NavigateUri attached property as well, but only from the following: FixedPage, Path, Canvas, and Glyphs.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field NavigateUriProperty
メタデータプロパティがに設定されるtrueMetadata properties set to true NoneNone

適用対象