NavigationWindow 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示支援內容瀏覽的視窗。
public ref class NavigationWindow : System::Windows::Windowpublic ref class NavigationWindow : System::Windows::Window, System::Windows::Markup::IUriContext[System.Windows.Markup.ContentProperty]
[System.Windows.TemplatePart(Name="PART_NavWinCP", Type=typeof(System.Windows.Controls.ContentPresenter))]
public class NavigationWindow : System.Windows.Window[System.Windows.Markup.ContentProperty]
[System.Windows.TemplatePart(Name="PART_NavWinCP", Type=typeof(System.Windows.Controls.ContentPresenter))]
public class NavigationWindow : System.Windows.Window, System.Windows.Markup.IUriContext[<System.Windows.Markup.ContentProperty>]
[<System.Windows.TemplatePart(Name="PART_NavWinCP", Type=typeof(System.Windows.Controls.ContentPresenter))>]
type NavigationWindow = class
inherit Window[<System.Windows.Markup.ContentProperty>]
[<System.Windows.TemplatePart(Name="PART_NavWinCP", Type=typeof(System.Windows.Controls.ContentPresenter))>]
type NavigationWindow = class
inherit Window
interface IUriContextPublic Class NavigationWindow
Inherits WindowPublic Class NavigationWindow
Inherits Window
Implements IUriContext- 繼承
-
NavigationWindow
- 屬性
- 實作
範例
下列範例示範如何建立 NavigationWindow。
<NavigationWindow
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
x:Class="MainWindow"
Title="NavigationWindow Sample"
Source="http://www.microsoft.com" />
備註
NavigationWindow 衍生自 Window，並透過巡覽和顯示內容的能力來擴充它。
內容可以是任何 .NET Framework 物件或 HTML 檔案。 不過，一般而言，Page 對像是封裝流覽內容的慣用方式。
您可以使用所需內容的 URI 來設定 Source 屬性，以巡覽至內容。 此外，您可以使用下列其中一個 Navigate 方法的多載來瀏覽內容：
當內容依 URI 巡覽至時，NavigationWindow 會傳回包含內容的物件。
注意
依 URI 瀏覽也支援瀏覽至內容片段。 請參閱 FragmentNavigation。
或者，您可以使用接受 物件的其中一個 Navigate 方法多載來瀏覽內容：
瀏覽的存留期可透過下列事件進行追蹤：
並非所有事件都會在每次巡覽時引發;引發的事件集取決於發生瀏覽的類型（內容或內容片段），以及導覽完成方式（已取消、停止或失敗）。
下圖說明這些事件將引發的順序：
在瀏覽期間或之後，NavigationWindow 提供所巡覽內容的相關信息，包括巡覽至的內容 URI（Source）、目前內容的 URI（CurrentSource），以及包含所巡覽內容的物件（Content）。
當內容流覽至時，NavigationWindow 將瀏覽記錄為導覽歷程記錄中的專案。 當新的巡覽發生時，會將專案新增至返回瀏覽歷程記錄，方法是呼叫 Navigate 方法，或藉由呼叫 GoForward巡覽至正嚮導覽歷程記錄中的專案。 藉由呼叫 GoBack，藉由巡覽至返回導覽歷程記錄中的專案，將專案新增至向前瀏覽歷程記錄。 CanGoBack 和 CanGoForward 分別報告是否有回溯和向前瀏覽歷程記錄中的專案。
第一次從另一個內容片段巡覽至某個內容時，NavigationWindow 會自動顯示流覽UI，讓使用者透過瀏覽歷程記錄來回流覽。 您可以藉由設定 ShowsNavigationUI 屬性來設定瀏覽 UI 的顯示時機。
呼叫 RemoveBackEntry，即可移除返回瀏覽歷程記錄中最新的專案。
NavigationWindow 不會將內容對象的實例儲存在瀏覽歷程記錄中。 相反地，NavigationWindow 每次使用瀏覽歷程記錄流覽至內容物件時，都會建立內容物件的新實例。 此行為旨在避免大量和大量內容巡覽至時過度耗用記憶體。 因此，從一個流覽到下一個導覽時，不會記住內容的狀態。 不過，WPF 提供數種技術，可讓您在瀏覽歷程記錄中儲存一段內容的狀態片段。
使用 AddBackEntry，您也可以記住單一頁面實例的多個狀態集。
NavigationWindow 是 WPF 中兩個導覽器的其中一個，另一個是 Frame。 基本上，導覽器是支援瀏覽和瀏覽歷程記錄的類別。 以可視化方式，XBAP 會使用 Internet Explorer 作為導覽器，以提供整合式用戶體驗。 不過，XBAP 實際上使用 NavigationWindow 作為導覽器;在 Internet Explorer 中執行之 XBAP 的 MainWindow 屬性會傳回 NavigationWindow的參考，而由 NavigationWindow 管理的瀏覽歷程記錄會與 Internet Explorer 所管理的瀏覽歷程記錄整合。
內容模型：NavigationWindow 是 ContentControl，這表示 NavigationWindow 可以包含文字、影像或面板等內容。 此外，NavigationWindow 是根元素，因此不能是另一個元素內容的一部分。 如需 Button內容模型的詳細資訊，請參閱 WPF 內容模型。
自訂 NavigationWindow 控制件
若要將相同的屬性設定套用至多個 NavigationWindow 控件，請使用 Style 屬性。 您可以修改預設 ControlTemplate，讓控件具有唯一的外觀。 如需建立 ControlTemplate的詳細資訊，請參閱 透過建立 ControlTemplate自定義現有控件的外觀。 若要查看 NavigationWindow特有的元件和狀態，請參閱 NavigationWindow 樣式和範本。
此控件的相依性屬性可能由控件的預設樣式設定。 如果屬性是以預設樣式設定，當控件出現在應用程式中時，屬性可能會從其預設值變更。 默認樣式取決於應用程式執行時所使用的桌面主題。
注意
如果該屬性同時存在於控件的默認範本中，而且是使用templateBinding 來設定，則設定可視化屬性只會有效果。 您可以在 建立 ControlTemplate 一文中的 變更控件 的視覺結構一節中找到視覺效果屬性清單。
建構函式
| NavigationWindow() |
初始化 NavigationWindow 類別的新實例。 |
欄位
| BackStackProperty |
識別 BackStack 相依性屬性。 |
| CanGoBackProperty |
識別 CanGoBack 相依性屬性。 |
| CanGoForwardProperty |
識別 CanGoForward 相依性屬性。 |
| ForwardStackProperty |
識別 ForwardStack 相依性屬性。 |
| SandboxExternalContentProperty |
識別 SandboxExternalContent 相依性屬性。 |
| ShowsNavigationUIProperty |
識別 ShowsNavigationUI 相依性屬性。 |
| SourceProperty |
識別 Source 相依性屬性。 |
屬性
| ActualHeight |
取得這個項目的轉譯高度。 (繼承來源 FrameworkElement) |
| ActualWidth |
取得這個元素的轉譯寬度。 (繼承來源 FrameworkElement) |
| AllowDrop |
取得或設定值，指出這個元素是否可以當做拖放作業的目標使用。 這是相依性屬性。 (繼承來源 UIElement) |
| AllowsTransparency |
取得或設定值，這個值表示視窗的工作區是否支持透明度。 (繼承來源 Window) |
| AreAnyTouchesCaptured |
取得值，這個值表示是否至少擷取一個觸控到這個專案。 (繼承來源 UIElement) |
| AreAnyTouchesCapturedWithin |
取得值，這個值表示是否至少擷取一個觸控至這個專案，或是擷取至其可視化樹狀結構中的任何子專案。 (繼承來源 UIElement) |
| AreAnyTouchesDirectlyOver |
取得值，這個值表示是否在這個元素上按下至少一個觸控。 (繼承來源 UIElement) |
| AreAnyTouchesOver |
取得值，這個值表示是否至少在這個專案或其可視化樹狀結構中的任何子專案上按下一個觸控。 (繼承來源 UIElement) |
| Background |
取得或設定描述控制件背景的筆刷。 (繼承來源 Control) |
| BackStack |
取得 IEnumerable，您用來列舉 NavigationWindow的返回瀏覽歷程記錄中的專案。 |
| BindingGroup |
取得或設定用於 專案的 BindingGroup。 (繼承來源 FrameworkElement) |
| BitmapEffect |
已淘汰.
已淘汰.
取得或設定直接套用至這個項目轉譯內容的點陣圖效果。 這是相依性屬性。 (繼承來源 UIElement) |
| BitmapEffectInput |
已淘汰.
已淘汰.
取得或設定位圖效果的輸入來源，該效果會直接套用至這個專案的轉譯內容。 這是相依性屬性。 (繼承來源 UIElement) |
| BorderBrush |
取得或設定描述控制件框線背景的筆刷。 (繼承來源 Control) |
| BorderThickness |
取得或設定控件的框線粗細。 (繼承來源 Control) |
| CacheMode |
取得或設定 UIElement的快取表示法。 (繼承來源 UIElement) |
| CanGoBack |
取得值，這個值表示返回瀏覽歷程記錄中是否有至少一個專案。 |
| CanGoForward |
取得值，指出向前瀏覽歷程記錄中是否有至少一個專案。 |
| Clip |
取得或設定用來定義項目內容的外框的幾何。 這是相依性屬性。 (繼承來源 UIElement) |
| ClipToBounds |
取得或設定值，指出是否要裁剪這個元素的內容（或來自這個專案的子項目的內容），以符合包含專案的大小。 這是相依性屬性。 (繼承來源 UIElement) |
| CommandBindings |
取得與這個項目相關聯的 CommandBinding 物件集合。 CommandBinding 會啟用這個專案的命令處理，並宣告命令、其事件和這個專案所附加之處理程式之間的連結。 (繼承來源 UIElement) |
| Content |
取得或設定 ContentControl的內容。 (繼承來源 ContentControl) |
| ContentStringFormat |
取得或設定複合字串，指定當屬性顯示為字串時，如何格式化 Content 屬性。 (繼承來源 ContentControl) |
| ContentTemplate |
取得或設定用來顯示 ContentControl內容的數據範本。 (繼承來源 ContentControl) |
| ContentTemplateSelector |
取得或設定範本選取器，可讓應用程式寫入器提供自定義範本選取邏輯。 (繼承來源 ContentControl) |
| ContextMenu |
取得或設定每當透過使用者介面 （UI） 從這個專案內要求操作功能表時，應該出現的操作功能表元素。 (繼承來源 FrameworkElement) |
| CurrentSource |
取得上次巡覽至之內容的統一資源標識碼 （URI）。 |
| Cursor |
取得或設定游標，這個游標會在滑鼠指標位於這個專案上方時顯示。 (繼承來源 FrameworkElement) |
| DataContext |
取得或設定專案參與數據系結時的數據內容。 (繼承來源 FrameworkElement) |
| DefaultStyleKey |
取得或設定索引鍵，當使用或定義主題樣式時，用來參考這個控件的樣式。 (繼承來源 FrameworkElement) |
| DependencyObjectType |
取得包裝這個實例 CLR 類型的 DependencyObjectType。 (繼承來源 DependencyObject) |
| DesiredSize |
取得此元素在版面配置程式量值階段期間計算的大小。 (繼承來源 UIElement) |
| DialogResult |
取得或設定對話框結果值，這是從 ShowDialog() 方法傳回的值。 (繼承來源 Window) |
| Dispatcher |
取得與這個 DispatcherObject 相關聯的 Dispatcher。 (繼承來源 DispatcherObject) |
| Effect |
取得或設定要套用至 UIElement的點陣圖效果。 這是相依性屬性。 (繼承來源 UIElement) |
| FlowDirection |
取得或設定文字和其他使用者介面 （UI） 元素在控制其配置的任何父元素內流動的方向。 (繼承來源 FrameworkElement) |
| Focusable |
取得或設定值，這個值表示專案是否可以接收焦點。 這是相依性屬性。 (繼承來源 UIElement) |
| FocusVisualStyle |
取得或設定屬性，這個屬性可讓您自定義在擷取鍵盤焦點時套用至這個項目的外觀、效果或其他樣式特性。 (繼承來源 FrameworkElement) |
| FontFamily |
取得或設定控件的字型系列。 (繼承來源 Control) |
| FontSize |
取得或設定字型大小。 (繼承來源 Control) |
| FontStretch |
取得或設定字型在畫面上壓縮或展開的程度。 (繼承來源 Control) |
| FontStyle |
取得或設定字型樣式。 (繼承來源 Control) |
| FontWeight |
取得或設定指定字型的粗細或粗細。 (繼承來源 Control) |
| ForceCursor |
取得或設定值，這個值表示這個 FrameworkElement 是否應該強制使用者介面 （UI） 將游標轉譯為 Cursor 屬性所宣告的數據指標。 (繼承來源 FrameworkElement) |
| Foreground |
取得或設定描述前景色彩的筆刷。 (繼承來源 Control) |
| ForwardStack |
取得 IEnumerable，您用來列舉 NavigationWindow的返回瀏覽歷程記錄中的專案。 |
| HandlesScrolling |
取得值，這個值表示控件是否支援卷動。 (繼承來源 Control) |
| HasAnimatedProperties |
取得值，指出這個專案是否有任何動畫屬性。 (繼承來源 UIElement) |
| HasContent |
取得值，這個值表示 ContentControl 是否包含內容。 (繼承來源 ContentControl) |
| HasEffectiveKeyboardFocus |
取得值，指出 UIElement 是否有焦點。 (繼承來源 UIElement) |
| Height |
取得或設定項目的建議高度。 (繼承來源 FrameworkElement) |
| HorizontalAlignment |
取得或設定在父元素內撰寫時套用至這個專案的水準對齊特性，例如面板或專案控件。 (繼承來源 FrameworkElement) |
| HorizontalContentAlignment |
取得或設定控件內容的水準對齊方式。 (繼承來源 Control) |
| Icon |
取得或設定視窗的圖示。 (繼承來源 Window) |
| InheritanceBehavior |
取得或設定屬性值繼承、資源索引鍵查閱和 RelativeSource FindAncestor 查閱的範圍限制。 (繼承來源 FrameworkElement) |
| InputBindings |
取得與這個專案相關聯的輸入系結集合。 (繼承來源 UIElement) |
| InputScope |
取得或設定這個 FrameworkElement所使用的輸入內容。 (繼承來源 FrameworkElement) |
| IsActive |
取得值，這個值表示視窗是否為使用中。 (繼承來源 Window) |
| IsArrangeValid |
取得值，指出這個元素配置中子元素的計算大小和位置是否有效。 (繼承來源 UIElement) |
| IsEnabled |
取得或設定值，指出使用者介面 （UI） 中是否啟用這個專案。 這是相依性屬性。 (繼承來源 UIElement) |
| IsEnabledCore |
取得值，這個值會成為衍生類別中 IsEnabled 的傳回值。 (繼承來源 UIElement) |
| IsFocused |
取得值，這個值會判斷這個專案是否具有邏輯焦點。 這是相依性屬性。 (繼承來源 UIElement) |
| IsHitTestVisible |
取得或設定值，這個值會宣告這個元素是否可以從其轉譯內容的某些部分傳回作為點擊測試結果。 這是相依性屬性。 (繼承來源 UIElement) |
| IsInitialized |
取得值，這個值表示這個元素是否已在 XAML 處理器處理期間初始化，或明確呼叫其 EndInit() 方法。 (繼承來源 FrameworkElement) |
| IsInputMethodEnabled |
取得值，指出是否啟用輸入法編輯器 （IME） 等輸入法系統來處理這個項目的輸入。 (繼承來源 UIElement) |
| IsKeyboardFocused |
取得值，指出這個專案是否具有鍵盤焦點。 這是相依性屬性。 (繼承來源 UIElement) |
| IsKeyboardFocusWithin |
取得值，指出鍵盤焦點是否位於專案或其可視化樹狀結構子專案內的任何位置。 這是相依性屬性。 (繼承來源 UIElement) |
| IsLoaded |
取得值，這個值表示是否已載入這個專案以供簡報使用。 (繼承來源 FrameworkElement) |
| IsManipulationEnabled |
取得或設定值，這個值表示是否在此 UIElement上啟用操作事件。 (繼承來源 UIElement) |
| IsMeasureValid |
取得值，指出配置量值傳回的目前大小是否有效。 (繼承來源 UIElement) |
| IsMouseCaptured |
取得值，指出是否將滑鼠擷取至這個專案。 這是相依性屬性。 (繼承來源 UIElement) |
| IsMouseCaptureWithin |
取得值，這個值會決定滑鼠擷取是由這個專案或子專案在其可視化樹狀結構中保留。 這是相依性屬性。 (繼承來源 UIElement) |
| IsMouseDirectlyOver |
取得值，這個值表示滑鼠指標的位置是否對應至點擊測試結果，以將元素組合納入考慮。 這是相依性屬性。 (繼承來源 UIElement) |
| IsMouseOver |
取得值，指出滑鼠指標是否位於這個專案上方（包括可視化樹狀結構中的子專案）。 這是相依性屬性。 (繼承來源 UIElement) |
| IsSealed |
取得值，這個值表示這個實例目前是否為密封狀態（只讀）。 (繼承來源 DependencyObject) |
| IsStylusCaptured |
取得值，指出手寫筆是否由這個專案擷取。 這是相依性屬性。 (繼承來源 UIElement) |
| IsStylusCaptureWithin |
取得值，這個值會判斷手寫筆擷取是由這個專案所保存，還是專案界限及其可視化樹狀結構內的專案。 這是相依性屬性。 (繼承來源 UIElement) |
| IsStylusDirectlyOver |
取得值，這個值表示手寫筆位置是否對應至點擊測試結果，這會考慮元素組合。 這是相依性屬性。 (繼承來源 UIElement) |
| IsStylusOver |
取得值，指出手寫筆游標是否位於這個專案上（包括視覺子專案）。 這是相依性屬性。 (繼承來源 UIElement) |
| IsTabStop |
取得或設定值，指出控件是否包含在索引標籤導覽中。 (繼承來源 Control) |
| IsVisible |
取得值，指出這個元素是否顯示在使用者介面 （UI） 中。 這是相依性屬性。 (繼承來源 UIElement) |
| Language |
取得或設定套用至 專案的當地語系化/全球化語言資訊。 (繼承來源 FrameworkElement) |
| LayoutTransform |
取得或設定執行版面配置時，應該套用至這個項目的圖形轉換。 (繼承來源 FrameworkElement) |
| Left |
取得或設定視窗左邊緣相對於桌面的位置。 (繼承來源 Window) |
| LogicalChildren |
取得窗口邏輯子專案的列舉值。 (繼承來源 Window) |
| Margin |
取得或設定專案的外部邊界。 (繼承來源 FrameworkElement) |
| MaxHeight |
取得或設定專案的最大高度條件約束。 (繼承來源 FrameworkElement) |
| MaxWidth |
取得或設定專案的最大寬度條件約束。 (繼承來源 FrameworkElement) |
| MinHeight |
取得或設定專案的最低高度條件約束。 (繼承來源 FrameworkElement) |
| MinWidth |
取得或設定專案的最小寬度條件約束。 (繼承來源 FrameworkElement) |
| Name |
取得或設定項目的識別名稱。 此名稱會提供參考，讓程式代碼後置，例如事件處理程式程式代碼，可以在 XAML 處理器在處理期間建構標記專案之後參考它。 (繼承來源 FrameworkElement) |
| NavigationService |
取得這個 NavigationWindow 用來提供其內容的導覽服務 NavigationService。 |
| Opacity |
取得或設定在使用者介面中轉譯時套用至整個 UIElement 不透明度因數。 這是相依性屬性。 (繼承來源 UIElement) |
| OpacityMask |
取得或設定不透明度遮罩，做為套用至這個元素轉譯內容之任何 Alpha 色板遮罩的 Brush 實作。 這是相依性屬性。 (繼承來源 UIElement) |
| OverridesDefaultStyle |
取得或設定值，這個值表示這個專案是否包含主題樣式的樣式屬性。 (繼承來源 FrameworkElement) |
| OwnedWindows |
取得此視窗為擁有者的視窗集合。 (繼承來源 Window) |
| Owner | (繼承來源 Window) |
| Padding |
取得或設定 控件內的邊框間距。 (繼承來源 Control) |
| Parent |
取得這個項目的邏輯父元素。 (繼承來源 FrameworkElement) |
| PersistId |
已淘汰.
取得可唯一識別這個專案的值。 (繼承來源 UIElement) |
| RenderSize |
取得這個元素的最終轉譯大小（或設定）。 (繼承來源 UIElement) |
| RenderTransform |
取得或設定會影響這個項目轉譯位置的轉換資訊。 這是相依性屬性。 (繼承來源 UIElement) |
| RenderTransformOrigin |
取得或設定 RenderTransform所宣告之任何可能轉譯轉換的中心點，相對於專案界限。 這是相依性屬性。 (繼承來源 UIElement) |
| ResizeMode |
取得或設定重設大小模式。 (繼承來源 Window) |
| Resources |
取得或設定本機定義的資源字典。 (繼承來源 FrameworkElement) |
| RestoreBounds |
取得視窗的大小和位置，再最小化或最大化。 (繼承來源 Window) |
| SandboxExternalContent |
取得或設定值，這個值表示 NavigationWindow 是否隔離部分信任安全性沙箱內的外部可延伸應用程式標記語言 （XAML） 內容（具有預設因特網區域許可權集合）。 |
| ShowActivated |
取得或設定值，這個值表示第一次顯示時是否啟動視窗。 (繼承來源 Window) |
| ShowInTaskbar |
取得或設定值，指出視窗是否有任務欄按鈕。 (繼承來源 Window) |
| ShowsNavigationUI |
取得或設定值，指出 NavigationWindow 是否顯示其流覽UI。 |
| SizeToContent |
取得或設定值，這個值表示視窗是否會自動重設大小以符合其內容的大小。 (繼承來源 Window) |
| SnapsToDevicePixels |
取得或設定值，這個值會決定這個元素的轉譯是否應該在轉譯期間使用裝置特定的像素設定。 這是相依性屬性。 (繼承來源 UIElement) |
| Source |
取得或設定目前內容的統一資源標識碼（URI），或目前巡覽至之新內容的 URI。 |
| Style |
取得或設定這個元素在轉譯時所使用的樣式。 (繼承來源 FrameworkElement) |
| StylusPlugIns |
取得與這個項目相關聯的所有手寫筆外掛程式（自定義）物件的集合。 (繼承來源 UIElement) |
| TabIndex |
取得或設定值，這個值會決定當使用者使用 TAB 鍵巡覽控件時，專案接收焦點的順序。 (繼承來源 Control) |
| Tag |
取得或設定可用來儲存這個專案之自定義資訊的任意物件值。 (繼承來源 FrameworkElement) |
| TaskbarItemInfo |
取得或設定 Window的 Windows 7 任務列縮圖。 (繼承來源 Window) |
| Template |
取得或設定控件範本。 (繼承來源 Control) |
| TemplatedParent |
取得這個專案之範本父系的參考。 如果元素不是透過範本建立，則此屬性不相關。 (繼承來源 FrameworkElement) |
| Title |
取得或設定視窗的標題。 (繼承來源 Window) |
| ToolTip |
取得或設定使用者介面 （UI） 中這個元素所顯示的工具提示物件。 (繼承來源 FrameworkElement) |
| Top |
取得或設定視窗上邊緣相對於桌面的位置。 (繼承來源 Window) |
| Topmost |
取得或設定值，這個值表示視窗是否以最上層的 z 順序顯示。 (繼承來源 Window) |
| TouchesCaptured |
取得擷取至這個專案的所有觸控裝置。 (繼承來源 UIElement) |
| TouchesCapturedWithin |
取得擷取至這個專案的所有觸控裝置，或其可視化樹狀結構中的任何子專案。 (繼承來源 UIElement) |
| TouchesDirectlyOver |
取得位於這個專案上的所有觸控裝置。 (繼承來源 UIElement) |
| TouchesOver |
取得位於這個元素上的所有觸控裝置或其可視化樹狀結構中的任何子專案。 (繼承來源 UIElement) |
| Triggers |
取得直接在此專案或子專案上建立的觸發程式集合。 (繼承來源 FrameworkElement) |
| Uid |
取得或設定這個專案的唯一標識碼（用於當地語系化）。 這是相依性屬性。 (繼承來源 UIElement) |
| UseLayoutRounding |
取得或設定值，這個值表示配置四捨五入是否應該套用至配置期間這個專案的大小和位置。 (繼承來源 FrameworkElement) |
| VerticalAlignment |
取得或設定在父元素內，例如面板或專案控件的父元素內時，套用至這個專案的垂直對齊特性。 (繼承來源 FrameworkElement) |
| VerticalContentAlignment |
取得或設定控件內容的垂直對齊方式。 (繼承來源 Control) |
| Visibility |
取得或設定這個項目的使用者介面 （UI） 可見性。 這是相依性屬性。 (繼承來源 UIElement) |
| VisualBitmapEffect |
已淘汰.
已淘汰.
取得或設定 Visual的 BitmapEffect 值。 (繼承來源 Visual) |
| VisualBitmapEffectInput |
已淘汰.
已淘汰.
取得或設定 Visual的 BitmapEffectInput 值。 (繼承來源 Visual) |
| VisualBitmapScalingMode |
取得或設定 Visual的 BitmapScalingMode。 (繼承來源 Visual) |
| VisualCacheMode |
取得或設定 Visual的快取表示法。 (繼承來源 Visual) |
| VisualChildrenCount |
取得這個專案內的視覺子項目數目。 (繼承來源 FrameworkElement) |
| VisualClearTypeHint |
取得或設定 ClearTypeHint，決定在 Visual中轉譯 ClearType 的方式。 (繼承來源 Visual) |
| VisualClip |
取得或設定 Visual 的剪輯區域做為 Geometry 值。 (繼承來源 Visual) |
| VisualEdgeMode |
取得或設定 Visual 邊緣模式做為 EdgeMode 值。 (繼承來源 Visual) |
| VisualEffect |
取得或設定要套用至 Visual的點陣圖效果。 (繼承來源 Visual) |
| VisualOffset |
取得或設定視覺物件的位移值。 (繼承來源 Visual) |
| VisualOpacity |
取得或設定 Visual的不透明度。 (繼承來源 Visual) |
| VisualOpacityMask |
取得或設定 Brush 值，表示 Visual的不透明度遮罩。 (繼承來源 Visual) |
| VisualParent |
取得可視化物件的可視化樹狀結構父代。 (繼承來源 Visual) |
| VisualScrollableAreaClip |
取得或設定 Visual裁剪的可捲動區域。 (繼承來源 Visual) |
| VisualTextHintingMode |
取得或設定 Visual的 TextHintingMode。 (繼承來源 Visual) |
| VisualTextRenderingMode |
取得或設定 Visual的 TextRenderingMode。 (繼承來源 Visual) |
| VisualTransform | (繼承來源 Visual) |
| VisualXSnappingGuidelines |
取得或設定 x 座標 （垂直） 指導方針集合。 (繼承來源 Visual) |
| VisualYSnappingGuidelines |
取得或設定 Y 座標 （水平） 指導方針集合。 (繼承來源 Visual) |
| Width |
取得或設定項目的寬度。 (繼承來源 FrameworkElement) |
| WindowStartupLocation |
取得或設定第一次顯示時視窗的位置。 (繼承來源 Window) |
| WindowState |
取得或設定值，這個值表示視窗是還原、最小化還是最大化。 (繼承來源 Window) |
| WindowStyle |
取得或設定視窗的框線樣式。 (繼承來源 Window) |
方法
事件
| Activated |
當視窗變成前景窗口時發生。 (繼承來源 Window) |
| Closed |
發生於視窗即將關閉時。 (繼承來源 Window) |
| Closing |
直接在呼叫 Close() 之後發生，而且可以處理以取消窗口關閉。 (繼承來源 Window) |
| ContentRendered |
在轉譯視窗的內容之後發生。 (繼承來源 Window) |
| ContextMenuClosing |
發生於專案上的任何操作功能表關閉之前。 (繼承來源 FrameworkElement) |
| ContextMenuOpening |
發生於開啟專案上的任何操作功能表時。 (繼承來源 FrameworkElement) |
| DataContextChanged |
發生於這個項目的數據內容變更時。 (繼承來源 FrameworkElement) |
| Deactivated |
當視窗變成背景視窗時發生。 (繼承來源 Window) |
| DpiChanged |
發生於窗口顯示變更之畫面的 DPI 之後。 (繼承來源 Window) |
| DragEnter |
當輸入系統報告具有此元素作為拖曳目標的基礎拖曳事件時發生。 (繼承來源 UIElement) |
| DragLeave |
當輸入系統報告具有此元素作為拖曳原點的基礎拖曳事件時發生。 (繼承來源 UIElement) |
| DragOver |
當輸入系統報告基礎拖曳事件時，此專案會作為潛在的置放目標發生。 (繼承來源 UIElement) |
| Drop |
當輸入系統報告具有這個項目作為置放目標的基礎置放事件時發生。 (繼承來源 UIElement) |
| FocusableChanged |
發生於 Focusable 屬性值變更時。 (繼承來源 UIElement) |
| FragmentNavigation |
發生於流覽至內容片段時，如果所需的片段位於目前內容中，或載入來源 XAML 內容之後，如果所需的片段位於不同的內容中，就會立即發生。 |
| GiveFeedback |
當輸入系統報告涉及這個項目的基礎拖放事件時發生。 (繼承來源 UIElement) |
| GotFocus |
發生於這個專案取得邏輯焦點時。 (繼承來源 UIElement) |
| GotKeyboardFocus |
發生於鍵盤焦點放在這個專案上時。 (繼承來源 UIElement) |
| GotMouseCapture |
發生於這個專案擷取滑鼠時。 (繼承來源 UIElement) |
| GotStylusCapture |
發生於這個專案擷取手寫筆時。 (繼承來源 UIElement) |
| GotTouchCapture |
發生於擷取至這個項目的觸控時。 (繼承來源 UIElement) |
| Initialized |
發生於初始化這個 FrameworkElement 時。 此事件恰逢 IsInitialized 屬性值從 |
| IsEnabledChanged |
發生於這個專案上 IsEnabled 屬性值變更時。 (繼承來源 UIElement) |
| IsHitTestVisibleChanged |
發生於這個專案上 IsHitTestVisible 相依性屬性的值變更時。 (繼承來源 UIElement) |
| IsKeyboardFocusedChanged |
發生於這個專案上 IsKeyboardFocused 屬性值變更時。 (繼承來源 UIElement) |
| IsKeyboardFocusWithinChanged |
發生於這個專案上 IsKeyboardFocusWithin 屬性值變更時。 (繼承來源 UIElement) |
| IsMouseCapturedChanged |
發生於這個專案上 IsMouseCaptured 屬性值變更時。 (繼承來源 UIElement) |
| IsMouseCaptureWithinChanged |
發生於這個專案上 IsMouseCaptureWithinProperty 的值變更時。 (繼承來源 UIElement) |
| IsMouseDirectlyOverChanged |
發生於這個專案上 IsMouseDirectlyOver 屬性值變更時。 (繼承來源 UIElement) |
| IsStylusCapturedChanged |
發生於這個專案上 IsStylusCaptured 屬性值變更時。 (繼承來源 UIElement) |
| IsStylusCaptureWithinChanged |
發生於這個專案上 IsStylusCaptureWithin 屬性值變更時。 (繼承來源 UIElement) |
| IsStylusDirectlyOverChanged |
發生於這個專案上 IsStylusDirectlyOver 屬性值變更時。 (繼承來源 UIElement) |
| IsVisibleChanged |
發生於這個專案上 IsVisible 屬性值變更時。 (繼承來源 UIElement) |
| KeyDown |
當焦點位於這個專案上時按下按鍵時發生。 (繼承來源 UIElement) |
| KeyUp |
當焦點位於這個專案上時釋放索引鍵時發生。 (繼承來源 UIElement) |
| LayoutUpdated |
發生於與目前 Dispatcher 相關聯的各種視覺專案配置變更時。 (繼承來源 UIElement) |
| LoadCompleted |
發生於流覽至 的內容已載入、剖析，並開始轉譯時。 |
| Loaded |
發生於專案配置、轉譯及準備好進行互動時。 (繼承來源 FrameworkElement) |
| LocationChanged |
發生於視窗的位置變更時。 (繼承來源 Window) |
| LostFocus |
發生於這個專案失去邏輯焦點時。 (繼承來源 UIElement) |
| LostKeyboardFocus |
當鍵盤不再聚焦於這個項目時發生。 (繼承來源 UIElement) |
| LostMouseCapture |
發生於這個專案失去滑鼠擷取時。 (繼承來源 UIElement) |
| LostStylusCapture |
發生於這個專案失去手寫筆擷取時。 (繼承來源 UIElement) |
| LostTouchCapture |
發生於這個專案失去觸控擷取時。 (繼承來源 UIElement) |
| ManipulationBoundaryFeedback |
發生於操作遇到界限時。 (繼承來源 UIElement) |
| ManipulationCompleted |
發生於 UIElement 物件上的操作和慣性完成時。 (繼承來源 UIElement) |
| ManipulationDelta |
當輸入裝置在操作期間變更位置時發生。 (繼承來源 UIElement) |
| ManipulationInertiaStarting |
當輸入裝置在操作和慣性開始時與 UIElement 物件失去接觸時發生。 (繼承來源 UIElement) |
| ManipulationStarted |
當輸入裝置開始操作 UIElement 物件時發生。 (繼承來源 UIElement) |
| ManipulationStarting |
第一次建立操作處理器時發生。 (繼承來源 UIElement) |
| MouseDoubleClick |
發生於單擊滑鼠按鈕兩次或多次時。 (繼承來源 Control) |
| MouseDown |
發生於指標位於這個專案上方時按下任何滑鼠按鈕時。 (繼承來源 UIElement) |
| MouseEnter |
發生於滑鼠指標進入這個專案的界限時。 (繼承來源 UIElement) |
| MouseLeave |
發生於滑鼠指標離開這個項目的界限時。 (繼承來源 UIElement) |
| MouseLeftButtonDown |
當滑鼠指標位於這個專案上方時按下滑鼠左鍵時發生。 (繼承來源 UIElement) |
| MouseLeftButtonUp |
當滑鼠指標位於這個專案上方時放開滑鼠左鍵時發生。 (繼承來源 UIElement) |
| MouseMove |
發生於滑鼠指標在這個專案上方移動時。 (繼承來源 UIElement) |
| MouseRightButtonDown |
發生於滑鼠指標位於這個專案上方時按下滑鼠右鍵時。 (繼承來源 UIElement) |
| MouseRightButtonUp |
發生於滑鼠指標位於這個專案上方時放開滑鼠右鍵時。 (繼承來源 UIElement) |
| MouseUp |
發生於此元素上放開任何滑鼠按鈕時。 (繼承來源 UIElement) |
| MouseWheel |
當使用者在滑鼠指標位於這個專案上方時旋轉滑鼠滾輪時發生。 (繼承來源 UIElement) |
| Navigated |
發生於已巡覽至 的內容已找到，且可從 Content 屬性取得，但可能尚未完成載入。 |
| Navigating |
發生於要求新的導覽時。 |
| NavigationFailed |
在流覽至要求的內容時引發錯誤時發生。 |
| NavigationProgress |
在下載期間定期發生，以提供瀏覽進度資訊。 |
| NavigationStopped |
發生於呼叫 StopLoading() 方法，或當目前導覽進行時要求新的瀏覽時。 |
| PreviewDragEnter |
當輸入系統報告具有此元素作為拖曳目標的基礎拖曳事件時發生。 (繼承來源 UIElement) |
| PreviewDragLeave |
當輸入系統報告具有此元素作為拖曳原點的基礎拖曳事件時發生。 (繼承來源 UIElement) |
| PreviewDragOver |
當輸入系統報告基礎拖曳事件時，此專案會作為潛在的置放目標發生。 (繼承來源 UIElement) |
| PreviewDrop |
當輸入系統報告具有這個項目作為置放目標的基礎置放事件時發生。 (繼承來源 UIElement) |
| PreviewGiveFeedback |
發生於啟動拖放作業時。 (繼承來源 UIElement) |
| PreviewGotKeyboardFocus |
發生於鍵盤焦點放在這個專案上時。 (繼承來源 UIElement) |
| PreviewKeyDown |
當焦點位於這個專案上時按下按鍵時發生。 (繼承來源 UIElement) |
| PreviewKeyUp |
當焦點位於這個專案上時釋放索引鍵時發生。 (繼承來源 UIElement) |
| PreviewLostKeyboardFocus |
當鍵盤不再聚焦於這個項目時發生。 (繼承來源 UIElement) |
| PreviewMouseDoubleClick |
發生於用戶按兩下滑鼠按鈕兩次以上時。 (繼承來源 Control) |
| PreviewMouseDown |
發生於指標位於這個專案上方時按下任何滑鼠按鈕時。 (繼承來源 UIElement) |
| PreviewMouseLeftButtonDown |
當滑鼠指標位於這個專案上方時按下滑鼠左鍵時發生。 (繼承來源 UIElement) |
| PreviewMouseLeftButtonUp |
當滑鼠指標位於這個專案上方時放開滑鼠左鍵時發生。 (繼承來源 UIElement) |
| PreviewMouseMove |
當滑鼠指標位於這個專案上方時，滑鼠指標移動時發生。 (繼承來源 UIElement) |
| PreviewMouseRightButtonDown |
發生於滑鼠指標位於這個專案上方時按下滑鼠右鍵時。 (繼承來源 UIElement) |
| PreviewMouseRightButtonUp |
發生於滑鼠指標位於這個專案上方時放開滑鼠右鍵時。 (繼承來源 UIElement) |
| PreviewMouseUp |
發生於滑鼠指標位於這個專案上方時放開任何滑鼠按鈕時。 (繼承來源 UIElement) |
| PreviewMouseWheel |
當使用者在滑鼠指標位於這個專案上方時旋轉滑鼠滾輪時發生。 (繼承來源 UIElement) |
| PreviewQueryContinueDrag |
發生於拖放作業期間鍵盤或滑鼠按鈕狀態有所變更時。 (繼承來源 UIElement) |
| PreviewStylusButtonDown |
當指標位於這個專案上方時按下手寫筆按鈕時發生。 (繼承來源 UIElement) |
| PreviewStylusButtonUp |
當指標位於這個專案上方時放開手寫筆按鈕時發生。 (繼承來源 UIElement) |
| PreviewStylusDown |
當手寫筆在這個專案上方觸碰數位板時發生。 (繼承來源 UIElement) |
| PreviewStylusInAirMove |
當手寫筆在元素上移動而不實際接觸數位板時發生。 (繼承來源 UIElement) |
| PreviewStylusInRange |
當手寫筆足夠接近數位板時發生，而在這個元素上。 (繼承來源 UIElement) |
| PreviewStylusMove |
當手寫筆在 專案上方移動時發生。 數位板偵測到手寫筆時必須移動，才能引發此事件，否則會改為引發 PreviewStylusInAirMove。 (繼承來源 UIElement) |
| PreviewStylusOutOfRange |
當手寫筆離數位板太遠而無法偵測時發生。 (繼承來源 UIElement) |
| PreviewStylusSystemGesture |
發生於使用者執行數個手寫筆手勢之一時。 (繼承來源 UIElement) |
| PreviewStylusUp |
當使用者在手寫筆超過這個專案時，將手寫筆從數位板上引發手寫筆時發生。 (繼承來源 UIElement) |
| PreviewTextInput |
發生於這個專案以與裝置無關的方式取得文字時。 (繼承來源 UIElement) |
| PreviewTouchDown |
當手指位於這個專案上方時，手指觸碰螢幕時發生。 (繼承來源 UIElement) |
| PreviewTouchMove |
當手指位於這個專案上方時，手指在螢幕上移動時發生。 (繼承來源 UIElement) |
| PreviewTouchUp |
當手指位於這個專案上方時，手指從螢幕上抬起時發生。 (繼承來源 UIElement) |
| QueryContinueDrag |
發生於拖放作業期間鍵盤或滑鼠按鈕狀態有所變更時。 (繼承來源 UIElement) |
| QueryCursor |
發生於要求顯示游標時。 每次滑鼠指標移至新位置時，都會在元素上引發這個事件，這表示游標物件可能需要根據其新位置變更。 (繼承來源 UIElement) |
| RequestBringIntoView |
在這個專案上呼叫 BringIntoView(Rect) 時發生。 (繼承來源 FrameworkElement) |
| SizeChanged |
發生於此元素上的 ActualHeight 或 ActualWidth 屬性變更值時。 (繼承來源 FrameworkElement) |
| SourceInitialized |
引發此事件以支援與 Win32 的互操作。 請參閱 HwndSource。 (繼承來源 Window) |
| SourceUpdated |
發生於這個專案上任何現有屬性系結的來源值變更時。 (繼承來源 FrameworkElement) |
| StateChanged |
發生於視窗 WindowState 屬性變更時。 (繼承來源 Window) |
| StylusButtonDown |
當指標位於這個專案上方時按下手寫筆按鈕時發生。 (繼承來源 UIElement) |
| StylusButtonUp |
當指標位於這個專案上方時放開手寫筆按鈕時發生。 (繼承來源 UIElement) |
| StylusDown |
當手寫筆觸碰數位板時，手寫筆位於這個專案上方時發生。 (繼承來源 UIElement) |
| StylusEnter |
當手寫筆進入這個專案的界限時發生。 (繼承來源 UIElement) |
| StylusInAirMove |
當手寫筆在元素上移動而不實際接觸數位板時發生。 (繼承來源 UIElement) |
| StylusInRange |
當手寫筆足夠接近數位板時發生，而在這個元素上。 (繼承來源 UIElement) |
| StylusLeave |
當手寫筆離開專案的界限時發生。 (繼承來源 UIElement) |
| StylusMove |
手寫筆在這個項目上移動時發生。 手寫筆必須在數位板上移動，才能引發此事件。 否則，會改為引發 StylusInAirMove。 (繼承來源 UIElement) |
| StylusOutOfRange |
發生於手寫筆離數位板太遠而無法偵測到此元素時。 (繼承來源 UIElement) |
| StylusSystemGesture |
發生於使用者執行數個手寫筆手勢之一時。 (繼承來源 UIElement) |
| StylusUp |
當使用者在這個元素上方時，將手寫筆從數位板上引發時發生。 (繼承來源 UIElement) |
| TargetUpdated |
發生於這個專案上任何屬性系結的目標值變更時。 (繼承來源 FrameworkElement) |
| TextInput |
發生於這個專案以與裝置無關的方式取得文字時。 (繼承來源 UIElement) |
| ToolTipClosing |
發生於專案上的任何工具提示關閉之前。 (繼承來源 FrameworkElement) |
| ToolTipOpening |
在開啟專案的任何工具提示時發生。 (繼承來源 FrameworkElement) |
| TouchDown |
當手指位於這個專案上方時，手指觸碰螢幕時發生。 (繼承來源 UIElement) |
| TouchEnter |
發生於觸控從外部移至這個專案界限內時。 (繼承來源 UIElement) |
| TouchLeave |
當觸控從內部移至這個專案界限外時發生。 (繼承來源 UIElement) |
| TouchMove |
當手指位於這個專案上方時，手指在螢幕上移動時發生。 (繼承來源 UIElement) |
| TouchUp |
當手指位於這個專案上方時，手指從螢幕上抬起時發生。 (繼承來源 UIElement) |
| Unloaded |
發生於從已載入專案的專案樹狀結構中移除專案時。 (繼承來源 FrameworkElement) |
明確介面實作
| IAddChild.AddChild(Object) |
此類型或成員支援 Windows Presentation Foundation （WPF） 基礎結構，並不適合直接從您的程式代碼使用。 (繼承來源 ContentControl) |
| IAddChild.AddText(String) |
此類型或成員支援 Windows Presentation Foundation （WPF） 基礎結構，並不適合直接從您的程式代碼使用。 (繼承來源 ContentControl) |
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
如需此成員的描述，請參閱 IsAmbientPropertyAvailable(String) 方法。 (繼承來源 FrameworkElement) |
| IUriContext.BaseUri |
取得或設定目前內容的基底統一資源標識碼 （URI）。 |
適用於
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應