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

예제

다음 예제에서는 요소의 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 를 사용하는 방법을 보여 줍니다. 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는 A의 NavigateUri 직접 또는 간접 부모가 Hyperlink 탐색 호스트(예NavigationWindowFrame: 탐색 호스트) 또는 XBAP를 호스트할 수 있는 브라우저(Internet Explorer 6 이상 버전 및 Firefox 2.0 이상 포함)인 경우에만 속성 값으로 이동할 수 있습니다. 자세한 내용은 탐색 개요의 탐색 호스트 섹션을 참조 하세요.

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

참고

탐색을 수행하는 데만 사용하도록 Hyperlink 제한되지 않습니다. 연결된 속성도 사용할 수 있지만 다음GlyphsCanvasPathFixedPage에서만 사용할 NavigateUri 수 있습니다.

종속성 속성 정보

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