Hyperlink.NavigateUri 속성

정의

네임스페이스:

System.Windows.Documents

어셈블리:

PresentationFramework.dll

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입니다.

특성

BindableAttribute LocalizabilityAttribute

예제

다음 예제에서는 요소의 NavigateUriHyperlink 특성을 사용하는 방법을 보여줍니다.

<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 를 사용하는 방법을 보여 줍니다. URI(Uniform Resource Identifier)는 전자 메일 주소, 전자 메일 주소 및 제목, 전자 메일 주소, 제목 및 본문이 포함된 새 메일 창을 엽니다.

<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의 직접 또는 간접 부모가 Hyperlink , Frame또는 XBAP를 호스트할 수 있는 브라우저를 포함한 NavigationWindow탐색 호스트인 경우에만 속성 값 NavigateUri 으로 이동할 수 있습니다. 자세한 내용은 탐색 개요의 탐색 호스트 섹션을 참조 하세요.

사용자가 XBAP의 을 마우스로 Hyperlink 가리키면 속성에 NavigateUri 저장된 URI가 상태 표시줄에 표시됩니다. Hyperlink 는 사용자가 를 클릭하면 이 URI로 Hyperlink이동합니다. 사용자가 를 클릭하고 Hyperlink 이후 탐색 요청 Hyperlink 전에 속성 값 NavigateUri 이 변경되면 속성의 NavigateUri 새 값을 무시하고 사용자가 를 클릭Hyperlink할 때 속성 값 NavigateUri 인 URI로 이동합니다.

참고

를 사용하여 Hyperlink 탐색을 수행하도록 제한되지 않습니다. 연결된 속성도 사용할 수 있지만 , , PathCanvas및 Glyphs에서FixedPage만 사용할 NavigateUri 수 있습니다.

종속성 속성 정보

식별자 필드	NavigateUriProperty
메타 데이터 속성 설정 true	없음