Hyperlink 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
內嵌層級動態內容項目，可提供裝載動態內容內超連結的能力。
public ref class Hyperlink : System::Windows::Documents::Span, System::Windows::Input::ICommandSource, System::Windows::Markup::IUriContext[System.Windows.Documents.TextElementEditingBehavior(IsMergeable=false, IsTypographicOnly=false)]
public class Hyperlink : System.Windows.Documents.Span, System.Windows.Input.ICommandSource, System.Windows.Markup.IUriContext[<System.Windows.Documents.TextElementEditingBehavior(IsMergeable=false, IsTypographicOnly=false)>]
type Hyperlink = class
inherit Span
interface ICommandSource
interface IUriContextPublic Class Hyperlink
Inherits Span
Implements ICommandSource, IUriContext- 繼承
- 屬性
- 實作
範例
下列範例顯示元素的 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>
下列範例示範如何以程式設計方式建立 Hyperlink 。
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)
備註
Hyperlink 會 NavigateUri 實作您使用 Uri 按兩下超連結時，應該巡覽至之內容的屬性。 Hyperlink不過，如果的直接或間接父代是導覽主機，包括NavigationWindow、 Frame或任何可裝載 XBAP 的Hyperlink瀏覽器，則只能進行導覽。 如需詳細資訊，請參閱導覽概觀中的導覽主機主題。
Hyperlink 會強制執行子內容的強式內容模型。 如需內容模型的詳細資訊，Hyperlink請參閱 TextElement 內容模型概觀。
此控件的相依性屬性可能是由控件的默認樣式所設定。 如果屬性是以預設樣式設定，當控件出現在應用程式中時，屬性可能會從其預設值變更。 默認樣式取決於應用程式執行時所使用的桌面主題。
建構函式
| Hyperlink() |
初始化 Hyperlink 類別的新預設執行個體。 |
| Hyperlink(Inline) | |
| Hyperlink(Inline, TextPointer) |
初始化 Hyperlink 類別的新執行個體，並將指定的 Inline 物件做為新 Hyperlink 的初始內容，以及會替新 TextPointer 指定插入位置的 Hyperlink。 |
| Hyperlink(TextPointer, TextPointer) |
初始化 Hyperlink 類別的新執行個體，並採用兩個 TextPointer 物件，該物件表示新 Hyperlink 要包含之內容選取範圍的開頭及結尾。 |
欄位
| ClickEvent |
識別 Click 路由事件。 |
| CommandParameterProperty |
識別 CommandParameter 相依性屬性。 |
| CommandProperty |
識別 Command 相依性屬性。 |
| CommandTargetProperty |
識別 CommandTarget 相依性屬性。 |
| NavigateUriProperty |
識別 NavigateUri 相依性屬性。 |
| RequestNavigateEvent |
識別 RequestNavigate 路由事件。 |
| TargetNameProperty |
識別 TargetName 相依性屬性。 |
屬性
| AllowDrop |
取得或設定值，這個值表示這個項目是否可以作為拖放作業的目標。 (繼承來源 ContentElement) |
| AreAnyTouchesCaptured |
取得值，這個值表示是否至少有一個觸控擷取至這個項目。 (繼承來源 ContentElement) |
| AreAnyTouchesCapturedWithin |
取得值，這個值表示是否至少有一個觸控擷取至這個項目或其視覺化樹狀結構中的任何子項目。 (繼承來源 ContentElement) |
| AreAnyTouchesDirectlyOver |
取得值，這個值表示是否至少有一個觸控在這個項目上按下。 (繼承來源 ContentElement) |
| AreAnyTouchesOver |
取得值，這個值表示是否至少有一個觸控在這個項目或其視覺化樹狀結構中的任何子項目上按下。 (繼承來源 ContentElement) |
| Background |
取得或設定用來填滿內容區域背景的筆刷。 (繼承來源 TextElement) |
| BaselineAlignment |
取得或設定用於 Inline 項目的基準線對齊。 (繼承來源 Inline) |
| BaseUri |
取得或設定 Hyperlink 的基底 URI。 |
| BindingGroup |
取得或設定用於項目的 BindingGroup。 (繼承來源 FrameworkContentElement) |
| Command |
取得或設定要與 Hyperlink 產生關聯的命令。 |
| CommandBindings |
取得與這個項目關聯之 CommandBinding 物件的集合。 (繼承來源 ContentElement) |
| CommandParameter |
取得或設定與 Command 屬性所指定之命令關聯的命令參數。 |
| CommandTarget |
取得或設定目標項目，在這個項目上會執行 Command 屬性所指定的命令。 |
| ContentEnd |
取得代表元素中內容結尾的文字指標。 (繼承來源 TextElement) |
| ContentStart |
取得代表元素中內容開頭的文字指標。 (繼承來源 TextElement) |
| ContextMenu |
取得或設定每當透過使用者介面 (UI 要求操作功能表時，應該顯示的內容功能表元素) 在此元素內。 (繼承來源 FrameworkContentElement) |
| Cursor |
取得或設定滑鼠指標在此元素上方時所顯示的游標。 (繼承來源 FrameworkContentElement) |
| DataContext |
取得或設定項目在參與資料繫結時的資料內容。 (繼承來源 FrameworkContentElement) |
| DefaultStyleKey |
取得或設定索引鍵，以用來在佈景主題中尋找這個控制項的樣式樣板。 (繼承來源 FrameworkContentElement) |
| DependencyObjectType |
取得包裝 DependencyObjectType 這個實體 CLR 型別的 。 (繼承來源 DependencyObject) |
| Dispatcher |
取得與這個 Dispatcher 關聯的 DispatcherObject。 (繼承來源 DispatcherObject) |
| ElementEnd |
取得代表緊接在元素結尾後面位置的文字指標。 (繼承來源 TextElement) |
| ElementStart |
取得代表緊接在元素開頭前面位置的文字指標。 (繼承來源 TextElement) |
| FlowDirection |
取得或設定值，這個值指定 Inline 項目中內容的相對流向。 (繼承來源 Inline) |
| Focusable |
取得或設定元素是否能夠接收焦點的值。 (繼承來源 ContentElement) |
| FocusVisualStyle |
取得或設定物件，這個物件可自訂外觀、效果或其他樣式特性，以在這個項目捕捉到鍵盤焦點時套用至此項目。 (繼承來源 FrameworkContentElement) |
| FontFamily |
取得或設定項目內容慣用的最上層字型家族。 (繼承來源 TextElement) |
| FontSize |
取得或設定項目內容的字型大小。 (繼承來源 TextElement) |
| FontStretch |
取得或設定項目內容的字型自動縮放特性。 (繼承來源 TextElement) |
| FontStyle |
取得或設定項目內容的字型樣式。 (繼承來源 TextElement) |
| FontWeight |
取得或設定項目內容的最上層字型粗細。 (繼承來源 TextElement) |
| ForceCursor |
取得或設定值，指出這 FrameworkContentElement 是否應該強制使用者介面 (UI) ，將游標轉譯為這個實例的 Cursor 屬性所宣告。 (繼承來源 FrameworkContentElement) |
| Foreground |
取得或設定要套用至項目內容的筆刷。 (繼承來源 TextElement) |
| HasAnimatedProperties |
取得值，指出這個項目是否有任何動畫屬性。 (繼承來源 ContentElement) |
| Inlines |
取得包含最上層 Inline 項目的 InlineCollection，這些項目組成 Span 的內容。 (繼承來源 Span) |
| InputBindings |
取得與這個項目關聯的輸入繫結集合。 (繼承來源 ContentElement) |
| InputScope |
取得或設定此 FrameworkContentElement 使用的輸入內容。 (繼承來源 FrameworkContentElement) |
| IsEnabled |
取得或設定值，這個值表示是否在使用者介面中啟用這個專案 (UI) 。 (繼承來源 ContentElement) |
| IsEnabledCore |
取得值，這個值表示是否啟用 Hyperlink。 |
| IsFocused |
取得值，決定這個項目是否具有邏輯焦點。 (繼承來源 ContentElement) |
| IsInitialized |
取得值，指出是否已初始化這個專案，方法是載入為可延伸的應用程式標記語言 (XAML) ，或明確呼叫其 EndInit() 方法。 (繼承來源 FrameworkContentElement) |
| IsInputMethodEnabled |
取得值，這個值表示是否啟用輸入法系統，例如輸入法 編輯器 (輸入) 輸入。 (繼承來源 ContentElement) |
| IsKeyboardFocused |
取得值，指出這個項目是否具有鍵盤焦點。 (繼承來源 ContentElement) |
| IsKeyboardFocusWithin |
取得值，這個值表示鍵盤焦點是否在項目內或子項目內的任意處。 (繼承來源 ContentElement) |
| IsLoaded |
取得值，這個值表示此項目是否已載入以供展示。 (繼承來源 FrameworkContentElement) |
| IsMouseCaptured |
取得值，這個值表示滑鼠是否由這個項目所捕捉。 (繼承來源 ContentElement) |
| IsMouseCaptureWithin |
取得值，決定滑鼠捕捉是否由這個項目或其項目樹狀結構中的子項目所保留。 (繼承來源 ContentElement) |
| IsMouseDirectlyOver |
取得值，指出滑鼠指標位置是否與點擊測試結果對應，該結果會將複合項目納入考量。 (繼承來源 ContentElement) |
| IsMouseOver |
取得值，這個值表示滑鼠指標是否位於這個項目上方 (包括視覺子項目或其複合控制項)。 (繼承來源 ContentElement) |
| IsSealed |
取得值，這個值表示此執行個體目前是否已密封 (唯讀)。 (繼承來源 DependencyObject) |
| IsStylusCaptured |
取得值，指出是否將手寫筆擷取至這個項目。 (繼承來源 ContentElement) |
| IsStylusCaptureWithin |
取得值，這個值決定手寫筆捕捉是否由這個項目 (包括子項目和複合控制項) 保有。 (繼承來源 ContentElement) |
| IsStylusDirectlyOver |
取得值，指出手寫筆位置是否與點擊測試結果相對應，該結果會將複合項目納入考量。 (繼承來源 ContentElement) |
| IsStylusOver |
取得值，這個值表示手寫筆是否位於這個項目上方 (包括視覺化子項目)。 (繼承來源 ContentElement) |
| Language |
取得或設定套用至個別項目的當地語系化/全球化語言資訊。 (繼承來源 FrameworkContentElement) |
| LogicalChildren |
取得可反覆查看項目之邏輯子系的列舉值。 (繼承來源 TextElement) |
| Name |
取得或設定項目的識別名稱。 此名稱會提供實例參考，讓程式設計程式代碼後置，例如事件處理程式程式代碼，可以在 XAML 剖析期間建構專案時參考元素。 (繼承來源 FrameworkContentElement) |
| NavigateUri |
取得或設定啟動 Hyperlink 時要所要巡覽的 URI。 |
| NextInline |
取得下一個此項目之對等的 Inline 項目。 (繼承來源 Inline) |
| OverridesDefaultStyle |
取得或設定值，這個值表示此項目是否會併入佈景主題樣式中的樣式屬性。 (繼承來源 FrameworkContentElement) |
| Parent |
取得此項目之邏輯樹狀中的父代。 (繼承來源 FrameworkContentElement) |
| PreviousInline |
取得上一個此項目之對等的 Inline 項目。 (繼承來源 Inline) |
| Resources |
取得或設定目前本機定義的資源字典。 (繼承來源 FrameworkContentElement) |
| SiblingInlines |
取得 InlineCollection，其中包含的 Inline 項目是此項目的同層級 (對等)。 (繼承來源 Inline) |
| Style |
取得或設定這個項目要使用的樣式。 (繼承來源 FrameworkContentElement) |
| Tag |
取得或設定可以用來儲存關於此元素自訂資訊的任意物件值。 (繼承來源 FrameworkContentElement) |
| TargetName |
取得或設定 Hyperlink 之目標視窗或框架的名稱。 |
| TemplatedParent |
取得這個項目的範本父代參考。 若此項目不是透過範本建立，則這個屬性不相關。 (繼承來源 FrameworkContentElement) |
| TextDecorations |
取得 TextDecorationCollection，包含要套用至這個項目的文字裝飾。 (繼承來源 Inline) |
| TextEffects |
取得或設定要套用至項目內容的文字效果集合。 (繼承來源 TextElement) |
| ToolTip |
取得或設定使用者介面中顯示此元素的工具提示物件， (UI) 。 (繼承來源 FrameworkContentElement) |
| TouchesCaptured |
取得已擷取至這個項目的所有觸控裝置。 (繼承來源 ContentElement) |
| TouchesCapturedWithin |
取得已擷取至這個項目或其視覺化樹狀結構中之任何子項目的所有觸控裝置。 (繼承來源 ContentElement) |
| TouchesDirectlyOver |
取得在這個項目上停留的所有觸控裝置。 (繼承來源 ContentElement) |
| TouchesOver |
取得在這個項目或其視覺化樹狀結構中之任何子項目上停留的所有觸控裝置。 (繼承來源 ContentElement) |
| Typography |
為項目內容指定目前有效的印刷樣式變化。 (繼承來源 TextElement) |
方法
事件
明確介面實作
| IAddChild.AddChild(Object) |
加入子物件。 (繼承來源 TextElement) |
| IAddChild.AddText(String) |
將節點的文字內容加入物件中。 (繼承來源 TextElement) |
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
如需這個成員的描述，請參閱 IsAmbientPropertyAvailable(String) 方法。 (繼承來源 FrameworkContentElement) |
| IUriContext.BaseUri |
取得或設定 Hyperlink 的基底 URI。 |
