하이퍼링크 Class

하이퍼링크를 호스팅하기 위한 기능을 제공하는 인라인 수준의 콘텐츠 요소를 제공합니다.

상속

Object
  DependencyObject
    TextElement
      Inline
        Span
          Hyperlink

구문


public sealed class Hyperlink : Span

특성

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06030000)]
[WebHostHidden()]

멤버

Hyperlink클래스에는 다음과 같은 형식의 멤버가 있습니다.

생성자

Hyperlink클래스에는 다음과 같은 생성자가 있습니다.

생성자Description
Hyperlink Initializes a new instance of the Hyperlink class.

 

이벤트

Hyperlink클래스에는 다음과 같은 이벤트가 있습니다.

이벤트Description
Click Occurs when the Hyperlink is clicked.

 

메서드

The Hyperlink 클래스 - 이러한 메서드가 있습니다. 다음 위치의 메서드도 상속합니다. Object 클래스.

메서드Description
ClearValue Clears the local value of a dependency property. (다음에서 상속됨 DependencyObject)
FindName Retrieves an object in the object model / runtime object graph by referencing the object's x:Name or Name attribute value. (다음에서 상속됨 TextElement)
GetAnimationBaseValue Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (다음에서 상속됨 DependencyObject)
GetValue Returns the current effective value of a dependency property from a DependencyObject. (다음에서 상속됨 DependencyObject)
OnDisconnectVisualChildren Override this method to implement how layout and logic should behave when items are removed from a class-specific content or child property. (다음에서 상속됨 TextElement)
ReadLocalValue Returns the local value of a dependency property, if a local value is set. (다음에서 상속됨 DependencyObject)
SetValue Sets the local value of a dependency property on a DependencyObject. (다음에서 상속됨 DependencyObject)

 

속성

Hyperlink클래스 - 이러한 속성이 있습니다.

속성사용 권한Description

CharacterSpacing

읽기/쓰기Gets or sets the uniform spacing between characters, in units of 1/1000 of an em. (다음에서 상속됨 TextElement)

ContentEnd

읽기 전용Gets a TextPointer that represents the end of the content in the element. (다음에서 상속됨 TextElement)

ContentStart

읽기 전용Gets a TextPointer that represents the start of content in the element. (다음에서 상속됨 TextElement)

Dispatcher

읽기 전용Gets the CoreDispatcher that this object is associated with. (다음에서 상속됨 DependencyObject)

ElementEnd

읽기 전용Gets a TextPointer that represents the position just after the end of the element. (다음에서 상속됨 TextElement)

ElementStart

읽기 전용Gets a TextPointer that represents the position just before the start of the element. (다음에서 상속됨 TextElement)

FontFamily

읽기/쓰기Gets or sets the preferred top-level font family for the content of the element. (다음에서 상속됨 TextElement)

FontSize

읽기/쓰기Gets or sets the font size for the content of the element. (다음에서 상속됨 TextElement)

FontStretch

읽기/쓰기Gets or sets the glyph width of the font in a family to select. (다음에서 상속됨 TextElement)

FontStyle

읽기/쓰기Gets or sets the font style for the content in this element. (다음에서 상속됨 TextElement)

FontWeight

읽기/쓰기Gets or sets the top-level font weight to select from the font family for the content in this element. (다음에서 상속됨 TextElement)

Foreground

읽기/쓰기Gets or sets the Brush to apply to the content in this element. (다음에서 상속됨 TextElement)

Inlines

읽기/쓰기Gets an InlineCollection containing the top-level inline elements that include the contents of Span. (다음에서 상속됨 Span)

Language

읽기/쓰기Gets or sets localization/globalization language information that applies to a TextElement. (다음에서 상속됨 TextElement)

Name

읽기 전용Gets or sets a unique identification for the object. Name can only be set from initial parsing of XAML. (다음에서 상속됨 TextElement)

NavigateUri

읽기/쓰기Gets or sets the Uniform Resource Identifier (URI) to navigate to when the Hyperlink is activated.

NavigateUriProperty

읽기 전용Identifies the NavigateUri dependency property.

 

설명

Hyperlink 요소는 Inline 파생 클래스입니다. 따라서 InlineCollection에 배치할 수 있습니다. 다른 컨테이너 내에서 RichTextBlock 또는 RichEditBox의 텍스트 콘텐츠의 일부가 되어야 합니다. 예를 들어 XAML의 Hyperlink 개체 요소가 Paragraph 콘텐츠 내부의 한 요소일 수 있습니다. 이때 XAML 콘텐츠는 ParagraphInlines XAML 콘텐츠 속성에 대한 암시적 InlineCollection에 포함됩니다. HyperlinkSpan 컨테이너에 포함할 수 있습니다.

Hyperlink의 탐색 대상을 지정하기 위해 설정하는 속성/특성은 NavigateUri입니다. 사용자가 Hyperlink 요소를 누르면 URI(Uniform Resource Identifier) 형식 및 체계의 시스템 처리기로 NavigateUri가 전달됩니다. 그러면 시스템에서는 NavigateUri에 대해 제공된 URI의 스키마에 등록된 앱을 실행합니다.

HyperlinkUIElement가 아니기 때문에 Tapped, PointerPressed 등의 UI 요소 입력 이벤트가 없습니다. 대신 Hyperlink에 자체 Click 이벤트가 있습니다. 시스템에서는 Hyperlink 작업을 호출해야 하는 모든 입력 작업을 처리한 후 그에 대한 응답으로 Click 이벤트를 발생시킵니다.

하이퍼링크 및 테마/스타일 동작

Hyperlink에는 FrameworkElement를 포함하지 않는 클래스 상속이 있으므로 Style 속성이 없습니다. 또한 Hyperlink에는 Template도 없습니다(실제 컨트롤이 아님). Foreground 또는 FontFamily처럼 TextElement에서 상속되는 속성을 편집하여 Hyperlink의 모양을 변경할 수 있지만 공통 스타일 또는 템플릿을 사용하여 변경 사항을 적용할 수는 없습니다. 속성 값으로 기본값 이외의 다른 값을 사용할 경우 Hyperlink 속성 값에 공용 리소스를 사용하여 Hyperlink 속성 값을 일관적으로 유지하는 것이 좋습니다. Foreground와 같은 Hyperlink의 일부 속성은 시스템에서 제공하는 ThemeResource 값의 기본값을 사용합니다. 이렇게 하면 사용자가 런타임에 시스템 테마를 변경할 경우 Hyperlink 모양이 적절하게 변경됩니다.

HyperlinkHyperlinkButton

HyperlinkHyperlinkButton는 그 목적이 비슷합니다. 사용자가 별도의 브라우저 앱을 사용하여 특정 URI를 시작하도록 하는 것입니다. 차이점은 Hyperlink는 서식이 지정된 텍스트(예: RichTextBlock)에 넣을 수 있는 텍스트 요소이고, HyperlinkButton은 UI 요소 또는 컨트롤을 허용하는 레이아웃 컨테이너 안에 놓을 수 있는 컨트롤입니다. HyperlinkButton는 웹 검색 경험을 가능하게 하는 사용자 지정 컨트롤의 컴퍼지션/템플릿 내에서 사용할 수 있습니다.

요구 사항

지원되는 최소 클라이언트

Windows 8.1 [Windows 스토어 앱만]

지원되는 최소 서버

Windows Server 2012 R2 [Windows 스토어 앱만]

Namespace

Windows.UI.Xaml.Documents
Windows::UI::Xaml::Documents [C++]

Metadata

Windows.winmd

참고 항목

Span

 

 

표시:
© 2015 Microsoft