1. Epic GamesDeveloper
  3. STableViewBase

STableViewBase

Contains ListView functionality that does not depend on the type of data being observed by the ListView.

API > API/Runtime > API/Runtime/Slate > API/Runtime/Slate/Widgets > API/Runtime/Slate/Widgets/Views

Inheritance Hierarchy

References

   
Module Slate
Header /Engine/Source/Runtime/Slate/Public/Widgets/Views/STableViewBase.h
Include #include "Widgets/Views/STableViewBase.h"

Syntax

class STableViewBase :  
    public SCompoundWidget ,  
    public IScrollableWidget

Remarks

Contains ListView functionality that does not depend on the type of data being observed by the ListView.

Variables

  Type Name Description
Protected variable EAllowOverscroll AllowOverscroll Whether to permit overscroll on this list view
Protected variable float AmountScrolledWhileRightMouseDown How much we scrolled while the rmb has been held
Protected variable FInvalidatableBrushAttribute BackgroundBrush Brush resource representing the background area of the view
Protected variable bool bEnableAnimatedScrolling True to lerp smoothly between offsets when the desired scroll offset changes.
Protected variable bool bEnableRightClickScrolling True to allow right click drag scrolling.
Protected variable bool bEnableTouchAnimatedScrolling True to lerp smoothly between offsets when the desired scroll offset changes with touch.
Protected variable bool bEnableTouchScrolling True to allow scrolling by using touch input.
Protected variable bool bIsPointerScrollingEnabled Wheter the list is allowed to scroll.
Protected variable bool bIsScrollingActiveTimerRegistered Whether the active timer to update the inertial scrolling is currently registered
Protected variable bool bShowSoftwareCursor Whether the software cursor should be drawn in the viewport
Protected variable bool bStartedTouchInteraction Did the user start an interaction in this list?
Protected variable bool bWasAtEndOfList Last time we scrolled, did we end up at the end of the list.
Protected variable EConsumeMouseWheel ConsumeMouseWheel How we should handle scrolling with the mouse wheel
Protected variable double CurrentScrollOffset The currently displayed scroll offset from the beginning of the list in items.
Protected variable double DesiredScrollOffset The raw desired scroll offset from the beginning of the list in items.
Protected variable TOptional< double > FixedLineScrollOffset The fixed offset in lines to always apply to the top/left (depending on orientation) of the list.
Protected variable TSharedPtr< SHeaderRow > HeaderRow Column headers that describe which columns this list shows
Protected variable FInertialScrollManager InertialScrollManager Helper object to manage inertial scrolling
Protected variable TSharedPtr< SListPanel > ItemsPanel The panel which holds the visible widgets in this list
Protected variable FReGenerateResults LastGenerateResults Information about the widgets we generated during the last regenerate pass
Protected variable FOnContextMenuOpening OnContextMenuOpening Delegate to invoke when the context menu should be opening.
Protected variable FOnTableViewScrolled OnTableViewScrolled Delegate to call when the table view is scrolled
Protected variable EOrientation Orientation The layout and scroll orientation of the list
Protected variable FOverscroll Overscroll  
Protected variable FGeometry PanelGeometryLastTick What the list's geometry was the last time a refresh occurred.
Protected variable TSharedPtr< SListPanel > PinnedItemsPanel The panel which holds the pinned widgets in this list
Protected variable FVector2f PressedScreenSpacePosition The location in screenspace the view was pressed
Protected variable TSharedPtr< SScrollBar > ScrollBar The scroll bar widget
Protected variable TAttribute< ESelectionMode::Type > SelectionMode The selection mode that this tree/list is in.
Protected variable FVector2f SoftwareCursorPosition The current position of the software cursor
Public variable const ETableViewMode::Type TableViewMode Is this list backing a tree or just a standalone list
Protected variable float TickScrollDelta The amount we have scrolled this tick cycle
Protected variable float WheelScrollMultiplier How much to scroll when using mouse wheel

Constructors

  Type Name Description
Protected function  

STableViewBase ( ETableViewMode::Type InTableViewMode
)

  

Functions

  Type Name Description
Public function void

AddScrollOffset ( const float InScrollOffsetDelta,
bool RefreshList
)

 Add the scroll offset of this view (in items)
Protected function void

AppendPinnedWidget ( const TSharedRef< SWidget >& WidgetToAppend
)

 Add a WidgetToAppend to the bottom of the pinned view.
Protected function void

AppendWidget ( const TSharedRef< ITableRow >& WidgetToAppend
)

 Add a WidgetToAppend to the bottom of the view.
Protected function Const bool

CanUseInertialScroll ( float ScrollAmount
)

 Check whether the current state of the table warrants inertial scroll by the specified amount
Protected function void Remove all the pinned widgets from the view.
Protected function void Remove all the widgets from the view.
Public function void

ConstructChildren ( const TAttribute< float >& InItemWidth,
const TAttribute< float >& InItemHeight,
const TAttribute< EListItemAlignment >& InItemAlignment,
const TSharedPtr< SHeaderRow >& InHeaderRow,
const TSharedPtr< SScrollBar >& InScrollBar,
EOrientation InScrollOrientation,
const FOnTableViewScrolled& InOnTableViewScrolled,
const FScrollBarStyle* InScrollBarStyle,
const bool bInPreventThrottling
)

 Create the child widgets that comprise the list
Public function void Reset the inertial scroll velocity accumulated in the InertialScrollManager
Protected function EActiveTimerReturnType

EnsureTickToRefresh ( double InCurrentTime,
float InDeltaTime
)

 One-off active timer to refresh the contents of the table as needed
Protected function Const int32

FindChildUnderPosition ( FArrangedChildren& ArrangedChildren,
const FVector2D& ArrangedSpacePosition
)

 Util function to find the child index under the given position.
Protected function Const const FChildren *  
Protected function Virtual Const float Get the offset of the first list item.
Public function Const TSharedPtr< SHeaderRow >  
Protected function Const float Get the uniform item height that is enforced by ListViews.
Protected function Const UE::Slate::FDeprecateVector2DResult Get the uniform item
Protected function Const float Get the uniform item width.
Public function Const int32  
Protected function Const int32  
Protected function Virtual Const int32 Get the number of items that can fit in the view along the line axis (orthogonal to the scroll axis) before creating a new line.
Protected function Virtual Const float  
Protected function Const int32  
Protected function Const EVisibility  
Public function Const EVisibility  
Public function Const float Gets the scroll offset of this view (in items)
Protected function Const float Get the scroll rate in items that best approximates a constant physical scroll rate.
Protected function Const double Returns the "true" scroll offset where the list will ultimately settle (and may already be).
Protected function void

InsertPinnedWidget ( const TSharedRef< SWidget >& WidgetToInset
)

 Insert WidgetToInsert at the top of the pinned view.
Protected function void

InsertWidget ( const TSharedRef< ITableRow >& WidgetToInset
)

 Insert WidgetToInsert at the top of the view.
Public function Const bool Return true if there is currently a refresh pending, false otherwise
Public function Const bool  
Public function Const bool Returns true if scrolling is possible; false if the view is big enough to fit all the content.
Public function Const bool Returns whether the attached scrollbar is scrolling
Public function Const bool  
Protected function Const void

NavigateToWidget ( const uint32 UserIndex,
const TSharedPtr< SWidget >& NavigationDestination,
ENavigationSource NavigationSource
)

 Util Function so templates classes don't need to include SlateApplication
Protected function void Called when CurrentScrollOffset == TargetScrollOffset at the end of a Tick
Protected function void Called when an item has entered the visible geometry to check to see if the ItemScrolledIntoView delegate should be fired.
Protected function Virtual void

OnRightMouseButtonDown ( const FPointerEvent& MouseEvent
)

 Right click down
Protected function Virtual void

OnRightMouseButtonUp ( const FPointerEvent& MouseEvent
)

 Opens a context menu as the result of a right click if OnContextMenuOpening is bound and we are not right click scrolling.
Public function void Completely wipe existing widgets and fully regenerate them on next tick.
Protected function FReGenerateResults

ReGenerateItems ( const FGeometry& MyGeometry
)

 Update generate Widgets for Items as needed and clean up any Widgets that are no longer needed.
Protected function void Internal request for a layout update on the next tick (i.e. a refresh without implication that the source items have changed)
Public function Virtual void Mark the list as dirty so that it will refresh its widgets on next tick.
Public function void

ScrollBar_OnUserScrolled ( float InScrollOffsetFraction
)

 Invoked by the scrollbar when the user scrolls.
Protected function Virtual float

ScrollBy ( const FGeometry& MyGeometry,
float ScrollByAmount,
EAllowOverscroll InAllowOverscroll
)

 Scroll the list view by some number of screen units.
Protected function EScrollIntoViewResult

ScrollIntoView ( const FGeometry& ListViewGeometry
)

 If there is a pending request to scroll an item into view, do so.
Protected function Virtual float

ScrollTo ( float InScrollOffset
)

 Scroll the view to an offset and resets the inertial scroll velocity
Public function void Scrolls the view to the bottom
Public function void Scrolls the view to the top
Public function void

SetAllowOverscroll ( EAllowOverscroll InAllowOverscroll
)

 Sets whether to permit overscroll on this list view
Public function void

SetBackgroundBrush ( const TAttribute< const FSlateBrush* >& InBackgroundBrush
)

 Sets the Background Brush
Public function void

SetEnableTouchAnimatedScrolling ( bool bInEnableTouchAnimatedScrolling
)

 Sets whether the list should lerp between scroll offsets or jump instantly between them with touch.
Public function void

SetFixedLineScrollOffset ( TOptional< double > InFixedLineScrollOffset
)

 Sets the fixed offset in items to always apply to the top/left (depending on orientation) of the list.
Public function void

SetIsPointerScrollingEnabled ( bool bInIsPointerScrollingEnabled
)

 Enables/disables being able to scroll. This should be use as a temporary mean to disable scrolling.
Public function void

SetIsRightClickScrollingEnabled ( const bool bInEnableRightClickScrolling
)

 Enables/disables being able to scroll with the right mouse button.
Public function void

SetIsScrollAnimationEnabled ( bool bInEnableScrollAnimation
)

 Sets whether the list should lerp between scroll offsets or jump instantly between them.
Public function void

SetIsTouchScrollingEnabled ( const bool bInEnableTouchScrolling
)

 Enables/disables being able to scroll using touch input.
Public function void

SetItemHeight ( TAttribute< float > Height
)

 Sets the item height
Public function void

SetItemWidth ( TAttribute< float > Width
)

 Sets the item width
Public function void

SetScrollbarVisibility ( const EVisibility InVisibility
)

  
Public function void

SetScrollOffset ( const float InScrollOffset
)

 Set the scroll offset of this view (in items)
Public function void

SetWheelScrollMultiplier ( float NewWheelScrollMultiplier
)

 Sets the multiplier applied when wheel scrolling.
Protected function EActiveTimerReturnType

UpdateInertialScroll ( double InCurrentTime,
float InDeltaTime
)

 Active timer to update the inertial scroll
Protected function void Remove any items that are no longer in the list from the selection set.

Overridden from SWidget

  Type Name Description
Public function Virtual Const bool Recomputes the volatility of the widget.
Protected function Virtual void Passing over the clipping to SListPanel
Public function Virtual Const FCursorReply

OnCursorQuery ( const FGeometry& MyGeometry,
const FPointerEvent& CursorEvent
)

 The system asks each widget under the mouse to provide a cursor. This event is bubbled.
Public function Virtual void

OnFocusLost ( const FFocusEvent& InFocusEvent
)

 Called when this widget loses focus. This event does not bubble.
Public function Virtual FReply

OnKeyDown ( const FGeometry& MyGeometry,
const FKeyEvent& InKeyEvent
)

 Called after a key is pressed when this widget has focus (this event bubbles if not handled)
Public function Virtual FReply

OnMouseButtonDoubleClick ( const FGeometry& InMyGeometry,
const FPointerEvent& InMouseEvent
)

 Called when a mouse button is double clicked. Override this in derived classes.
Public function Virtual FReply

OnMouseButtonDown ( const FGeometry& MyGeometry,
const FPointerEvent& MouseEvent
)

 MOUSE INPUT The system calls this method to notify the widget that a mouse button was pressed within it.
Public function Virtual FReply

OnMouseButtonUp ( const FGeometry& MyGeometry,
const FPointerEvent& MouseEvent
)

 The system calls this method to notify the widget that a mouse button was release within it.
Public function Virtual void

OnMouseCaptureLost ( const FCaptureLostEvent& CaptureLostEvent
)

 Called when this widget had captured the mouse, but that capture has been revoked for some reason.
Public function Virtual void

OnMouseEnter ( const FGeometry& MyGeometry,
const FPointerEvent& MouseEvent
)

 The system will use this event to notify a widget that the cursor has entered it.
Public function Virtual void

OnMouseLeave ( const FPointerEvent& MouseEvent
)

 The system will use this event to notify a widget that the cursor has left it.
Public function Virtual FReply

OnMouseMove ( const FGeometry& MyGeometry,
const FPointerEvent& MouseEvent
)

 The system calls this method to notify the widget that a mouse moved within it.
Public function Virtual FReply

OnMouseWheel ( const FGeometry& MyGeometry,
const FPointerEvent& MouseEvent
)

 Called when the mouse wheel is spun. This event is bubbled.
Public function Virtual Const int32

OnPaint ( const FPaintArgs& Args,
const FGeometry& AllottedGeometry,
const FSlateRect& MyCullingRect,
FSlateWindowElementList& OutDrawElements,
int32 LayerId,
const FWidgetStyle& InWidgetStyle,
bool bParentEnabled
)

 The widget should respond by populating the OutDrawElements array with FDrawElements that represent it and any of its children.
Public function Virtual FReply

OnPreviewMouseButtonDown ( const FGeometry& MyGeometry,
const FPointerEvent& MouseEvent
)

 Just like OnMouseButtonDown, but tunnels instead of bubbling.
Public function Virtual FReply

OnTouchEnded ( const FGeometry& MyGeometry,
const FPointerEvent& InTouchEvent
)

 Called when a touchpad touch is ended (finger lifted)
Public function Virtual FReply

OnTouchMoved ( const FGeometry& MyGeometry,
const FPointerEvent& InTouchEvent
)

 Called when a touchpad touch is moved (finger moved)
Public function Virtual FReply

OnTouchStarted ( const FGeometry& MyGeometry,
const FPointerEvent& InTouchEvent
)

 Called when a touchpad touch is started (finger down)
Public function Virtual Const bool Checks to see if this widget supports keyboard focus. Override this in derived classes.
Public function Virtual void

Tick ( const FGeometry& AllottedGeometry,
const double InCurrentTime,
const float InDeltaTime
)

 Ticks this widget with Geometry.

Overridden from IScrollableWidget

  Type Name Description
Public function Virtual FVector2D Gets the distance that user has scrolled into the control in normalized coordinates (0 - 1)
Public function Virtual FVector2D Gets the distance that user has left to scroll in the control before reaching the end in normalized coordinates (0 - 1)
Public function Virtual TSharedRef< class SWidget > Returns the typed SWidget that implements this interface

Classes

  Type Name Description
Protected struct FReGenerateResults Information about the outcome of the WidgetRegeneratePass  

Enums

  Type Name Description
Protected enum EScrollIntoViewResult    

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page