확장 최소화

ScrollViewer Class

보이는 다른 요소가 포함될 수 있는 스크롤 가능한 영역을 나타냅니다.

상속

Object
  DependencyObject
    UIElement
      FrameworkElement
        Control
          ContentControl
            ScrollViewer

구문


public sealed class ScrollViewer : ContentControl


<ScrollViewer .../>
-or-
<ScrollViewer ...>
content
</ScrollViewer>

특성

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

멤버

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

생성자

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

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

 

이벤트

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

이벤트Description
DataContextChanged Occurs when the value of the FrameworkElement.DataContext property changes. (다음에서 상속됨 FrameworkElement)
DoubleTapped Occurs when an otherwise unhandled DoubleTap interaction occurs over the hit test area of this element. (다음에서 상속됨 UIElement)
DragEnter Occurs when the input system reports an underlying drag event with this element as the target. (다음에서 상속됨 UIElement)
DragLeave Occurs when the input system reports an underlying drag event with this element as the origin. (다음에서 상속됨 UIElement)
DragOver Occurs when the input system reports an underlying drag event with this element as the potential drop target. (다음에서 상속됨 UIElement)
Drop Occurs when the input system reports an underlying drop event with this element as the drop target. (다음에서 상속됨 UIElement)
GotFocus Occurs when a UIElement receives focus. (다음에서 상속됨 UIElement)
Holding Occurs when an otherwise unhandled Hold interaction occurs over the hit test area of this element. (다음에서 상속됨 UIElement)
IsEnabledChanged Occurs when the IsEnabled property changes. (다음에서 상속됨 Control)
KeyDown Occurs when a keyboard key is pressed while the UIElement has focus. (다음에서 상속됨 UIElement)
KeyUp Occurs when a keyboard key is released while the UIElement has focus. (다음에서 상속됨 UIElement)
LayoutUpdated Occurs when the layout of the visual tree changes, due to layout-relevant properties changing value or some other action that refreshes the layout. (다음에서 상속됨 FrameworkElement)
Loaded Occurs when a FrameworkElement has been constructed and added to the object tree, and is ready for interaction. (다음에서 상속됨 FrameworkElement)
LostFocus Occurs when a UIElement loses focus. (다음에서 상속됨 UIElement)
ManipulationCompleted Occurs when a manipulation on the UIElement is complete. (다음에서 상속됨 UIElement)
ManipulationDelta Occurs when the input device changes position during a manipulation. (다음에서 상속됨 UIElement)
ManipulationInertiaStarting Occurs when the input device loses contact with the UIElement object during a manipulation and inertia begins. (다음에서 상속됨 UIElement)
ManipulationStarted Occurs when an input device begins a manipulation on the UIElement. (다음에서 상속됨 UIElement)
ManipulationStarting Occurs when the manipulation processor is first created. (다음에서 상속됨 UIElement)
PointerCanceled Occurs when a pointer that made contact abnormally loses contact. (다음에서 상속됨 UIElement)
PointerCaptureLost Occurs when pointer capture previously held by this element moves to another element or elsewhere. (다음에서 상속됨 UIElement)
PointerEntered Occurs when a pointer enters the hit test area of this element. (다음에서 상속됨 UIElement)
PointerExited Occurs when a pointer leaves the hit test area of this element. (다음에서 상속됨 UIElement)
PointerMoved Occurs when a pointer moves while the pointer remains within the hit test area of this element. (다음에서 상속됨 UIElement)
PointerPressed Occurs when the pointer device initiates a Press action within this element. (다음에서 상속됨 UIElement)
PointerReleased Occurs when the pointer device that previously initiated a Press action is released, while within this element. (다음에서 상속됨 UIElement)
PointerWheelChanged Occurs when the delta value of a pointer wheel changes. (다음에서 상속됨 UIElement)
RightTapped Occurs when a right-tap input stimulus happens while the pointer is over the element. (다음에서 상속됨 UIElement)
SizeChanged Occurs when either the ActualHeight or the ActualWidth property changes value on a FrameworkElement. (다음에서 상속됨 FrameworkElement)
Tapped Occurs when an otherwise unhandled Tap interaction occurs over the hit test area of this element. (다음에서 상속됨 UIElement)
Unloaded Occurs when this object is no longer connected to the main object tree. (다음에서 상속됨 FrameworkElement)
ViewChanged Occurs when manipulations such as scrolling and zooming have caused the view to change.
ViewChanging Occurs when manipulations such as scrolling and zooming cause the view to change.

 

메서드

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

메서드Description
AddHandler Adds a routed event handler for a specified routed event, adding the handler to the handler collection on the current element. Specify handledEventsToo as true to have the provided handler be invoked even if the event is handled elsewhere. (다음에서 상속됨 UIElement)
ApplyTemplate Loads the relevant control template so that its parts can be referenced. (다음에서 상속됨 Control)
Arrange Positions child objects and determines a size for a UIElement. Parent objects that implement custom layout for their child elements should call this method from their layout override implementations to form a recursive layout update. (다음에서 상속됨 UIElement)
ArrangeOverride Provides the behavior for the Arrange pass of layout. Classes can override this method to define their own Arrange pass behavior. (다음에서 상속됨 FrameworkElement)
CancelDirectManipulations Cancels ongoing direct manipulation processing (system-defined panning/zooming) on any ScrollViewer parent that contains the current UIElement. (다음에서 상속됨 UIElement)
CapturePointer Sets pointer capture to a UIElement. Once captured, only the element that has capture will fire pointer-related events. (다음에서 상속됨 UIElement)
ChangeView(IReference(Double), IReference(Double), IReference(Single)) Causes the ScrollViewer to load a new view into the viewport using the specified offsets and zoom factor.
ChangeView(IReference(Double), IReference(Double), IReference(Single), Boolean) Causes the ScrollViewer to load a new view into the viewport using the specified offsets and zoom factor, and optionally disables scrolling animation.
ClearValue Clears the local value of a dependency property. (다음에서 상속됨 DependencyObject)
FindName Retrieves an object that has the specified identifier name. (다음에서 상속됨 FrameworkElement)
FindSubElementsForTouchTargeting Enables a UIElement subclass to expose child elements that assist with resolving touch targeting. (다음에서 상속됨 UIElement)
Focus Attempts to set the focus on the control. (다음에서 상속됨 Control)
GetAnimationBaseValue Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (다음에서 상속됨 DependencyObject)
GetBindingExpression Returns the BindingExpression that represents the binding on the specified property. (다음에서 상속됨 FrameworkElement)
GetBringIntoViewOnFocusChange Gets the value of the BringIntoViewOnFocusChange dependency property / ScrollViewer.BringIntoViewOnFocusChange XAML attached property from a specified element.
GetHorizontalScrollBarVisibility Gets the value of the HorizontalScrollBarVisibility dependency property / ScrollViewer.HorizontalScrollBarVisibility XAML attached property from a specified element.
GetHorizontalScrollMode Gets the value of the HorizontalScrollMode dependency property / ScrollViewer.HorizontalScrollMode XAML attached property from a specified element.
GetIsDeferredScrollingEnabled Gets the value of the IsDeferredScrollingEnabled dependency property / ScrollViewer.IsDeferredScrollingInertiaEnabled XAML attached property from a specified element.
GetIsHorizontalRailEnabled Gets the value of the IsHorizontalRailEnabled dependency property / ScrollViewer.IsHorizontalRailEnabled XAML attached property from a specified element.
GetIsHorizontalScrollChainingEnabled Gets the value of the IsHorizontalScrollChainingEnabled dependency property / ScrollViewer.IsHorizontalScrollChainingEnabled XAML attached property from a specified element.
GetIsScrollInertiaEnabled Gets the value of the IsScrollInertiaEnabled dependency property / ScrollViewer.IsScrollInertiaEnabled XAML attached property from a specified element.
GetIsVerticalRailEnabled Gets the value of the IsVerticalRailEnabled dependency property / ScrollViewer.IsVerticalRailEnabled XAML attached property from a specified element.
GetIsVerticalScrollChainingEnabled Gets the value of the IsVerticalScrollChainingEnabled dependency property / ScrollViewer.IsVerticalScrollChainingEnabled XAML attached property from a specified element.
GetIsZoomChainingEnabled Gets the value of the IsZoomChainingEnabled dependency property / ScrollViewer.IsZoomChainingEnabled XAML attached property from a specified element.
GetIsZoomInertiaEnabled Gets the value of the IsZoomInertiaEnabled dependency property / ScrollViewer.IsZoomInertiaEnabled XAML attached property from a specified element.
GetTemplateChild Retrieves the named element in the instantiated ControlTemplate visual tree. (다음에서 상속됨 Control)
GetValue Returns the current effective value of a dependency property from a DependencyObject. (다음에서 상속됨 DependencyObject)
GetVerticalScrollBarVisibility Gets the value of the VerticalScrollBarVisibility dependency property / ScrollViewer.VerticalScrollBarVisibility XAML attached property from a specified element.
GetVerticalScrollMode Gets the value of the VerticalScrollMode dependency property / ScrollViewer.VerticalScrollMode XAML attached property from a specified element.
GetZoomMode Gets the value of the ZoomMode dependency property / ScrollViewer.ZoomMode XAML attached property from a specified element.
GoToElementStateCore When implemented in a derived class, enables per-state construction of a visual tree for a control template in code, rather than by loading XAML for all states at control startup. (다음에서 상속됨 FrameworkElement)
InvalidateArrange Invalidates the arrange state (layout) for a UIElement. After the invalidation, the UIElement will have its layout updated, which will occur asynchronously. (다음에서 상속됨 UIElement)
InvalidateMeasure Invalidates the measurement state (layout) for a UIElement. (다음에서 상속됨 UIElement)
InvalidateScrollInfo Called when the value of properties that describe the size and location of the scroll area change.
Measure Updates the DesiredSize of a UIElement. Typically, objects that implement custom layout for their layout children call this method from their own MeasureOverride implementations to form a recursive layout update. (다음에서 상속됨 UIElement)
MeasureOverride Provides the behavior for the Measure pass of the layout cycle. Classes can override this method to define their own Measure pass behavior. (다음에서 상속됨 FrameworkElement)
OnApplyTemplate Invoked whenever application code or internal processes (such as a rebuilding layout pass) call ApplyTemplate. In simplest terms, this means the method is called just before a UI element displays in your app. Override this method to influence the default post-template logic of a class. (다음에서 상속됨 FrameworkElement)
OnContentChanged Invoked when the value of the Content property changes. (다음에서 상속됨 ContentControl)
OnContentTemplateChanged Invoked when the value of the ContentTemplate property changes. (다음에서 상속됨 ContentControl)
OnContentTemplateSelectorChanged Invoked when the value of the ContentTemplateSelector property changes. (다음에서 상속됨 ContentControl)
OnCreateAutomationPeer When implemented in a derived class, returns class-specific AutomationPeer implementations for the Microsoft UI Automation infrastructure. (다음에서 상속됨 UIElement)
OnDisconnectVisualChildren Override this method to implement how layout and logic should behave when items are removed from a class-specific content or children property. (다음에서 상속됨 UIElement)
OnDoubleTapped Called before the DoubleTapped event occurs. (다음에서 상속됨 Control)
OnDragEnter Called before the DragEnter event occurs. (다음에서 상속됨 Control)
OnDragLeave Called before the DragLeave event occurs. (다음에서 상속됨 Control)
OnDragOver Called before the DragOver event occurs. (다음에서 상속됨 Control)
OnDrop Called before the Drop event occurs. (다음에서 상속됨 Control)
OnGotFocus Called before the GotFocus event occurs. (다음에서 상속됨 Control)
OnHolding Called before the Holding event occurs. (다음에서 상속됨 Control)
OnKeyDown Called before the KeyDown event occurs. (다음에서 상속됨 Control)
OnKeyUp Called before the KeyUp event occurs. (다음에서 상속됨 Control)
OnLostFocus Called before the LostFocus event occurs. (다음에서 상속됨 Control)
OnManipulationCompleted Called before the ManipulationCompleted event occurs. (다음에서 상속됨 Control)
OnManipulationDelta Called before the ManipulationDelta event occurs. (다음에서 상속됨 Control)
OnManipulationInertiaStarting Called before the ManipulationInertiaStarting event occurs. (다음에서 상속됨 Control)
OnManipulationStarted Called before the ManipulationStarted event occurs. (다음에서 상속됨 Control)
OnManipulationStarting Called before the ManipulationStarting event occurs. (다음에서 상속됨 Control)
OnPointerCanceled Called before the PointerCanceled event occurs. (다음에서 상속됨 Control)
OnPointerCaptureLost Called before the PointerCaptureLost event occurs. (다음에서 상속됨 Control)
OnPointerEntered Called before the PointerEntered event occurs. (다음에서 상속됨 Control)
OnPointerExited Called before the PointerExited event occurs. (다음에서 상속됨 Control)
OnPointerMoved Called before the PointerMoved event occurs. (다음에서 상속됨 Control)
OnPointerPressed Called before the PointerPressed event occurs. (다음에서 상속됨 Control)
OnPointerReleased Called before the PointerReleased event occurs. (다음에서 상속됨 Control)
OnPointerWheelChanged Called before the PointerWheelChanged event occurs. (다음에서 상속됨 Control)
OnRightTapped Called before the RightTapped event occurs. (다음에서 상속됨 Control)
OnTapped Called before the Tapped event occurs. (다음에서 상속됨 Control)
ReadLocalValue Returns the local value of a dependency property, if a local value is set. (다음에서 상속됨 DependencyObject)
ReleasePointerCapture Releases pointer captures for capture of one specific pointer by this UIElement. (다음에서 상속됨 UIElement)
ReleasePointerCaptures Releases all pointer captures held by this element. (다음에서 상속됨 UIElement)
RemoveHandler Removes the specified routed event handler from this UIElement. Typically the handler in question was added by AddHandler. (다음에서 상속됨 UIElement)
ScrollToHorizontalOffset Scrolls the content that is within the ScrollViewer to the specified horizontal offset position.
ScrollToVerticalOffset Scrolls the content that is within the ScrollViewer to the specified vertical offset position.
SetBinding Attaches a binding to a FrameworkElement, using the provided binding object. (다음에서 상속됨 FrameworkElement)
SetBringIntoViewOnFocusChange Sets the value of the BringIntoViewOnFocusChange dependency property / ScrollViewer.BringIntoViewOnFocusChange XAML attached property on a specified element.
SetHorizontalScrollBarVisibility Sets the value of the HorizontalScrollBarVisibility dependency property / ScrollViewer.HorizontalScrollBarVisibility XAML attached property on a specified element.
SetHorizontalScrollMode Sets the value of the HorizontalScrollMode dependency property / ScrollViewer.HorizontalScrollMode XAML attached property on a specified element.
SetIsDeferredScrollingEnabled Sets the value of the IsDeferredScrollingEnabled dependency property / ScrollViewer.IsDeferredScrollingEnabled XAML attached property on a specified element.
SetIsHorizontalRailEnabled Sets the value of the IsHorizontalRailEnabled dependency property / ScrollViewer.IsHorizontalRailEnabled XAML attached property on a specified element.
SetIsHorizontalScrollChainingEnabled Sets the value of the IsHorizontalScrollChainingEnabled dependency property / ScrollViewer.IsHorizontalScrollChainingEnabled XAML attached property on a specified element.
SetIsScrollInertiaEnabled Sets the value of the IsScrollInertiaEnabled dependency property / ScrollViewer.IsScrollInertiaEnabled XAML attached property on a specified element.
SetIsVerticalRailEnabled Sets the value of the IsVerticalRailEnabled dependency property / ScrollViewer.IsVerticalRailEnabled XAML attached property on a specified element.
SetIsVerticalScrollChainingEnabled Sets the value of the IsVerticalScrollChainingEnabled dependency property / ScrollViewer.IsVerticalScrollChainingEnabled XAML attached property on a specified element.
SetIsZoomChainingEnabled Sets the value of the IsZoomChainingEnabled dependency property / ScrollViewer.IsZoomChainingEnabled XAML attached property on a specified element.
SetIsZoomInertiaEnabled Sets the value of the IsZoomInertiaEnabled dependency property / ScrollViewer.IsZoomInertiaEnabled XAML attached property on a specified element.
SetValue Sets the local value of a dependency property on a DependencyObject. (다음에서 상속됨 DependencyObject)
SetVerticalScrollBarVisibility Sets the value of the VerticalScrollBarVisibility dependency property / ScrollViewer.VerticalScrollBarVisibility XAML attached property on a specified element.
SetVerticalScrollMode Sets the value of the VerticalScrollMode dependency property / ScrollViewer.VerticalScrollMode XAML attached property on a specified element.
SetZoomMode Sets the value of the ZoomMode dependency property / ScrollViewer.ZoomMode XAML attached property on a specified element.
TransformToVisual Returns a transform object that can be used to transform coordinates from the UIElement to the specified object. (다음에서 상속됨 UIElement)
UpdateLayout Ensures that all positions of child objects of a UIElement are properly updated for layout. (다음에서 상속됨 UIElement)
ZoomToFactor Sets the effective value of ZoomFactor.

 

속성

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

속성사용 권한Description

ActualHeight

읽기 전용Gets the rendered height of a FrameworkElement. (다음에서 상속됨 FrameworkElement)

ActualWidth

읽기 전용Gets the rendered width of a FrameworkElement. (다음에서 상속됨 FrameworkElement)

AllowDrop

읽기/쓰기Gets or sets a value that determines whether this UIElement can be a drop target for purposes of drag-and-drop operations. (다음에서 상속됨 UIElement)

Background

읽기/쓰기Gets or sets a brush that provides the background of the control. (다음에서 상속됨 Control)

BaseUri

읽기 전용Gets a Uniform Resource Identifier (URI) that represents the base Uniform Resource Identifier (URI) for an XAML-constructed object at XAML load time. This property is useful for Uniform Resource Identifier (URI) resolution at run time. (다음에서 상속됨 FrameworkElement)

BorderBrush

읽기/쓰기Gets or sets a brush that describes the border background of a control. (다음에서 상속됨 Control)

BorderThickness

읽기/쓰기Gets or sets the border thickness of a control. (다음에서 상속됨 Control)

BringIntoViewOnFocusChange

읽기/쓰기Gets or sets a value that determines whether the ScrollViewer uses a bring-into-view scroll behavior when an item in the view gets focus.

BringIntoViewOnFocusChangeProperty

읽기 전용Identifies the BringIntoViewOnFocusChange dependency property.

CacheMode

읽기/쓰기Gets or sets a value that indicates that rendered content should be cached as a composited bitmap when possible. (다음에서 상속됨 UIElement)

CharacterSpacing

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

Clip

읽기/쓰기Gets or sets the RectangleGeometry used to define the outline of the contents of a UIElement. (다음에서 상속됨 UIElement)

CompositeMode

읽기/쓰기Gets or sets a property that declares alternate composition and blending modes for the element in its parent layout and window. This is relevant for elements that are involved in a mixed XAML / Microsoft DirectX UI. (다음에서 상속됨 UIElement)

ComputedHorizontalScrollBarVisibility

읽기 전용Gets a value that indicates whether the horizontal ScrollBar is visible.

ComputedHorizontalScrollBarVisibilityProperty

읽기 전용Identifies the ComputedHorizontalScrollBarVisibility dependency property.

ComputedVerticalScrollBarVisibility

읽기 전용Gets a value that indicates whether the vertical ScrollBar is visible.

ComputedVerticalScrollBarVisibilityProperty

읽기 전용Identifies the ComputedVerticalScrollBarVisibility dependency property.

Content

읽기/쓰기Gets or sets the content of a ContentControl. (다음에서 상속됨 ContentControl)

ContentTemplate

읽기/쓰기Gets or sets the data template that is used to display the content of the ContentControl. (다음에서 상속됨 ContentControl)

ContentTemplateRoot

읽기 전용Gets the root element of the date template specified by the ContentTemplate property. (다음에서 상속됨 ContentControl)

ContentTemplateSelector

읽기/쓰기Gets or sets a selection object that changes the DataTemplate to apply for content, based on processing information about the content item or its container at run time. (다음에서 상속됨 ContentControl)

ContentTransitions

읽기/쓰기Gets or sets the collection of Transition style elements that apply to the content of a ContentControl. (다음에서 상속됨 ContentControl)

DataContext

읽기/쓰기Gets or sets the data context for a FrameworkElement when it participates in data binding. (다음에서 상속됨 FrameworkElement)

DefaultStyleKey

읽기/쓰기Gets or sets the key that references the default style for the control. Authors of custom controls use this property to change the default for the style that their control uses. (다음에서 상속됨 Control)

DesiredSize

읽기 전용Gets the size that this UIElement computed during the measure pass of the layout process. (다음에서 상속됨 UIElement)

Dispatcher

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

ExtentHeight

읽기 전용Gets the vertical size of all the scrollable content in the ScrollViewer.

ExtentHeightProperty

읽기 전용Identifier for the ExtentHeight dependency property.

ExtentWidth

읽기 전용Gets the horizontal size of all the scrollable content in the ScrollViewer.

ExtentWidthProperty

읽기 전용Identifier for the ExtentWidth dependency property.

FlowDirection

읽기/쓰기Gets or sets the direction in which text and other UI elements flow within any parent element that controls their layout. This property can be set to either LeftToRight or RightToLeft. Setting FlowDirection to RightToLeft on any element sets the alignment to the right, the reading order to right-to-left and the layout of the control to flow from right to left. (다음에서 상속됨 FrameworkElement)

FocusState

읽기 전용Gets a value that specifies whether this control has focus, and the mode by which focus was obtained. (다음에서 상속됨 Control)

FontFamily

읽기/쓰기Gets or sets the font used to display text in the control. (다음에서 상속됨 Control)

FontSize

읽기/쓰기Gets or sets the size of the text in this control. (다음에서 상속됨 Control)

FontStretch

읽기/쓰기Gets or sets the degree to which a font is condensed or expanded on the screen. (다음에서 상속됨 Control)

FontStyle

읽기/쓰기Gets or sets the style in which the text is rendered. (다음에서 상속됨 Control)

FontWeight

읽기/쓰기Gets or sets the thickness of the specified font. (다음에서 상속됨 Control)

Foreground

읽기/쓰기Gets or sets a brush that describes the foreground color. (다음에서 상속됨 Control)

Height

읽기/쓰기Gets or sets the suggested height of a FrameworkElement. (다음에서 상속됨 FrameworkElement)

HorizontalAlignment

읽기/쓰기Gets or sets the horizontal alignment characteristics that are applied to a FrameworkElement when it is composed in a layout parent, such as a panel or items control. (다음에서 상속됨 FrameworkElement)

HorizontalContentAlignment

읽기/쓰기Gets or sets the horizontal alignment of the control's content. (다음에서 상속됨 Control)

HorizontalOffset

읽기 전용Gets the distance the content has been scrolled horizontally.

HorizontalOffsetProperty

읽기 전용Identifies the HorizontalOffset dependency property.

HorizontalScrollBarVisibility

읽기/쓰기Gets or sets a value that indicates whether a horizontal ScrollBar should be displayed.

HorizontalScrollBarVisibilityProperty

읽기 전용Identifies the HorizontalScrollBarVisibility dependency property.

HorizontalScrollMode

읽기/쓰기Gets or sets a value that determines how manipulation input influences scrolling behavior on the horizontal axis.

HorizontalScrollModeProperty

읽기 전용Identifies the HorizontalScrollMode dependency property.

HorizontalSnapPointsAlignment

읽기/쓰기Gets or sets a value that indicates how the existing snap points are horizontally aligned versus the initial viewport.

HorizontalSnapPointsAlignmentProperty

읽기 전용Identifies the HorizontalSnapPointsAlignment dependency property.

HorizontalSnapPointsType

읽기/쓰기Gets or sets a value that declares how manipulation behavior reacts to the snap points along the horizontal axis.

HorizontalSnapPointsTypeProperty

읽기 전용Identifies the HorizontalSnapPointsType dependency property.

IsDeferredScrollingEnabled

읽기/쓰기Gets or sets a value that determines the deferred scrolling behavior for a ScrollViewer.

IsDeferredScrollingEnabledProperty

읽기 전용Identifies the IsDeferredScrollingEnabled dependency property.

IsDoubleTapEnabled

읽기/쓰기Gets or sets a value that determines whether the DoubleTapped event can originate from that element. (다음에서 상속됨 UIElement)

IsEnabled

읽기/쓰기Gets or sets a value indicating whether the user can interact with the control. (다음에서 상속됨 Control)

IsHitTestVisible

읽기/쓰기Gets or sets whether the contained area of this UIElement can return true values for hit testing. (다음에서 상속됨 UIElement)

IsHoldingEnabled

읽기/쓰기Gets or sets a value that determines whether the Holding event can originate from that element. (다음에서 상속됨 UIElement)

IsHorizontalRailEnabled

읽기/쓰기Gets or sets a value that indicates whether the scroll rail is enabled for the horizontal axis.

IsHorizontalRailEnabledProperty

읽기 전용Identifies the IsHorizontalRailEnabled dependency property.

IsHorizontalScrollChainingEnabled

읽기/쓰기Gets or sets a value that indicates whether scroll chaining is enabled from this child to its parent, for the horizontal axis.

IsHorizontalScrollChainingEnabledProperty

읽기 전용Identifies the IsHorizontalScrollChainingEnabled dependency property.

IsRightTapEnabled

읽기/쓰기Gets or sets a value that determines whether the RightTapped event can originate from that element. (다음에서 상속됨 UIElement)

IsScrollInertiaEnabled

읽기/쓰기Gets or sets a value that indicates whether scroll actions should include inertia in their behavior and value.

IsScrollInertiaEnabledProperty

읽기 전용Identifies the IsScrollInertiaEnabled dependency property.

IsTabStop

읽기/쓰기Gets or sets a value that indicates whether a control is included in tab navigation. (다음에서 상속됨 Control)

IsTapEnabled

읽기/쓰기Gets or sets a value that determines whether the Tapped event can originate from that element. (다음에서 상속됨 UIElement)

IsVerticalRailEnabled

읽기/쓰기Gets or sets a value that indicates whether the scroll rail is enabled for the vertical axis.

IsVerticalRailEnabledProperty

읽기 전용Identifies the IsVerticalRailEnabled dependency property.

IsVerticalScrollChainingEnabled

읽기/쓰기Gets or sets a value that indicates whether scroll chaining is enabled from this child to its parent, for the vertical axis.

IsVerticalScrollChainingEnabledProperty

읽기 전용Identifies the IsVerticalScrollChainingEnabled dependency property.

IsZoomChainingEnabled

읽기/쓰기Gets or sets a value that indicates whether zoom chaining is enabled from this child to its parent.

IsZoomChainingEnabledProperty

읽기 전용Identifies the IsZoomChainingEnabled dependency property.

IsZoomInertiaEnabled

읽기/쓰기Gets or sets a value that indicates whether zoom actions should include inertia in their behavior and value.

IsZoomInertiaEnabledProperty

읽기 전용Identifies the IsZoomInertiaEnabled dependency property.

Language

읽기/쓰기Gets or sets localization/globalization language information that applies to a FrameworkElement, and also to all child elements of the current FrameworkElement in the object representation and in UI. (다음에서 상속됨 FrameworkElement)

LeftHeader

읽기/쓰기Gets or sets the content of the left header.

LeftHeaderProperty

읽기 전용Identifies the LeftHeader dependency property.

ManipulationMode

읽기/쓰기Gets or sets the ManipulationModes value used for UIElement behavior and interaction with gestures. Setting this value enables handling the manipulation events from this element in app code. (다음에서 상속됨 UIElement)

Margin

읽기/쓰기Gets or sets the outer margin of a FrameworkElement. (다음에서 상속됨 FrameworkElement)

MaxHeight

읽기/쓰기Gets or sets the maximum height constraint of a FrameworkElement. (다음에서 상속됨 FrameworkElement)

MaxWidth

읽기/쓰기Gets or sets the maximum width constraint of a FrameworkElement. (다음에서 상속됨 FrameworkElement)

MaxZoomFactor

읽기/쓰기Gets or sets a value that indicates the maximum permitted run-time value of ZoomFactor.

MaxZoomFactorProperty

읽기 전용Identifies the MaxZoomFactor dependency property.

MinHeight

읽기/쓰기Gets or sets the minimum height constraint of a FrameworkElement. (다음에서 상속됨 FrameworkElement)

MinWidth

읽기/쓰기Gets or sets the minimum width constraint of a FrameworkElement. (다음에서 상속됨 FrameworkElement)

MinZoomFactor

읽기/쓰기Gets or sets a value that indicates the minimum permitted run-time value of ZoomFactor.

MinZoomFactorProperty

읽기 전용Identifies the MinZoomFactor dependency property.

Name

읽기/쓰기Gets or sets the identifying name of the object. When a XAML processor creates the object tree from XAML markup, run-time code can refer to the XAML-declared object by this name. (다음에서 상속됨 FrameworkElement)

Opacity

읽기/쓰기Gets or sets the degree of the object's opacity. (다음에서 상속됨 UIElement)

Padding

읽기/쓰기Gets or sets the padding inside a control. (다음에서 상속됨 Control)

Parent

읽기 전용Gets the parent object of this FrameworkElement in the object tree. (다음에서 상속됨 FrameworkElement)

PointerCaptures

읽기 전용Gets the set of all captured pointers, represented as Pointer values. (다음에서 상속됨 UIElement)

Projection

읽기/쓰기Gets or sets the perspective projection (3-D effect) to apply when rendering this element. (다음에서 상속됨 UIElement)

RenderSize

읽기 전용Gets the final render size of a UIElement. (다음에서 상속됨 UIElement)

RenderTransform

읽기/쓰기Gets or sets transform information that affects the rendering position of a UIElement. (다음에서 상속됨 UIElement)

RenderTransformOrigin

읽기/쓰기Gets or sets the origin point of any possible render transform declared by RenderTransform, relative to the bounds of the UIElement. (다음에서 상속됨 UIElement)

RequestedTheme

읽기/쓰기Gets or sets the UI theme that is used by the UIElement (and its child elements) for resource determination. The UI theme you specify with RequestedTheme can override the app-level RequestedTheme. (다음에서 상속됨 FrameworkElement)

Resources

읽기/쓰기Gets the locally defined resource dictionary. In XAML, you can establish resource items as child object elements of a frameworkElement.Resources property element, through XAML implicit collection syntax. (다음에서 상속됨 FrameworkElement)

ScrollableHeight

읽기 전용Gets a value that represents the vertical size of the area that can be scrolled; the difference between the width of the extent and the width of the viewport.

ScrollableHeightProperty

읽기 전용Identifies the ScrollableHeight dependency property.

ScrollableWidth

읽기 전용Gets a value that represents the horizontal size of the area that can be scrolled; the difference between the width of the extent and the width of the viewport.

ScrollableWidthProperty

읽기 전용Identifies the ScrollableWidth dependency property.

Style

읽기/쓰기Gets or sets an instance Style that is applied for this object during layout and rendering. (다음에서 상속됨 FrameworkElement)

TabIndex

읽기/쓰기Gets or sets a value that determines the order in which elements receive focus when the user navigates through controls by pressing the Tab key. (다음에서 상속됨 Control)

TabNavigation

읽기/쓰기Gets or sets a value that modifies how tabbing and TabIndex work for this control. (다음에서 상속됨 Control)

Tag

읽기/쓰기Gets or sets an arbitrary object value that can be used to store custom information about this object. (다음에서 상속됨 FrameworkElement)

Template

읽기/쓰기Gets or sets a control template. The control template defines the visual appearance of a control in UI, and is defined in XAML markup. (다음에서 상속됨 Control)

TopHeader

읽기/쓰기Gets or sets the content of the top header.

TopHeaderProperty

읽기 전용Identifies the TopHeader dependency property.

TopLeftHeader

읽기/쓰기Gets or sets the content of the top, left header.

TopLeftHeaderProperty

읽기 전용Identifies the TopLeftHeader dependency property.

Transitions

읽기/쓰기Gets or sets the collection of Transition style elements that apply to a UIElement. (다음에서 상속됨 UIElement)

Triggers

읽기 전용Gets the collection of triggers for animations that are defined for a FrameworkElement. Not commonly used. (다음에서 상속됨 FrameworkElement)

UseLayoutRounding

읽기/쓰기Gets or sets a value that determines whether rendering for the object and its visual subtree should use rounding behavior that aligns rendering to whole pixels. (다음에서 상속됨 UIElement)

VerticalAlignment

읽기/쓰기Gets or sets the vertical alignment characteristics that are applied to a FrameworkElement when it is composed in a parent object such as a panel or items control. (다음에서 상속됨 FrameworkElement)

VerticalContentAlignment

읽기/쓰기Gets or sets the vertical alignment of the control's content. (다음에서 상속됨 Control)

VerticalOffset

읽기 전용Gets the distance the content has been scrolled vertically.

VerticalOffsetProperty

읽기 전용Identifies the VerticalOffset dependency property.

VerticalScrollBarVisibility

읽기/쓰기Gets or sets a value that indicates whether a vertical ScrollBar should be displayed.

VerticalScrollBarVisibilityProperty

읽기 전용Identifies the VerticalScrollBarVisibility dependency property.

VerticalScrollMode

읽기/쓰기Gets or sets a value that determines how manipulation input influences scrolling behavior on the vertical axis.

VerticalScrollModeProperty

읽기 전용Identifies the VerticalScrollMode dependency property.

VerticalSnapPointsAlignment

읽기/쓰기Gets or sets a value that indicates how the existing snap points are vertically aligned versus the initial viewport.

VerticalSnapPointsAlignmentProperty

읽기 전용Identifies the VerticalSnapPointsAlignment dependency property.

VerticalSnapPointsType

읽기/쓰기Gets or sets a value that declares how manipulation behavior reacts to the snap points along the vertical axis.

VerticalSnapPointsTypeProperty

읽기 전용Identifies the VerticalSnapPointsType dependency property.

ViewportHeight

읽기 전용Gets the vertical size of the viewable content.

ViewportHeightProperty

읽기 전용Identifies the ViewportHeight dependency property.

ViewportWidth

읽기 전용Gets the horizontal size of the viewable content.

ViewportWidthProperty

읽기 전용Identifies the ViewportWidth dependency property.

Visibility

읽기/쓰기Gets or sets the visibility of a UIElement. A UIElement that is not visible is not rendered and does not communicate its desired size to layout. (다음에서 상속됨 UIElement)

Width

읽기/쓰기Gets or sets the width of a FrameworkElement. (다음에서 상속됨 FrameworkElement)

ZoomFactor

읽기 전용Gets a value that indicates the current zoom factor engaged for content scaling.

ZoomFactorProperty

읽기 전용Identifies the ZoomFactor dependency property.

ZoomMode

읽기/쓰기Gets or sets a value that indicates whether zoom behavior in the ScrollViewer content is enabled.

ZoomModeProperty

읽기 전용Identifies the ZoomMode dependency property.

ZoomSnapPoints

읽기 전용Gets the observable collection of zoom snap point factors that are held by the ScrollViewer.

ZoomSnapPointsProperty

읽기 전용Identifies the ZoomSnapPoints dependency property.

ZoomSnapPointsType

읽기/쓰기Gets or sets a value that indicates how zoom snap points are processed for interaction input.

ZoomSnapPointsTypeProperty

읽기 전용Identifies the ZoomSnapPointsType dependency property.

 

설명

ScrollViewer를 사용하면 콘텐츠를 실제 크기보다 작은 영역에 표시할 수 있습니다. ScrollViewer의 콘텐츠가 완전히 보이지 않으면 표시되는 콘텐츠 영역을 이동하는 데 사용할 수 있는 스크롤 막대가 ScrollViewer에 표시됩니다. ScrollViewer의 모든 콘텐츠가 포함되는 영역을 범위라고 합니다. 콘텐츠의 표시 영역을 뷰포트라고 합니다.

앱 페이지 UI의 일부로 ScrollViewer 요소를 선언하는 것은 일반적이지 않습니다. ScrollViewer 컨트롤은 다른 컨트롤의 합성 파트로 존재하는 것이 보다 일반적입니다. 지원을 위한 ScrollContentPresenter 클래스와 함께 ScrollViewer 부분은 호스트 컨트롤의 레이아웃 공간이 확장된 내용 크기보다 작게 제한되는 경우에만 스크롤 막대와 함께 뷰포트를 표시합니다. 목록은 대체로 이러한 경우에 해당하므로 ListViewGridView 템플릿에는 항상 ScrollViewer가 포함됩니다. TextBoxRichEditBox는 템플릿에 ScrollViewer도 포함되어 있습니다.

컨트롤의 ScrollViewer 부분이 있는 경우 대체로 호스트 컨트롤에 콘텐츠를 스크롤할 수 있게 하는 조작 및 특정 입력 이벤트에 대한 기본 제공 이벤트 처리가 있습니다. 예를 들어 GridView는 살짝 밀기 제스처를 해석하여 콘텐츠를 가로로 스크롤합니다. 호스트 컨트롤이 받는 입력 이벤트 및 원시 조작은 해당 컨트롤에 의해 처리되는 것으로 간주되므로 PointerPressed와 같은 하위 수준 이벤트가 발생하거나 부모 컨테이너로 버블링되지 않습니다. 컨트롤 클래스 및 이벤트에 대한 On* 가상 메서드를 재정의하거나 컨트롤의 템플릿을 다시 작성하여 일부 기본 제공 컨트롤 처리를 변경할 수 있습니다. 그러나 일반적으로 이벤트 및 사용자의 입력 작업과 제스처에 대해 예상된 방법으로 컨트롤이 반응해야 하므로 두 경우 모두 원래 기본 동작을 재현하는 것은 간단하지 않습니다. 따라서 해당 입력 이벤트를 발생시켜야 하는지 여부를 고려해야 합니다. 컨트롤에서 처리되지 않는 다른 입력 이벤트나 제스처가 있는지 여부를 조사하고 앱 또는 컨트롤 조작 디자인에 사용하는 것이 좋습니다.

ScrollViewer를 포함하는 컨트롤이 ScrollViewer 부분에 있는 일부 동작과 속성에 영향을 줄 수 있도록 ScrollViewer는 스타일에서 설정하고 템플릿 바인딩에 사용할 수 있는 많은 XAML 연결된 속성을 정의합니다.

ScrollViewer XAML 연결 속성

ScrollViewer는 다음과 같은 XAML 연결 속성을 정의합니다.

이러한 XAML 연결 속성은 ScrollViewerListView 또는 GridView에 대한 기본 템플릿에 있고 템플릿 부분에 액세스하지 않고 컨트롤의 스크롤 동작에 영향을 미칠 수 있기를 원할 때처럼 ScrollViewer가 암시적인 경우 사용됩니다. 예제 섹션의 예제 코드에서와 같이 XAML에 ScrollViewer가 명시된 경우 연결된 속성 구문을 사용할 필요가 없습니다. 특성 구문을 사용합니다(예: <ScrollViewer ZoomMode="Enabled" />).

연결된 속성에 대한 XAML 프로세서 액세스를 지원하고 해당하는 가져오기 및 설정 작업을 코드에 노출하기 위해 각 XAML 연결된 속성에는 GetSet 접근자 메서드 쌍이 있습니다. 예를 들어 GetHorizontalScrollModeSetHorizontalScrollMode 메서드는 ScrollViewer.HorizontalScrollMode에 대해 동일한 코드 전용 지원을 제공합니다. 또는 종속성 속성 시스템을 사용하여 연결된 속성의 값을 가져오거나 설정할 수 있습니다. 설정할 종속성 속성 식별자의 인수와 값을 가져오거나 설정할 대상 개체에 대한 참조를 전달하여 GetValue 또는 SetValue를 호출합니다.

Windows 8 동작

트랙 패드 장치에 의한 제스처 처리

Windows 8의 경우 ScrollViewer 컨트롤 부분에 의해 입력이 처리되는 트랙 패드 장치 제스처는 마우스 휠 입력으로 해석되므로 PointerWheelChanged 이벤트가 발생됩니다. Windows 8.1부터는 ScrollViewer가 트랙 패드 제스처를 ScrollViewer가 응답하는 작업으로 해석하는 기본 조작 논리를 사용하므로 해당 컨트롤이 이 제스처를 처리하는 것으로 간주되고 PointerWheelChanged 이벤트가 더 이상 발생하지 않습니다.

앱 코드를 Windows 8에서 Windows 8.1로 마이그레이션하는 경우 이러한 동작 변경을 고려해야 합니다. PointerWheelChanged가 발생하는 경우도 있기 때문입니다. 또한 이제 ScrollViewer에 기본 제공된 동작이 사용자의 처리기가 수행하는 작업과 중복될 수 있습니다.

Windows 8에 대해 컴파일되었지만 Windows 8.1에서 실행하는 앱이 계속해서 Windows 8 동작을 사용합니다.

화상 키보드용 앱 UI

Windows 8에는 사용자가 화상 키보드를 호출할 때마다 ScrollViewer를 전체 앱 UI에 연결하는 내부적으로 구현된 논리가 있었습니다. 이 화상 키보드는 사용자가 접근성 센터를 통해 요청하는 특정한 접근성 기능입니다. 시스템이 키보드 장치를 검색하지 못한 경우 앱 UI에서 텍스트 입력 컨트롤로 표시될 수 있는 소프트 키보드와는 다릅니다. 내부 ScrollViewer가 여기서 수행하는 작업은 키보드가 UI 공간을 차지하고 있기 때문에 스크롤해야 하는 경우 앱이 있는 영역을 스크롤할 수 있게 합니다.

Windows 8.1부터는 시스템에 화면 키보드가 나타날 때의 UI/레이아웃 동작이 있지만 내부적으로 만들어진 이 ScrollViewer는 더 이상 사용되지 않습니다. 대신, 앱 코드에서 변경하거나 검사할 수 없는 전용 내부 컨트롤을 사용합니다.

이 동작 변경의 대부분의 측면은 앱에 영향을 주지 않습니다. 그러나 앱은 레이아웃 변경을 의미하는 ScrollViewer의 암시적 Style을 제공하거나, 내부적으로 생성된 ScrollViewer를 찾아 런타임에서 변경하기 위해 VisualTreeHelper를 사용하여 트리를 탐색함으로써 이 동작을 예상했을 수 있습니다. Windows 8.1용으로 컴파일된 앱에는 해당 코드가 유용하지 않습니다.

Windows 8에 대해 컴파일되었지만 Windows 8.1에서 실행하는 앱이 계속해서 Windows 8 동작을 사용합니다.

예제

다음 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>


요구 사항

지원되는 최소 클라이언트

Windows 8 [Windows 스토어 앱만]

지원되는 최소 서버

Windows Server 2012 [Windows 스토어 앱만]

Namespace

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

Metadata

Windows.winmd

참고 항목

ContentControl
ListView 및 GridView 컨트롤 추가

 

 

표시:
© 2015 Microsoft