Hyperlink.NavigateUri Vlastnost

Definice

Obor názvů:

System.Windows.Documents

Sestavení:

PresentationFramework.dll

Získá nebo nastaví identifikátor URI, na který přejde při aktivaci Hyperlink .

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

Hodnota vlastnosti

Uri

Identifikátor URI, na který přejdete, Hyperlink když je aktivovaný. Výchozí formát je null.

Atributy

BindableAttribute LocalizabilityAttribute

Příklady

Následující příklad ukazuje, jak použít NavigateUri atribut elementu 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>

Následující příklad ukazuje, jak nastavit NavigateUri vlastnost programově.

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)

Následující příklad ukazuje, jak použít mailto: identifikátor URI (Uniform Resource Identifier) k otevření okna nové pošty, které obsahuje e-mailovou adresu, e-mailovou adresu a předmět a e-mailovou adresu, předmět a text.

<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>

Poznámky

Pokud chcete vytvořit odkaz na konkrétní vložený prvek, zadejte název prvku, kterému předchází symbol libry (#).

Hyperlink může přejít na hodnotu NavigateUri vlastnosti pouze v případě, že přímý nebo nepřímý nadřazený objekt je Hyperlink hostitelem navigace, včetně NavigationWindow, Framenebo libovolného prohlížeče, který může hostovat XBAP. Další informace najdete v části Navigační hostitelé v přehledu navigace.

Když uživatel najede myší na Hyperlink objekt v XBAP, zobrazí se na stavovém řádku identifikátor URI uložený ve NavigateUri vlastnosti. Hyperlink přejde na tento identifikátor URI, když uživatel klikne na Hyperlink. Pokud se hodnota NavigateUri vlastnosti změní po kliknutí uživatele na Hyperlink a před následným navigačním požadavkem, Hyperlink ignoruje novou hodnotu NavigateUri vlastnosti a přejde na identifikátor URI, který byl hodnotou NavigateUri vlastnosti, když uživatel kliknul Hyperlinkna .

Poznámka

Nejste omezeni pouze na použití navigace k úkolům Hyperlink . Můžete také použít připojenou NavigateUri vlastnost, ale pouze z následujících možností: FixedPage, Path, Canvasa Glyphs.

Informace o vlastnosti závislosti

Pole Identifikátor	NavigateUriProperty
Vlastnosti metadat nastavené na true	Žádné