Hyperlink.NavigateUri Tulajdonság

Definíció

Névtér:

System.Windows.Documents

Szerelvény:

PresentationFramework.dll

Lekéri vagy beállítja az URI-t, hogy az aktiváláskor Hyperlink navigáljon.

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

Tulajdonság értéke

Uri

Az aktivált Hyperlink URI. Az alapértelmezett érték a null.

Attribútumok

BindableAttribute LocalizabilityAttribute

Példák

Az alábbi példa egy elem attribútumának NavigateUri használatát Hyperlink mutatja be.

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

Az alábbi példa bemutatja, hogyan állíthatja be a NavigateUri tulajdonságot programozott módon.

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)

Az alábbi példa bemutatja, hogyan használható a levelezés: egységes erőforrás-azonosító (URI) egy új e-mail-ablak megnyitásához, amely egy e-mail-címet, egy e-mail-címet és egy tárgyat, valamint egy e-mail-címet, tárgyat és törzset tartalmaz.

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

Megjegyzések

Ha egy adott beágyazott elemre szeretne hivatkozni, adja meg az elem nevét, amelyet egy font szimbólum (#) előz meg.

Hyperlink csak akkor tud a tulajdonság értékére NavigateUri navigálni, ha egy navigációs gazdagép közvetlen vagy közvetett szülője Hyperlink , beleértve NavigationWindowaz XBAP-k Frameüzemeltetésére képes böngészőt is. További információkért tekintse meg a Navigációs gazdagépek szakaszt a Navigációs áttekintésben.

Amikor egy felhasználó egy XBAP-ben rámutat az Hyperlink egérre, a tulajdonságban NavigateUri tárolt URI megjelenik az állapotsoron. Hyperlink erre az URI-ra navigál, amikor a felhasználó a Hyperlinkikonra kattint. Ha a tulajdonság értéke megváltozik, NavigateUri miután a felhasználó a következő navigációs kérelemre kattintHyperlink, figyelmen kívül hagyja a Hyperlink tulajdonság új értékét, NavigateUri és arra az URI-ra lép, amely a NavigateUri tulajdonság értéke volt, amikor a felhasználó a Hyperlinktulajdonságra kattintott.

Note

Nem csak a navigációs műveletekre Hyperlink korlátozódik. A csatolt tulajdonságot is használhatja NavigateUri , de csak a következőkből: FixedPage, Path, Canvasés Glyphs.

Függőségi tulajdonság adatai

Termék	Érték
Azonosító mező	NavigateUriProperty
Metaadat-tulajdonságok beállítása: true	None