ScrollViewer 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示可以包含其他可見元素的可捲動區域。
public ref class ScrollViewer sealed : ContentControl, IScrollAnchorProvider/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ScrollViewer final : ContentControl, IScrollAnchorProvider[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ScrollViewer : ContentControl, IScrollAnchorProviderPublic NotInheritable Class ScrollViewer
Inherits ContentControl
Implements IScrollAnchorProvider<ScrollViewer .../>
-or-
<ScrollViewer ...>
content
</ScrollViewer>
- 繼承
-
Object Platform::Object IInspectable DependencyObject UIElement FrameworkElement Control ContentControl ScrollViewer
- 屬性
- 實作
範例
提示
如需詳細資訊、設計指引和程式碼範例，請參閱 卷動查看器控制件。
WinUI 3 資源庫 應用程式包含大部分 WinUI 3 控制件、特性和功能的互動式範例。 從
Microsoft Store 取得應用程式，或在 GitHub取得原始程式碼。
下列 XAML 會在 ScrollViewer 內建立大型 TextBlock，以及另一份要比較的 TextBlock 複本。
<StackPanel>
<!-- A large TextBlock. -->
<TextBlock Width="300" TextWrapping="Wrap" Margin="0,0,0,30"
Text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ac mi ipsum. Phasellus vel malesuada mauris. Donec pharetra, enim sit amet mattis tincidunt, felis nisi semper lectus, vel porta diam nisi in augue. Pellentesque lacus tortor, aliquam et faucibus id, rhoncus ut justo. Sed id lectus odio, eget pulvinar diam. Suspendisse eleifend ornare libero, in luctus purus aliquet non. Sed interdum, sem vitae rutrum rhoncus, felis ligula ultrices sem, in eleifend eros ante id neque." />
<!-- The same large TextBlock, wrapped in a ScrollViewer. -->
<ScrollViewer Height="200" Width="200"
HorizontalScrollBarVisibility="Auto"
VerticalScrollBarVisibility="Auto">
<TextBlock Width="300" TextWrapping="Wrap"
Text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ac mi ipsum. Phasellus vel malesuada mauris. Donec pharetra, enim sit amet mattis tincidunt, felis nisi semper lectus, vel porta diam nisi in augue. Pellentesque lacus tortor, aliquam et faucibus id, rhoncus ut justo. Sed id lectus odio, eget pulvinar diam. Suspendisse eleifend ornare libero, in luctus purus aliquet non. Sed interdum, sem vitae rutrum rhoncus, felis ligula ultrices sem, in eleifend eros ante id neque." />
</ScrollViewer>
</StackPanel>
備註
提示
如需詳細資訊、設計指引和程式碼範例，請參閱 卷動查看器控制件。
ScrollViewer 是一個容器控件，可讓使用者平移和縮放其內容。
ScrollViewer 可讓內容顯示在小於實際大小的區域中。 當 ScrollViewer 的內容不完全可見時，ScrollViewer 會顯示滾動條，使用者可以用來移動可見的內容區域。 包含 ScrollViewer 所有內容的區域是範圍。 內容的可見區域是檢視區。
ScrollViewer 控件通常會以其他控件的複合部分的形式存在。 ScrollViewer 元件以及 ScrollContentPresenter 類別的支援，只有在主控件的配置空間小於展開的內容大小時，才會顯示檢視區以及滾動條。 這通常是清單的情況，因此 ListView 和 GridView 範本一律包含 ScrollViewer。 TextBox 和 RichEditBox 也會在其範本中包含 ScrollViewer。
當控件中的 ScrollViewer 元件存在時，主控件通常具有特定輸入事件和操作的內建事件處理，可讓內容捲動。 例如，GridView 會解譯撥動手勢，這會導致內容水平捲動。 主控件所接收的輸入事件和原始操作會被視為由 控件處理，而且不會引發 PointerPressed 等較低層級的事件，也不會反升至任何父容器。 您可以覆寫控件類別和 On事件 虛擬方法，或重新範本控制項，來變更某些內建控件處理。 但不論是哪一種情況，重現原始的默認行為並不簡單，通常是如此，控件就會以預期的方式回應事件和使用者的輸入動作和手勢。 因此，您應該考慮您是否真的需要引發該輸入事件。 您可能想要調查是否有其他輸入事件或手勢未受到控制處理，並在您的應用程式或控件互動設計中使用這些事件。
若要讓包含 ScrollViewer 的控件能夠影響 ScrollViewer 元件內的某些行為和屬性，ScrollViewer 會定義一些 XAML 附加屬性，這些屬性可以在樣式中設定，並在範本系結中使用。
如果您需要在可捲動檢視中處理 UIElement 指標事件（例如 ScrollViewer），您必須呼叫 UIElement.CancelDirectmanipulation（），明確停用檢視中元素的操作事件支援。 若要在檢視中重新啟用操作事件，請呼叫 UIElement.TryStartDirectManipulation。
手寫筆互動
從 Windows 10 版本 1709（SDK 16299 開始），UWP app 中作用中畫筆的預設行為是捲動/平移（就像觸控、觸控板和被動手寫筆一樣）。 ScrollViewer 會取用指標事件，除非您指定您想要自行處理事件，也不希望它們用於操作。
在1709之前的 Windows 10 版本中，預設行為是選取文字。
如果您的 app 應該使用使用中的畫筆進行文字選取，您可以覆寫手寫筆卷動並還原為先前的行為。 若要這樣做，請處理 pointerPressed 事件
此範例示範如何：
- 使用 UIElement.AddHandler 方法，向 handledEventsToo 參數設定為 true註冊事件。
- 檢查指標裝置是否為 Pen。
- 在 PointerPressed 事件處理程式中，關閉 ScrollViewer 中的系統操作支援。
- 在 PointerReleased 和 PointerCanceled 事件處理程式中，開啟系統操作支援。
<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
<ScrollViewer x:Name="myScrollViewer">
<Image Source="Assets/StoreLogo.png"/>
</ScrollViewer>
</Grid>
public MainPage()
{
this.InitializeComponent();
this.myScrollViewer.AddHandler(UIElement.PointerPressedEvent,
new PointerEventHandler(myScrollViewer_PointerPressed),
true /*handledEventsToo*/);
this.myScrollViewer.AddHandler(UIElement.PointerReleasedEvent,
new PointerEventHandler(myScrollViewer_PointerReleased),
true /*handledEventsToo*/);
this.myScrollViewer.AddHandler(UIElement.PointerCanceledEvent,
new PointerEventHandler(myScrollViewer_PointerCanceled),
true /*handledEventsToo*/);
}
private void myScrollViewer_PointerPressed(object sender, PointerRoutedEventArgs e)
{
if (e.Pointer.PointerDeviceType == Windows.Devices.Input.PointerDeviceType.Pen)
{
(myScrollViewer.Content as UIElement).ManipulationMode &= ~ManipulationModes.System;
}
}
private void myScrollViewer_PointerReleased(object sender, PointerRoutedEventArgs e)
{
if (e.Pointer.PointerDeviceType == Windows.Devices.Input.PointerDeviceType.Pen)
{
(myScrollViewer.Content as UIElement).ManipulationMode |= ManipulationModes.System;
}
}
private void myScrollViewer_PointerCanceled(object sender, PointerRoutedEventArgs e)
{
if (e.Pointer.PointerDeviceType == Windows.Devices.Input.PointerDeviceType.Pen)
{
(myScrollViewer.Content as UIElement).ManipulationMode |= ManipulationModes.System;
}
}
ScrollViewer XAML 附加屬性
ScrollViewer 會定義下列 XAML 附加屬性：
- ScrollViewer.BringIntoViewOnFocusChange
- ScrollViewer.HorizontalScrollBarVisibility
- ScrollViewer.HorizontalScrollMode
- ScrollViewer.IsDeferredScrollingEnabled
- ScrollViewer.IsHorizontalRailEnabled
- ScrollViewer.IsHorizontalScrollChainingEnabled
- ScrollViewer.IsScrollInertiaEnabled
- ScrollViewer.IsVerticalRailEnabled
- ScrollViewer.IsVerticalScrollChainingEnabled
- ScrollViewer.IsZoomChainingEnabled
- ScrollViewer.IsZoomInertiaEnabled
- ScrollViewer.VerticalScrollBarVisibility
- ScrollViewer.VerticalScrollMode
- ScrollViewer.ZoomMode
這些 XAML 附加屬性適用於 ScrollViewer 是隱含的案例，例如當 ScrollViewer 存在於 ListView 的預設範本中時， 或 GridView，而且您想要能夠在不存取範本元件的情況下影響控件的捲動行為。 如果您的 XAML 中明確顯示 ScrollViewer 的情況，如範例區段中的範例程式代碼所示，您不需要使用附加屬性語法。 只要使用屬性語法，例如 <ScrollViewer ZoomMode="Enabled" />。
為了支援 XAML 處理器存取附加屬性，以及公開對等的 get 和 set 作業給程式代碼，每個 XAML 附加屬性都有一對 Get，以及 Set 存取子方法。 例如，GetHorizontalScrollMode 和 SetHorizontalScrollMode 方法支援，並提供對 ScrollViewer.HorizontalScrollMode的對等程式代碼僅支援。 或者，您可以使用相依性屬性系統來取得或設定附加屬性的值。 呼叫 GetValue 或 SetValue、傳遞要設定之相依性屬性標識符的自變數，以及要取得或設定值的目標對象的參考。
控件樣式和範本
您可以修改預設 Style，並 ControlTemplate，為控件提供唯一的外觀。 如需修改控件樣式和範本的相關信息，請參閱generic.xaml 檔案中。 為了設計目的，generic.xaml 會隨 Windows App SDK NuGet 套件一起安裝。 根據預設，此位置會 \Users\<username>\.nuget\packages\microsoft.windowsappsdk\<version>\lib\uap10.0\Microsoft.UI\Themes\generic.xaml。 不同 SDK 版本的樣式和資源可能會有不同的值。
XAML 也包含可用來修改不同視覺狀態中控件色彩的資源，而不需修改控件範本。 建議修改這些資源來設定屬性，例如 Background 和 Foreground。 如需詳細資訊，請參閱 XAML 樣式 一文的 輕量型樣式 一節。
軌跡板裝置的手勢處理
觸控板輸入和手勢不會觸發 PointerWheelChangedScrollViewer 控件上的事件。 這些手勢是由 scrollViewer 控件
螢幕小鍵盤的應用程式UI
螢幕小鍵盤 （OSK） 是一項輔助功能功能，使用者可以視需要啟用 （設定 -> 輔助功能 -> 鍵盤或 Windows+Ctrl+O）。 與 軟式鍵盤 不同，當系統未偵測到鍵盤是否存在時，可在應用程式 UI 中顯示以支援文字輸入控件。
當 OSK 出現時，系統會調整應用程式 UI/版面配置行為，並視需要提供卷動。 此系統卷動行為不會向您的應用程式公開。
建構函式
| ScrollViewer() |
初始化 ScrollViewer 類別的新實例。 |
屬性
| AccessKey |
取得或設定這個項目的訪問鍵（助記鍵）。 (繼承來源 UIElement) |
| AccessKeyScopeOwner |
取得或設定來源專案，提供這個專案的存取鍵範圍，即使它不在來源專案的可視化樹狀結構中也一樣。 (繼承來源 UIElement) |
| ActualHeight |
取得 FrameworkElement的呈現高度。 請參閱。 (繼承來源 FrameworkElement) |
| ActualOffset |
取得這個 UIElement 的位置，相對於其父系，在版面配置程式的排列階段期間計算。 (繼承來源 UIElement) |
| ActualSize |
取得此 UIElement 在版面配置程式的排列階段期間計算的大小。 (繼承來源 UIElement) |
| ActualTheme |
取得專案目前使用的UI主題，該主題可能與 requestedTheme |
| ActualWidth |
取得 FrameworkElement的轉譯寬度。 請參閱。 (繼承來源 FrameworkElement) |
| AllowDrop |
取得或設定值，這個值會決定這個 UIElement 是否可以是拖放作業的置放目標。 (繼承來源 UIElement) |
| AllowFocusOnInteraction |
取得或設定值，這個值表示當使用者與其互動時，專案是否會自動取得焦點。 (繼承來源 FrameworkElement) |
| AllowFocusWhenDisabled |
取得或設定停用的控制項是否可以接收焦點。 (繼承來源 FrameworkElement) |
| Background |
取得或設定提供控件背景的筆刷。 (繼承來源 Control) |
| BackgroundSizing |
取得或設定值，這個值表示背景與這個專案框線的關聯程度。 (繼承來源 Control) |
| BaseUri |
取得統一資源識別碼 （URI），代表 XAML 載入時間 XAML 建構物件的基底 URI。 這個屬性適用於運行時間的 URI 解析。 (繼承來源 FrameworkElement) |
| BorderBrush |
取得或設定描述控制件框線填滿的筆刷。 (繼承來源 Control) |
| BorderThickness |
取得或設定控件的框線粗細。 (繼承來源 Control) |
| BringIntoViewOnFocusChange |
取得或設定值，這個值會決定當檢視中的專案取得焦點時，ScrollViewer 是否使用帶入檢視卷動行為。 |
| BringIntoViewOnFocusChangeProperty |
識別 bringIntoViewOnFocusChange 相依性屬性 |
| CacheMode |
取得或設定值，這個值表示轉譯的內容應該盡可能快取為複合位圖。 (繼承來源 UIElement) |
| CanBeScrollAnchor |
取得或設定值，這個值表示 UIElement 是否為卷動錨定候選專案。 (繼承來源 UIElement) |
| CanContentRenderOutsideBounds |
取得或設定值，這個值表示卷動的內容是否可以在 ScrollViewer 界限外轉譯。 |
| CanContentRenderOutsideBoundsProperty |
識別 CanContentRenderOutsideBounds 相依性屬性。 |
| CanDrag |
取得或設定值，這個值表示專案是否可以拖曳為拖放作業中的數據。 (繼承來源 UIElement) |
| CenterPoint |
取得或設定專案的中心點，也就是發生旋轉或縮放的點。 影響項目的轉譯位置。 (繼承來源 UIElement) |
| CharacterSpacing |
取得或設定字元之間的統一間距，單位為 1/1000 em。 (繼承來源 Control) |
| Clip |
取得或設定 RectangleGeometry，用來定義 UIElement內容的大綱。 (繼承來源 UIElement) |
| CompositeMode |
取得或設定屬性，這個屬性會宣告其父版面配置和視窗中專案的替代組合和混合模式。 這與混合 XAML/Microsoft DirectX UI 相關的元素相關。 (繼承來源 UIElement) |
| ComputedHorizontalScrollBarVisibility |
取得值，這個值表示是否顯示水準 ScrollBar。 |
| ComputedHorizontalScrollBarVisibilityProperty |
識別 ComputedHorizontalScrollBarVisibility 相依性屬性。 |
| ComputedVerticalScrollBarVisibility |
取得值，這個值表示是否顯示垂直 ScrollBar。 |
| ComputedVerticalScrollBarVisibilityProperty |
識別 ComputedVerticalScrollBarVisibility 相依性屬性。 |
| Content |
取得或設定 ContentControl的內容。 (繼承來源 ContentControl) |
| ContentTemplate |
取得或設定數據範本，用來顯示 ContentControl的內容。 (繼承來源 ContentControl) |
| ContentTemplateRoot |
取得 contentTemplate 屬性所指定 |
| ContentTemplateSelector |
取得或設定選取對象，根據運行時間的內容專案或其容器的處理資訊，變更 DataTemplate 套用內容。 (繼承來源 ContentControl) |
| ContentTransitions |
取得或設定套用至 contentControl |
| ContextFlyout |
取得或設定與這個項目相關聯的飛出視窗。 (繼承來源 UIElement) |
| CornerRadius |
取得或設定控件框線角落的半徑。 (繼承來源 Control) |
| CurrentAnchor |
用於捲動錨定之目前選擇的錨點專案。 |
| DataContext |
取得或設定 FrameworkElement的數據內容。 數據內容的常見用法是當 |
| DefaultStyleKey |
取得或設定參考控件預設樣式的索引鍵。 自定義控件的作者會使用這個屬性來變更其控件所使用的樣式預設值。 (繼承來源 Control) |
| DefaultStyleResourceUri |
取得或設定包含控制項預設樣式的資源檔案路徑。 (繼承來源 Control) |
| DesiredSize |
取得這個 UIEl ement 在版面配置程式量值階段期間計算的大小。 (繼承來源 UIElement) |
| Dispatcher |
一律會在 Windows App SDK 應用程式中傳回 |
| DispatcherQueue |
取得與這個對象相關聯的 |
| ElementSoundMode |
取得或設定值，指定控件是否播放音效的喜好設定。 (繼承來源 Control) |
| ExitDisplayModeOnAccessKeyInvoked |
取得或設定值，指定叫用存取金鑰時是否關閉存取金鑰顯示。 (繼承來源 UIElement) |
| ExtentHeight | |
| ExtentHeightProperty |
ExtentHeight 相依性屬性的標識碼。 |
| ExtentWidth | |
| ExtentWidthProperty |
ExtentWidth 相依性屬性的標識碼。 |
| FlowDirection |
取得或設定文字和其他UI元素在控制其版面配置的任何父元素內流動的方向。 這個屬性可以設定為 |
| FocusState |
取得值，指定這個控件是否具有焦點，以及取得焦點的模式。 (繼承來源 UIElement) |
| FocusVisualMargin |
取得或設定 FrameworkElement焦點視覺效果的外部邊界。 (繼承來源 FrameworkElement) |
| FocusVisualPrimaryBrush |
取得或設定筆刷，用來繪製 |
| FocusVisualPrimaryThickness |
取得或設定 FrameworkElement之 |
| FocusVisualSecondaryBrush |
取得或設定筆刷，用來繪製 |
| FocusVisualSecondaryThickness |
取得或設定 FrameworkElement之 |
| FontFamily |
取得或設定用來在控件中顯示文字的字型。 (繼承來源 Control) |
| FontSize |
取得或設定這個控制件中的文字大小。 (繼承來源 Control) |
| FontStretch |
取得或設定字型在畫面上壓縮或展開的程度。 (繼承來源 Control) |
| FontStyle |
取得或設定呈現文字的樣式。 (繼承來源 Control) |
| FontWeight |
取得或設定指定字型的粗細。 (繼承來源 Control) |
| Foreground |
取得或設定描述前景色彩的筆刷。 (繼承來源 Control) |
| Height |
取得或設定 FrameworkElement的建議高度。 (繼承來源 FrameworkElement) |
| HighContrastAdjustment |
取得或設定值，這個值表示當啟用高對比度主題時，架構是否會自動調整專案的視覺屬性。 (繼承來源 UIElement) |
| HorizontalAlignment |
取得或設定在版面配置父系中組成時，套用至 FrameworkElement 的水準對齊特性，例如面板或專案控件。 (繼承來源 FrameworkElement) |
| HorizontalAnchorRatio |
決定 ScrollViewer 錨點的水準位置， 檢視區。 根據預設，ScrollViewer 會藉由識別最接近錨點的檢視區中的元素，將元素選取為其 CurrentAnchor。 |
| HorizontalAnchorRatioProperty |
識別 HorizontalAnchorRatio 相依性屬性。 |
| HorizontalContentAlignment |
取得或設定控件內容的水準對齊方式。 (繼承來源 Control) |
| HorizontalOffset |
取得內容水平捲動的距離。 |
| HorizontalOffsetProperty |
識別 HorizontalOffset 相依性屬性。 |
| HorizontalScrollBarVisibility |
取得或設定值，這個值表示是否應該顯示水準 ScrollBar。 |
| HorizontalScrollBarVisibilityProperty |
識別 HorizontalScrollBarVisibility 相依性屬性。 |
| HorizontalScrollMode |
取得或設定值，這個值決定操作輸入如何影響水平軸上的捲動行為。 |
| HorizontalScrollModeProperty |
識別 HorizontalScrollMode 相依性屬性。 |
| HorizontalSnapPointsAlignment |
取得或設定值，指出現有貼齊點與初始檢視區的水準對齊方式。 |
| HorizontalSnapPointsAlignmentProperty |
識別 HorizontalSnapPointsAlignment 相依性屬性。 |
| HorizontalSnapPointsType |
取得或設定值，這個值會宣告操作行為如何響應水平軸上的貼齊點。 |
| HorizontalSnapPointsTypeProperty |
識別 HorizontalSnapPointsType 相依性屬性。 |
| IsAccessKeyScope |
取得或設定值，這個值表示專案是否定義自己的訪問鍵範圍。 (繼承來源 UIElement) |
| IsDeferredScrollingEnabled |
取得或設定值，這個值決定 ScrollViewer的延後捲動行為。 |
| IsDeferredScrollingEnabledProperty |
識別 IsDeferredScrollingEnabled 相依性屬性。 |
| IsDoubleTapEnabled |
取得或設定值，這個值會決定 DoubleTapped 事件是否源自該專案。 (繼承來源 UIElement) |
| IsEnabled |
取得或設定值，指出使用者是否可以與控件互動。 (繼承來源 Control) |
| IsFocusEngaged |
取得或設定值，指出當使用者按下遊戲控制器上的 A/Select 按鈕時，焦點是否受限於控件。 (繼承來源 Control) |
| IsFocusEngagementEnabled |
取得或設定值，這個值表示當使用者按下遊戲控制器上的 A/Select 按鈕時，焦點是否受限於控件。 (繼承來源 Control) |
| IsHitTestVisible |
取得或設定這個 UIElement 是否可傳回 true 值以進行點擊測試。 (繼承來源 UIElement) |
| IsHoldingEnabled |
取得或設定值，這個值會決定 Holding 事件是否源自該專案。 (繼承來源 UIElement) |
| IsHorizontalRailEnabled |
取得或設定值，這個值表示水平軸是否啟用滾動條。 |
| IsHorizontalRailEnabledProperty |
識別 IsHorizontalRailEnabled 相依性屬性。 |
| IsHorizontalScrollChainingEnabled |
取得或設定值，這個值表示水平軸是否從這個子系啟用捲動鏈結至其父系。 |
| IsHorizontalScrollChainingEnabledProperty |
識別 IsHorizontalScrollChainingEnabled 相依性屬性。 |
| IsLoaded |
取得值，這個值表示專案是否已新增至專案樹狀結構，並且已準備好進行互動。 (繼承來源 FrameworkElement) |
| IsRightTapEnabled |
取得或設定值，這個值會決定 rightTapped 事件是否源自該專案。 (繼承來源 UIElement) |
| IsScrollInertiaEnabled |
取得或設定值，這個值表示卷動動作是否應該在其行為和值中包含慣性。 |
| IsScrollInertiaEnabledProperty |
識別 IsScrollInertiaEnabled 相依性屬性。 |
| IsTabStop |
取得或設定值，指出控件是否包含在索引標籤導覽中。 (繼承來源 UIElement) |
| IsTapEnabled |
取得或設定值，這個值會決定點選 事件 |
| IsTextScaleFactorEnabled |
取得或設定是否啟用自動文字放大，以反映系統文字大小設定。 (繼承來源 Control) |
| IsVerticalRailEnabled |
取得或設定值，這個值表示是否啟用垂直軸的滾動條。 |
| IsVerticalRailEnabledProperty |
識別 IsVerticalRailEnabled 相依性屬性。 |
| IsVerticalScrollChainingEnabled |
取得或設定值，這個值表示垂直軸是否從這個子系啟用捲動鏈結至其父系。 |
| IsVerticalScrollChainingEnabledProperty |
識別 IsVerticalScrollChainingEnabled 相依性屬性。 |
| IsZoomChainingEnabled |
取得或設定值，這個值表示是否從這個子系啟用縮放鏈結至其父系。 |
| IsZoomChainingEnabledProperty |
識別 IsZoomChainingEnabled 相依性屬性。 |
| IsZoomInertiaEnabled |
取得或設定值，這個值表示縮放動作是否應該在其行為和值中包含慣性。 |
| IsZoomInertiaEnabledProperty |
識別 IsZoomInertiaEnabled 相依性屬性。 |
| KeyboardAcceleratorPlacementMode |
取得或設定值，這個值表示控件是否 工具提示 顯示其相關聯鍵盤快捷方式的按鍵組合。 (繼承來源 UIElement) |
| KeyboardAcceleratorPlacementTarget |
取得或設定值，這個值表示顯示快速鍵組合的控件 工具提示。 (繼承來源 UIElement) |
| KeyboardAccelerators |
取得使用鍵盤叫用動作的按鍵組合集合。 快捷鍵通常會指派給按鈕或功能表項。
|
| KeyTipHorizontalOffset |
取得或設定值，這個值表示索引鍵提示相對於UIElement放置的左邊或右邊。 (繼承來源 UIElement) |
| KeyTipPlacementMode |
取得或設定值，這個值表示存取密鑰提示相對於 UIElement 界限的位置。 (繼承來源 UIElement) |
| KeyTipTarget |
取得或設定值，這個值表示以訪問鍵提示為目標的專案。 (繼承來源 UIElement) |
| KeyTipVerticalOffset |
取得或設定值，這個值表示索引鍵提示相對於UI元素的上移或下移。 (繼承來源 UIElement) |
| Language |
取得或設定適用於 FrameworkElement的當地語系化/全球化語言資訊，以及套用至物件表示法和 UI 中目前 FrameworkEl ement 的所有子元素。 (繼承來源 FrameworkElement) |
| LeftHeader |
取得或設定左標頭的內容。 |
| LeftHeaderProperty |
識別 leftHeader 相依性屬性 |
| Lights |
取得附加至這個專案 XamlLight 物件的集合。 (繼承來源 UIElement) |
| ManipulationMode |
取得或設定用於 UIElement 行為與手勢互動的 ManipulationModes 值。 設定此值可讓您在應用程式程式代碼中處理來自這個專案的操作事件。 (繼承來源 UIElement) |
| Margin |
取得或設定 FrameworkElement的外部邊界。 (繼承來源 FrameworkElement) |
| MaxHeight |
取得或設定 FrameworkElement的最大高度條件約束。 (繼承來源 FrameworkElement) |
| MaxWidth |
取得或設定 FrameworkElement的最大寬度條件約束。 (繼承來源 FrameworkElement) |
| MaxZoomFactor |
取得或設定值，這個值表示 ZoomFactor允許的運行時間值上限。 |
| MaxZoomFactorProperty |
識別 MaxZoomFactor 相依性屬性。 |
| MinHeight |
取得或設定 FrameworkElement的最低高度條件約束。 (繼承來源 FrameworkElement) |
| MinWidth |
取得或設定 FrameworkElement的最小寬度條件約束。 (繼承來源 FrameworkElement) |
| MinZoomFactor |
取得或設定值，這個值表示 ZoomFactor的最小允許運行時間值。 |
| MinZoomFactorProperty |
識別 MinZoomFactor 相依性屬性。 |
| Name |
取得或設定 對象的識別名稱。 當 XAML 處理器從 XAML 標記建立物件樹狀結構時，運行時間程式代碼可以透過這個名稱參照 XAML 宣告的物件。 (繼承來源 FrameworkElement) |
| Opacity |
取得或設定物件不透明度的程度。 (繼承來源 UIElement) |
| OpacityTransition |
取得或設定 ScalarTransition，以動畫顯示 Opacity 屬性的變更。 (繼承來源 UIElement) |
| Padding |
取得或設定 控件內的邊框間距。 (繼承來源 Control) |
| Parent |
取得物件樹狀結構中這個 FrameworkElement 的父物件。 (繼承來源 FrameworkElement) |
| PointerCaptures |
取得所有擷取指標的集合，表示為 指標 值。 (繼承來源 UIElement) |
| Projection |
取得或設定轉譯這個專案時要套用的透視投影（3D 效果）。 (繼承來源 UIElement) |
| ProtectedCursor |
取得或設定指標位於這個專案上方時所顯示的游標。 默認值為 null，表示數據指標沒有變更。 (繼承來源 UIElement) |
| RasterizationScale |
取得值，表示每個檢視圖元的原始（實體）像素數目。 (繼承來源 UIElement) |
| ReduceViewportForCoreInputViewOcclusions |
取得或設定值，這個值表示 ScrollViewer 是否應該嘗試調整其內容，以在停駐的 CoreInputView 遮蔽部分內容時保持可見。 |
| ReduceViewportForCoreInputViewOcclusionsProperty |
識別 ReduceViewportForCoreInputViewOcclusions 相依性屬性。 |
| RenderSize |
取得 UIElement的最終轉譯大小。 不建議使用，請參閱。 (繼承來源 UIElement) |
| RenderTransform |
取得或設定會影響 UIElement轉譯位置的轉換資訊。 (繼承來源 UIElement) |
| RenderTransformOrigin |
取得或設定 RenderTransform所宣告之任何可能轉譯轉換的原點，相對於 UIElement界限。 (繼承來源 UIElement) |
| RequestedTheme |
取得或設定 UIElement 及其子元素用於資源判斷的 UI 主題。 您使用 |
| RequiresPointer |
取得或設定UI元素是否支援滑鼠模式，以模擬指標互動體驗與非指標輸入設備，例如鍵盤或遊戲控制器。 (繼承來源 Control) |
| Resources |
取得本機定義的資源字典。 在 XAML 中，您可以透過 XAML 隱含集合語法，將資源專案建立為 |
| Rotation |
取得或設定順時針旋轉的角度，以度為單位。 相對於 RotationAxis 和 CenterPoint 旋轉。 影響項目的轉譯位置。 (繼承來源 UIElement) |
| RotationAxis |
取得或設定要繞著元素旋轉的座標軸。 (繼承來源 UIElement) |
| RotationTransition |
取得或設定 ScalarTransition，以動畫顯示 Rotation 屬性的變更。 (繼承來源 UIElement) |
| Scale |
取得或設定項目的縮放比例。 相對於專案的 CenterPoint 縮放比例。 影響項目的轉譯位置。 (繼承來源 UIElement) |
| ScaleTransition |
取得或設定 Vector3Transition，以動畫顯示 Scale 屬性的變更。 (繼承來源 UIElement) |
| ScrollableHeight |
取得值，表示可以捲動的區域垂直大小;範圍的高度與檢視區的高度之間的差異。 |
| ScrollableHeightProperty |
識別 ScrollableHeight 相依性屬性。 |
| ScrollableWidth |
取得值，表示可以捲動的區域水準大小;範圍寬度與檢視區寬度之間的差異。 |
| ScrollableWidthProperty |
識別 ScrollableWidth 相依性屬性。 |
| Shadow |
取得或設定 元素所轉換的陰影效果。 (繼承來源 UIElement) |
| Style |
取得或設定在版面配置和轉譯期間套用給這個對象的實例 Style。 (繼承來源 FrameworkElement) |
| TabFocusNavigation |
取得或設定值，這個值會修改Tabbing和 TabIndex 此控件的運作方式。 (繼承來源 UIElement) |
| TabIndex |
取得或設定值，這個值會決定當使用者使用 索引卷標 索引鍵巡覽控件時，專案接收焦點的順序。 (繼承來源 UIElement) |
| TabNavigation |
取得或設定值，這個值會修改Tabbing和 UIElement.TabIndex 此控件的運作方式。 注意 針對 Windows 10 Creators Update（組建 10.0.15063）和更新版本，TabFocusNavigation 屬性可在 UIElement 基類上使用，以在不使用 controlTemplate的索引卷標序列中包含物件。 |
| Tag |
取得或設定可用來儲存這個物件之自定義資訊的任意物件值。 (繼承來源 FrameworkElement) |
| Template |
取得或設定控件範本。 控件範本會定義 UI 中控制件的視覺外觀，並在 XAML 標記中定義。 (繼承來源 Control) |
| TopHeader |
取得或設定頂端標頭的內容。 |
| TopHeaderProperty |
識別 topHeader 相依性屬性 |
| TopLeftHeader |
取得或設定頂端、左標題的內容。 |
| TopLeftHeaderProperty |
識別 TopLeftHeader 相依性屬性。 |
| Transform3D |
取得或設定轉譯這個專案時要套用的 3D 轉換效果。 (繼承來源 UIElement) |
| TransformMatrix |
取得或設定要套用至 項目的轉換矩陣。 (繼承來源 UIElement) |
| Transitions |
取得或設定套用至 UIElement之轉換 樣式專案的集合。 (繼承來源 UIElement) |
| Translation |
取得或設定專案的 x、y 和 z 轉譯位置。 (繼承來源 UIElement) |
| TranslationTransition |
取得或設定 Vector3Transition，以動畫顯示 Translation 屬性的變更。 (繼承來源 UIElement) |
| Triggers |
取得為 FrameworkElement定義的動畫觸發程式集合。 不常使用。 請參閱。 (繼承來源 FrameworkElement) |
| UseLayoutRounding |
取得或設定值，這個值會決定物件及其視覺子樹的轉譯是否應該使用將轉譯對齊整個圖元的四捨五入行為。 (繼承來源 UIElement) |
| UseSystemFocusVisuals |
取得或設定值，這個值表示控件是否使用系統所繪製的焦點視覺效果，或是控件範本中定義的焦點視覺效果。 (繼承來源 UIElement) |
| VerticalAlignment |
取得或設定在面板或專案控件等父對象中組成時，套用至 FrameworkElement 的垂直對齊特性。 (繼承來源 FrameworkElement) |
| VerticalAnchorRatio |
決定 ScrollViewer 錨點的垂直位置， 檢視區。 根據預設，ScrollViewer 會藉由識別最接近錨點的檢視區中的元素，將元素選取為其 CurrentAnchor。 |
| VerticalAnchorRatioProperty |
識別 VerticalAnchorRatio 相依性屬性。 |
| VerticalContentAlignment |
取得或設定控件內容的垂直對齊方式。 (繼承來源 Control) |
| VerticalOffset |
取得內容垂直捲動的距離。 |
| VerticalOffsetProperty |
識別 VerticalOffset 相依性屬性。 |
| VerticalScrollBarVisibility |
取得或設定值，指出是否應該顯示垂直 ScrollBar。 |
| VerticalScrollBarVisibilityProperty |
識別 VerticalScrollBarVisibility 相依性屬性。 |
| VerticalScrollMode |
取得或設定值，這個值決定操作輸入如何影響垂直軸上的捲動行為。 |
| VerticalScrollModeProperty |
識別 VerticalScrollMode 相依性屬性。 |
| VerticalSnapPointsAlignment |
取得或設定值，指出現有貼齊點與初始檢視區垂直對齊的方式。 |
| VerticalSnapPointsAlignmentProperty |
識別 VerticalSnapPointsAlignment 相依性屬性。 |
| VerticalSnapPointsType |
取得或設定值，這個值會宣告操作行為如何響應垂直軸上的貼齊點。 |
| VerticalSnapPointsTypeProperty |
識別 VerticalSnapPointsType 相依性屬性。 |
| ViewportHeight |
取得可檢視內容的垂直大小。 |
| ViewportHeightProperty |
識別 viewportHeight 相依性屬性 |
| ViewportWidth |
取得可檢視內容的水準大小。 |
| ViewportWidthProperty |
識別 viewportWidth 相依性屬性 |
| Visibility |
取得或設定 UIElement的可見性。 不會轉譯不可見的 |
| Width |
取得或設定 FrameworkElement的寬度。 (繼承來源 FrameworkElement) |
| XamlRoot |
取得或設定檢視這個專案 |
| XYFocusDown |
取得或設定當使用者按下遊戲控制器之 Directional Pad （D-pad） 時取得焦點的物件。 (繼承來源 UIElement) |
| XYFocusDownNavigationStrategy |
取得或設定值，指定用來判斷向下瀏覽之目標元素的策略。 (繼承來源 UIElement) |
| XYFocusKeyboardNavigation |
取得或設定值，這個值會啟用或停用使用鍵盤方向箭號的流覽。 (繼承來源 UIElement) |
| XYFocusLeft |
取得或設定當使用者在遊戲控制器的 Directional Pad （D-pad） 上按左鍵時取得焦點的物件。 (繼承來源 UIElement) |
| XYFocusLeftNavigationStrategy |
取得或設定值，指定用來判斷左側導覽之目標元素的策略。 (繼承來源 UIElement) |
| XYFocusRight |
取得或設定當使用者在遊戲控制器的 Directional Pad （D-pad） 上按下滑鼠右鍵時取得焦點的物件。 (繼承來源 UIElement) |
| XYFocusRightNavigationStrategy |
取得或設定值，指定用來判斷右導覽目標元素的策略。 (繼承來源 UIElement) |
| XYFocusUp |
取得或設定當使用者按下遊戲控制器之 Directional Pad （D-pad） 時取得焦點的物件。 (繼承來源 UIElement) |
| XYFocusUpNavigationStrategy |
取得或設定值，指定用來判斷向上瀏覽目標元素的策略。 (繼承來源 UIElement) |
| ZoomFactor |
取得值，這個值表示目前用於內容縮放比例的縮放比例。 |
| ZoomFactorProperty |
識別 zoomFactor 相依性屬性 |
| ZoomMode |
取得或設定值，指出是否啟用 ScrollViewer 內容的縮放行為。 |
| ZoomModeProperty |
識別 ZoomMode 相依性屬性。 |
| ZoomSnapPoints |
取得 ScrollViewer所保留之縮放貼齊點因數的可觀察集合。 |
| ZoomSnapPointsProperty |
識別 ZoomSnapPoints 相依性屬性。 |
| ZoomSnapPointsType |
取得或設定值，這個值表示縮放貼齊點的處理方式以進行互動輸入。 |
| ZoomSnapPointsTypeProperty |
識別 ZoomSnapPointsType 相依性屬性。 |
方法
事件
| AccessKeyDisplayDismissed |
發生於不應再顯示存取金鑰時。 (繼承來源 UIElement) |
| AccessKeyDisplayRequested |
發生於使用者要求顯示存取金鑰時。 (繼承來源 UIElement) |
| AccessKeyInvoked |
發生於使用者完成存取金鑰順序時。 (繼承來源 UIElement) |
| ActualThemeChanged |
發生於 ActualTheme 屬性值已變更時。 (繼承來源 FrameworkElement) |
| AnchorRequested |
發生於 Arrange 傳遞開頭要求錨點時。 處理此事件以覆寫 ScrollViewer 的默認邏輯，以選取錨點元素作為卷動錨定 |
| BringIntoViewRequested |
發生於呼叫此元素或其其中一個子系 StartBringIntoView 時。 (繼承來源 UIElement) |
| CharacterReceived |
當輸入佇列收到單一撰寫字元時發生。 (繼承來源 UIElement) |
| ContextCanceled |
發生於內容輸入手勢繼續操作手勢時，通知專案不應開啟內容飛出視窗。 (繼承來源 UIElement) |
| ContextRequested |
發生於使用者已完成內容輸入手勢時，例如按兩下滑鼠右鍵。 (繼承來源 UIElement) |
| DataContextChanged |
發生於 FrameworkElement.DataContext 屬性的值變更時。 (繼承來源 FrameworkElement) |
| DirectManipulationCompleted |
發生於任何直接操作 ScrollViewer 完成時。 |
| DirectManipulationStarted |
發生於 ScrollViewer 開始的任何直接操作時。 |
| DoubleTapped |
發生於未處理 DoubleTap 此元素點擊測試區域的互動時。 (繼承來源 UIElement) |
| DragEnter |
當輸入系統報告具有這個專案作為目標的基礎拖曳事件時發生。 (繼承來源 UIElement) |
| DragLeave |
當輸入系統報告基礎拖曳事件時，此專案為原點時發生。 (繼承來源 UIElement) |
| DragOver |
當輸入系統報告基礎拖曳事件時，此專案會作為潛在的置放目標發生。 (繼承來源 UIElement) |
| DragStarting |
發生於起始拖曳作業時。 (繼承來源 UIElement) |
| Drop |
當輸入系統報告具有這個項目作為置放目標的基礎置放事件時發生。 (繼承來源 UIElement) |
| DropCompleted |
發生於以這個專案作為來源結束的拖放作業時。 (繼承來源 UIElement) |
| EffectiveViewportChanged |
發生於 FrameworkElement的有效檢視區 變更時。 (繼承來源 FrameworkElement) |
| FocusDisengaged |
當使用者按下遊戲控制器上的 [B/上一頁] 按鈕時，會從控件釋放焦點時發生。 (繼承來源 Control) |
| FocusEngaged |
當使用者按下遊戲控制器上的 A/Select 按鈕時，焦點會限制為控件。 (繼承來源 Control) |
| GettingFocus |
發生於 UIElement 收到焦點之前。 此事件會以同步方式引發，以確保事件發生反升時不會移動焦點。 (繼承來源 UIElement) |
| GotFocus |
發生於 UIElement 收到焦點時。 這個事件會以異步方式引發，因此焦點可以在升泡完成之前再次移動。 (繼承來源 UIElement) |
| Holding |
發生於未處理的 保留 互動發生在這個項目的點擊測試區域時。 (繼承來源 UIElement) |
| IsEnabledChanged |
發生於 IsEnabled 屬性變更時。 (繼承來源 Control) |
| KeyDown |
發生於按下鍵盤按鍵時，UIElement 有焦點時。 (繼承來源 UIElement) |
| KeyUp |
當 UIElement 焦點時放開鍵盤按鍵時發生。 (繼承來源 UIElement) |
| LayoutUpdated |
發生於可視化樹狀結構的版面配置變更時，因為配置相關屬性會變更值或重新整理版面配置的其他動作。 (繼承來源 FrameworkElement) |
| Loaded |
發生於已建構並新增至物件樹狀結構 FrameworkElement，並準備好進行互動時。 (繼承來源 FrameworkElement) |
| Loading |
發生於 FrameworkElement 開始載入時。 (繼承來源 FrameworkElement) |
| LosingFocus |
發生於 UIElement 失去焦點之前。 此事件會以同步方式引發，以確保事件發生反升時不會移動焦點。 (繼承來源 UIElement) |
| LostFocus |
發生於 UIElement 失去焦點時。 這個事件會以異步方式引發，因此焦點可以在升泡完成之前再次移動。 (繼承來源 UIElement) |
| ManipulationCompleted |
發生於 UIElement 上的操作完成時。 (繼承來源 UIElement) |
| ManipulationDelta |
當輸入裝置在操作期間變更位置時發生。 (繼承來源 UIElement) |
| ManipulationInertiaStarting |
當輸入裝置在操作和慣性開始時與 UIElement 物件失去接觸時發生。 (繼承來源 UIElement) |
| ManipulationStarted |
當輸入裝置開始操作 UIElement時發生。 (繼承來源 UIElement) |
| ManipulationStarting |
第一次建立操作處理器時發生。 (繼承來源 UIElement) |
| NoFocusCandidateFound |
發生於使用者嘗試移動焦點時（透過定位鍵或方向箭號），但焦點不會移動，因為移動方向找不到任何焦點候選專案。 (繼承來源 UIElement) |
| PointerCanceled |
發生於使聯繫人異常失去聯繫人的指標時。 (繼承來源 UIElement) |
| PointerCaptureLost |
當這個專案先前持有的指標擷取移至另一個專案或其他地方時發生。 (繼承來源 UIElement) |
| PointerEntered |
當指標進入這個項目的點擊測試區域時發生。 (繼承來源 UIElement) |
| PointerExited |
發生於指標離開這個項目的點擊測試區域時。 (繼承來源 UIElement) |
| PointerMoved |
發生於指標在指標保留在這個專案點擊測試區域內時移動。 (繼承來源 UIElement) |
| PointerPressed |
當指標裝置起始此元素內的 Press 動作時發生。 (繼承來源 UIElement) |
| PointerReleased |
發生於先前起始 Press 動作的指標裝置，同時在此元素內。 請注意，Press 動作的結尾不保證會引發 |
| PointerWheelChanged |
發生於指標滾輪的差異值變更時。 (繼承來源 UIElement) |
| PreviewKeyDown |
發生於按下鍵盤按鍵時，UIElement 有焦點時。 (繼承來源 UIElement) |
| PreviewKeyUp |
當 UIElement 焦點時放開鍵盤按鍵時發生。 (繼承來源 UIElement) |
| ProcessKeyboardAccelerators |
發生於按下 鍵盤快捷方式（或快捷鍵） 時。 (繼承來源 UIElement) |
| RightTapped |
當指標位於 元素上方時發生右鍵輸入刺激時發生。 (繼承來源 UIElement) |
| SizeChanged |
發生於 ActualHeight 或 ActualWidth 屬性值變更 FrameworkElement時。 (繼承來源 FrameworkElement) |
| Tapped |
發生於未處理的 Tap 互動發生在這個項目的點擊測試區域時。 (繼承來源 UIElement) |
| Unloaded |
當這個物件不再連接到主要物件樹狀結構時發生。 (繼承來源 FrameworkElement) |
| ViewChanged |
發生於卷動和縮放等操作導致檢視變更時。 |
| ViewChanging |
發生於卷動和縮放等操作會導致檢視變更時。 |