Hyperlink Class

ハイパーリンクのホスト機能を備えたインライン レベルのコンテンツ要素を提供します。

継承

Object
  DependencyObject
    TextElement
      Inline
        Span
          Hyperlink

構文


Public NotInheritable Class Hyperlink
    Inherits Span

属性

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

メンバー

Hyperlinkクラス には次の種類のメンバーがあります。

コンストラクター

Hyperlinkクラス にはこれらのコンストラクターがあります。

コンストラクター説明
Hyperlink Initializes a new instance of the Hyperlink class.

 

イベント

Hyperlinkクラス にはこれらのイベントがあります。

イベント説明
Click Occurs when the Hyperlink is clicked.

 

メソッド

The Hyperlink クラス には次のメソッドがあります。 また、以下からもメソッドが継承されます。Object クラス.

メソッド説明
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クラス には次のプロパティがあります。

プロパティアクセスの種類説明

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 の一部となります。Hyperlink は、Span コンテナーにも含めることができます。

Hyperlink のナビゲーション ターゲットを指定するために設定するプロパティ/属性は NavigateUri です。Hyperlink 要素をタップすると、クリックされる NavigateUri の値が URI (Uniform Resource Identifier) の種類とスキーマ用のシステム ハンドラーに渡されます。次にシステムは、NavigateUri で提供される URI のスキーマに登録されたアプリを起動します。

HyperlinkUIElement ではないため、一連の UI 要素の 入力イベント (TappedPointerPressed など) がありません。その代わりに、Hyperlink には独自の Click イベントがあります。システムは、Hyperlink アクションを起動するすべての入力アクションを処理し、応答で Click を起動します。

ハイパーリンクおよびテーマ/スタイル動作

Hyperlink は、FrameworkElement を含んでいないクラス継承を保持しているため、Style プロパティがありません。Hyperlink にも Template (実際のコントロールではありません) はありません。Foreground または FontFamily などの TextElement から継承されるプロパティを編集することによって、Hyperlink の外観を変更できます。しかし、変更を適用するために共通のスタイルまたはテンプレートを使用することはできません。既定以外のプロパティ値を使用する場合は、Hyperlink プロパティの値に対して共通リソースを使用し、Hyperlink プロパティの値に一貫性を持たせることを検討してください。Hyperlink など、Foreground のプロパティの一部は、システムが提供する ThemeResource の既定値を使用します。ユーザーが実行時にシステム テーマを変更するときに、適切な方法で Hyperlink の外観を切り替えることができます。

Hyperlink および HyperlinkButton

HyperlinkHyperlinkButton には、ユーザーが個別のブラウザー アプリケーションを使用して特定の URI を起動できるようにするという類似した目的があります。その相違点は、Hyperlink が、書式付きテキスト (RichTextBlock) に配置できるテキスト要素であるのに対し、HyperlinkButton は、UI 要素またはコントロールを受け入れる任意のレイアウト コンテナー内に配置できるコントロールであることです。HyperlinkButton は、Web 閲覧時の操作性を有効にするカスタム コントロールのコンポジション/テンプレート内で、使用される場合があります。

要件

最小限サポートされるクライアント

Windows 8.1 [Windows ストア アプリのみ]

最小限サポートされるサーバー

Windows Server 2012 R2 [Windows ストア アプリのみ]

名前空間

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

メタデータ

Windows.winmd

参照

Span

 

 

表示:
© 2015 Microsoft