ScrollableRegion
Based on UICanvas
Description
Presents scrollable content with optional scrollbars. Behaves similar to the UGUI Panel component.
Dependency Properties
Name | Type | Description |
---|---|---|
AdditionalShaderChannels | AdditionalCanvasShaderChannels | Enum mask of possible shader channel properties that can also be included when the Canvas mesh is created. |
Alignment | ElementAlignment | Used to align the view relative to the layout parent region it resides in. |
Alpha | float | Can be used to adjust the alpha color of this view and all its children. E.g. used for fade in/out animations. Is separate from and different from the background color of the view as it affects the children as well. |
AutoSizeContentRegion | bool | Boolean indicating if the scrollable content region should be adjusted to the size of its content or not. |
BlockingObjects | BlockingObjects | Type of objects that will block graphic raycasts. |
BubbleNotifyChildLayoutChanged | bool | Boolean indicating if parent always should be notified when the child changes layout. |
CanScrollHorizontally | bool | Boolean indicating if the region can be scrolled horizontally. |
CanScrollVertically | bool | Boolean indicating if the region can be scrolled vertically. |
CanvasScalerReferencePixelsPerUnit | float | If a sprite has ‘Pixels Per Unit’ setting, one pixel in the sprite will cover one unit in the UI. |
CanvasScalerScaleFactor | float | Scales all children within the canvas by this factor. |
ContentAlignment | ElementAlignment | Alignment of the content. |
DecelerationRate | float | Determines how fast the scroll speed decelerates once the user stops scrolling. |
DefaultSpriteDPI | float | The pixels per inch to use for sprites that have a ‘Pixels Per Unit’ setting that matches the ‘Reference Pixels Per Unit’ setting. |
DisableInteractionScrollDelta | float | If set any interaction with child views (clicks, etc) are disabled when the specified amount of pixels has been scrolled. Used e.g. to disable items from being selected while scrolling a selectable list of items. |
DisableLayoutUpdate | bool | Boolean indicating if automatic layout updates for this view should be disabled. When disabled the view doesn’t call UpdateLayout() when properties such as Width, Height, etc. changes. |
DisableMouseWheel | bool | Boolean indicating if the mouse wheel is disabled. |
DynamicPixelsPerUnit | float | The amount of pixels per unit to use for dynamically created bitmaps in the UI, such as Text. |
Elasticity | float | Determines how elastic the viewport is when scrolling outside the bounds of the scrollable content. |
EnableScriptEvents | bool | Boolean indicating if unity script events (Update, LateUpdate, Awake, etc) should be relayed to the view code-behind through the corresponding methods that can be overriden. |
FallbackScreenDPI | float | The DPI to assume if the screen DPI is not known. |
GameObject | GameObject | GameObject in the hierarchy that corresponds to the view. |
HasInertia | bool | Boolean indicating if the should stop immediatelly when the user stops scrolling (when set to False) or if it should decelerate based on DecelerationRate. |
Height | ElementSize | The height of the view in pixels or percents. |
HorizontalScrollbarVisibility | ScrollbarVisibilityMode | Enum indicating the visibility mode of the horizontal scrollbar. |
IgnoreFlip | bool | Used when doing localization override default behavior of flipping the view Right to Left or Left to Rigth. |
IgnoreObject | bool | Boolean indicating if the view should be ignored. Ignored objects don’t run any load logic and don’t respond to property changed events. |
IgnoreReversedGraphics | bool | Boolean indicating if graphics facing away from the raycaster should be ignored. |
IsActive | bool | Boolean indicating if the view is active. Deactivated views deactivates corresponding game object, components, renderers and scripts. |
IsVisible | bool | Boolean indicating if view is visible or hidden. Invisible views still take up space but aren’t interactable and have their alpha set to 0. |
LoadMode | LoadMode | Enum flags indicating when and how the view should be loaded by the framework. Can be changed when e.g. the view is to be loaded on-demand. |
Margin | ElementMargin | Adding margins to a view changes the size of the area in which its content resides, but it does not change the width or height of the view. |
MaskContent | bool | Boolean indicating if any content outside the bounds of the viewport should be masked. |
MatchWidthOrHeight | float | Setting to scale the Canvas to match the width or height of the reference resolution, or a combination. |
NormalizedSortingGridSize | float | The normalized grid size that the canvas will split the renderable area into. |
Offset | ElementMargin | Determines the offset of the view. |
OffsetFromParent | ElementMargin | Offset set by a parent view. Used by views like Group to arrange children without changing their own Offset values. |
OverrideHeight | ElementSize | Overrides regular Height value. Used to e.g. automatically size items without changing the default Height value set. |
OverridePixelPerfect | bool | Allows for nested canvases to override pixelPerfect settings inherited from parent canvases. |
OverrideSorting | bool | Override the sorting of canvas. |
OverrideWidth | ElementSize | Overrides regular Width value. Used to e.g. automatically size items without changing the default Width value set. |
PhysicalUnit | Unit | The physical unit to specify positions and sizes in. |
Pivot | Vector2 | The pivot point of the view. |
PixelPerfect | bool | Force elements in the canvas to be aligned with pixels. Only applies with renderMode is Screen Space. |
PlaneDistance | float | How far away from the camera is the Canvas generated. |
Position | Vector3 | Directly sets the local position of the view relative to parent. Position otherwise set using the Alignment and Offset properties. |
RaycastBlockMode | RaycastBlockMode | Enum indicating if raycasts should be blocked. |
ReferencePixelsPerUnit | float | The number of pixels per unit that is considered the default. |
ReferenceResolution | Vector2 | The resolution the UI layout is designed for. |
RenderCamera | string | ID of the world camera camera used when rendering the canvas. |
RenderMode | RenderMode | Enum indicating if the canvas is in world or overlay mode. |
Rotation | Quaternion | Rotation of the view. |
Scale | Vector3 | Scale of the view. |
ScaleFactor | float | Used to scale the entire canvas, while still making it fit the screen. Only applies with renderMode is Screen Space. |
ScreenMatchMode | ScreenMatchMode | A mode used to scale the canvas area if the aspect ratio of the current resolution doesn’t fit the reference resolution. |
ScrollBounds | ScrollBounds | Enum indicating what type of bounds the scrollable region has (Clamped, Elastic or None). |
ScrollEnabled | bool | Boolean indicating if scrolling by the user is enabled. |
ScrollSensitivity | float | Sets the sensitivity of the scrolling using mouse wheel or track pad. |
SortingLayerID | int | Unique ID of the Canvas sorting layer. |
SortingLayerName | string | Name of the Canvas sorting layer. |
SortingOrder | int | Canvas order within a sorting layer. |
TargetDisplay | int | For Overlay mode, display index on which the UI canvas will appear. |
UiScaleMode | ScaleMode | Determines how UI elements in the Canvas are scaled. |
UnblockDragEventsInChildren | bool | Boolean indicating if draggable child views shouldn’t block this scrollable region from being scrolled. |
UseFastShader | bool | Boolean indicating if the default UI shader should be replaced by a simpler and faster one. The faster shader does not support masking and clipping. |
VerticalScrollbarVisibility | ScrollbarVisibilityMode | Enum indicating the visibility mode of the vertical scrollbar. |
Width | ElementSize | The width of the view in pixels or percents. |
WorldCamera | Camera | Reference to the world camera, is automatically set if RenderCamera is set. |