CeresEngine 0.2.0
A game development framework
Loading...
Searching...
No Matches
CeresEngine::UISplitView Class Reference

A view that arranges two or more views in a linear stack running horizontally or vertically. More...

#include <CeresEngine/UI/UISplitView.hpp>

Inheritance diagram for CeresEngine::UISplitView:
CeresEngine::UIView CeresEngine::UIResponder CeresEngine::RefCounted< UIView, RefCounter< false > >

Public Types

enum class  DividerStyle { Thick , Thin , PaneSplitter }
 Constants that specify the style of the split view's dividers. More...
 

Public Member Functions

 UISplitView ()
 Creates a new UISplitView with default settings.
 
 UISplitView (DividerStyle dividerStyle)
 Create a new UISplitView with a custom divider style.
 
 UISplitView (DividerStyle dividerStyle, const UIColor &dividerColor)
 Create a new UISplitView with a custom divider style.
 
 ~UISplitView () override
 Destroys the UISplitView and releases it's subviews.
 
void setPosition (double position, UInt32 index)
 Sets the position of the divider at the specified index.
 
void adjustSubViews ()
 Adjusts the sizes of the split view's subviews so they (plus the dividers) fill the split view.
 
UInt32 getDividerIndexAtPoint (const UIPoint &point) const
 Computes the divider index for the view at the given point.
 
virtual UIRect getDividerRectAtIndex (UInt32 index) const
 Gets the divider rect for the divider with the given index.
 
bool isSubviewCollapsed (const UIView *subView) const
 Returns whether the specified view is in a collapsed state.
 
bool isVertical () const noexcept
 A Boolean value that determines the geometric orientation of the split view's dividers.
 
void setVertical (bool vertical)
 Generates a hash for the provided type.
 
DividerStyle getDividerStyle () const noexcept
 The style of divider between views.
 
void setDividerStyle (DividerStyle dividerStyle)
 The style of divider between views.
 
const UIColorgetDividerColor () const noexcept
 The color of the dividers that the split view draws between subviews.
 
void setDividerColor (const UIColor &dividerColor)
 The color of the dividers that the split view draws between subviews.
 
virtual double getDividerThickness () const noexcept
 The thickness of the dividers for the split view.
 
void mouseDown (const UIMouseEvent &event) override
 Informs the receiver that the user has pressed the left mouse button.
 
void mouseUp (const UIMouseEvent &event) override
 Informs the receiver that the user has released the left mouse button.
 
void mouseDragged (const UIMouseEvent &event) override
 Informs the receiver that the user has moved the mouse with the left button pressed.
 
 UIView ()
 Initializes new UIView object with an empty frame rectangle.
 
 UIView (const String &name)
 Initializes new UIView object with an empty frame rectangle and custom name.
 
 UIView (const UIRect &frame, const String &name="")
 Initializes new UIView object with a frame rectangle.
 
 UIView (const UISize &size, const String &name="")
 Initializes new UIView object with an frame rectangle size.
 
 UIView (const UIPoint &origin, const UISize &size, const String &name="")
 Initializes new UIView object with an frame rectangle size.
 
 UIView (const double x, const double y, const double width, const double height, const String &name="")
 Initializes new UIView object with an frame rectangle size.
 
- Public Member Functions inherited from CeresEngine::UIView
 UIView ()
 Initializes new UIView object with an empty frame rectangle.
 
 UIView (const String &name)
 Initializes new UIView object with an empty frame rectangle and custom name.
 
 UIView (const UIRect &frame, const String &name="")
 Initializes new UIView object with a frame rectangle.
 
 UIView (const UISize &size, const String &name="")
 Initializes new UIView object with an frame rectangle size.
 
 UIView (const UIPoint &origin, const UISize &size, const String &name="")
 Initializes new UIView object with an frame rectangle size.
 
 UIView (const double x, const double y, const double width, const double height, const String &name="")
 Initializes new UIView object with an frame rectangle size.
 
 ~UIView () override
 Destroys a UIView.
 
UIViewgetSuperView () const
 The view that is the parent of the current view.
 
const Vector< UIView * > & getSubViews () const
 The list of views embedded in the current view.
 
void setSubViews (const Vector< UIView * > &subViews)
 The list of views embedded in the current view.
 
UInt32 getSubViewCount () const noexcept
 Gets the number of sub-views in the view.
 
UIViewgetSubView (UInt32 index) const
 Gets the sub-view at the given index.
 
UInt32 getSubViewIndex (const UIView *view) const
 Gtes the sub-view index for the given sub-view, if it is a sub-view.
 
void addSubView (UIView *view)
 Adds a view to the view's subviews so it's displayed above its siblings.
 
void addSubView (const UIViewPtr &view)
 Adds a view to the view's subviews so it's displayed above its siblings.
 
template<typename T , typename... Args>
TaddSubView (Args &&... args)
 Adds a view to the view's subviews so it's displayed above its siblings.
 
void replaceSubView (UIView *view, UIView *replacement)
 Replaces one of the view's subviews with another view.
 
void removeFromSuperview ()
 Unlinks the view from its superview and its window, removes it from the responder chain, and invalidates its cursor rectangles.
 
bool isDescendant (const UIView *view) const
 Returns true if the view is a subview of a given view or if it's identical to that view; otherwise, it returns false.
 
UIViewgetOpaqueAncestor () const
 The view's closest opaque ancestor, which might be the view itself.
 
virtual UIWindowgetWindow () const
 The view's window object, if it is installed in a window.
 
UIRect getFrame () const
 The view's frame rectangle, which defines its position and size in its superview's coordinate system.
 
virtual void setFrame (const UIRect &frame)
 The view's frame rectangle, which defines its position and size in its superview's coordinate system.
 
void setFrame (const UIPoint &point, const UISize &size)
 The view's frame rectangle, which defines its position and size in its superview's coordinate system.
 
void setFrame (const UIPoint &point, const double width, const double height)
 The view's frame rectangle, which defines its position and size in its superview's coordinate system.
 
void setFrame (const double x, const double y, const UISize &size)
 The view's frame rectangle, which defines its position and size in its superview's coordinate system.
 
void setFrame (const double x, const double y, const double width, const double height)
 The view's frame rectangle, which defines its position and size in its superview's coordinate system.
 
void setFrameOrigin (const UIPoint &point)
 Sets the origin of the view's frame rectangle to the specified point, effectively repositioning it within its superview.
 
void setFrameOrigin (const double x, const double y)
 Sets the origin of the view's frame rectangle to the specified point, effectively repositioning it within its superview.
 
void setFrameSize (const UISize &size)
 Sets the size of the view's frame rectangle to the specified dimensions, resizing it within its superview without affecting its coordinate system.
 
void setFrameSize (const double width, const double height)
 Sets the size of the view's frame rectangle to the specified dimensions, resizing it within its superview without affecting its coordinate system.
 
UIRect getBounds () const
 The view's bounds rectangle, which expresses its location and size in its own coordinate system.
 
virtual void setBounds (const UIRect &bounds)
 The view's bounds rectangle, which expresses its location and size in its own coordinate system.
 
void setBounds (const UIPoint &point, const UISize &size)
 The view's bounds rectangle, which expresses its location and size in its own coordinate system.
 
void setBounds (const UIPoint &point, const double width, const double height)
 The view's bounds rectangle, which expresses its location and size in its own coordinate system.
 
void setBounds (const double x, const double y, const UISize &size)
 The view's bounds rectangle, which expresses its location and size in its own coordinate system.
 
void setBounds (const double x, const double y, const double width, const double height)
 The view's bounds rectangle, which expresses its location and size in its own coordinate system.
 
void setBoundsOrigin (const UIPoint &point)
 Sets the origin of the view's bounds rectangle to a specified point.
 
void setBoundsOrigin (const double x, const double y)
 Sets the origin of the view's bounds rectangle to a specified point.
 
void setBoundsSize (const UISize &size)
 Sets the size of the view's bounds rectangle to specified dimensions, inversely scaling its coordinate system relative to its frame rectangle.
 
void setBoundsSize (const double width, const double height)
 Sets the size of the view's bounds rectangle to specified dimensions, inversely scaling its coordinate system relative to its frame rectangle.
 
virtual bool acceptsFirstMouse (const UIEvent &theEvent)
 Overridden by subclasses to return true if the view should call mouseDown() for an initial mouse-down event, false if not.
 
UIViewhitTest (UIPoint aPoint, const Optional< const UIEvent & > &event=nullopt)
 Returns the farthest descendant of the view in the view hierarchy (including itself) that contains a specified point, or nil if that point lies completely outside the view.
 
virtual bool isPointInside (const UIPoint &point, const Optional< const UIEvent & > &event=nullopt)
 Returns a Boolean value indicating whether the receiver contains the specified point.
 
bool isMousePoint (const UIPoint &aPoint, const UIRect &aRect)
 Returns whether a region of the view contains a specified point, accounting for whether the view is flipped or not.
 
virtual bool getMouseDownCanMoveWindow () const
 This property lets you determine the region by which a window can be moved.
 
const UIAppearancegetAppearance () const noexcept
 The UI appearance to be used by the view.
 
void setAppearance (UIAppearance *appearance)
 The UI appearance to be used by the view.
 
UIColor getTintColor () const
 The first non-default tint color value in the view's hierarchy, ascending from and starting with the view itself.
 
void setTintColor (const UIColor &color)
 The first non-default tint color value in the view's hierarchy, ascending from and starting with the view itself.
 
void clearTintColor ()
 Clears the tint color for the current view.
 
const UIColorgetBackgroundColor () const noexcept
 The view's background color.
 
void setBackgroundColor (const UIColor &color)
 The view's background color.
 
const UICornerRadiusgetCornerRadius () const noexcept
 The view's background corner radius.
 
void setCornerRadius (const UICornerRadius &color)
 The view's background corner radius.
 
double getAlpha () const noexcept
 This property contains the opacity value from the view's layer.
 
void setAlpha (double alpha)
 This property contains the opacity value from the view's layer.
 
bool isOpaque () const noexcept
 A Boolean value indicating whether the view fills its frame rectangle with opaque content.
 
void setOpaque (bool isOpaque)
 A Boolean value indicating whether the view fills its frame rectangle with opaque content.
 
UIRect getVisibleRect () const
 Visibility, as reflected by this property, does not account for whether other view or window objects overlap the current view or whether the current view is installed in a window at all.
 
bool isVisible () const
 A Boolean value indicating whether the view is visible.
 
void setVisible (bool visible)
 A Boolean value indicating whether the view is visible.
 
bool isHidden () const
 A Boolean value indicating whether the view is hidden.
 
void setHidden (const bool hidden)
 A Boolean value indicating whether the view is hidden.
 
bool isHiddenOrHasHiddenAncestor () const
 A Boolean value indicating whether the view is hidden from sight because it, or one of its ancestors, is marked as hidden.
 
bool isActive () const
 A Boolean value indicating whether the view is active.
 
void setActive (bool active)
 A Boolean value indicating whether the view is active.
 
bool getAutoresizesSubViews () const
 A Boolean value indicating whether the view applies the autoresizing behavior to its subviews when its frame size changes.
 
void setAutoresizesSubViews (bool state)
 Generates a hash for the provided type.
 
const UIViewAutoresizingMaskgetAutoresizingMask () const
 The options that determine how the view is resized relative to its superview.
 
void setAutoresizingMask (const UIViewAutoresizingMask &autoresizingMask)
 The options that determine how the view is resized relative to its superview.
 
virtual void resizeSubviews (const UISize &oldBoundsSize)
 Informs the view's subviews that the view's bounds rectangle size has changed.
 
virtual void resize (const UISize &oldBoundsSize)
 Informs the view that the bounds size of its superview has changed.
 
virtual UISize getIntrinsicContentSize () const
 The natural size for the receiving view, considering only properties of the view itself.
 
bool getNeedsLayout () const
 A Boolean value indicating whether the view needs a layout pass before it can be drawn.
 
void setNeedsLayout ()
 A Boolean value indicating whether the view needs a layout pass before it can be drawn.
 
void setNeedsLayout (bool state)
 A Boolean value indicating whether the view needs a layout pass before it can be drawn.
 
void layout ()
 Perform layout in concert with the layout system.
 
void layoutIfNeeded ()
 Updates the layout of the receiving view and its subviews based on the current views and constraints.
 
virtual UISize calculateFittingLayoutSize (const UISize &targetSize) const
 Returns the optimal size of the view based on its current constraints.
 
UISize calculateMinimumLayoutSize () const
 Returns the minimum size of the view based on its current constraints.
 
UISize calculateMaximumLayoutSize () const
 Returns the maximum size of the view based on its current constraints.
 
bool getNeedsUpdateConstraints () const
 A Boolean value that determines whether the view’s constraints need updating.
 
void setNeedsUpdateConstraints ()
 A Boolean value that determines whether the view’s constraints need updating.
 
void setNeedsUpdateConstraints (bool state)
 A Boolean value that determines whether the view’s constraints need updating.
 
virtual void updateConstraints ()
 Updates constraints for the view.
 
void updateConstraintsIfNeeded ()
 Updates the constraints for the receiving view and its subviews.
 
Span< const UILayoutConstraintgetConstraints () const
 Returns the constraints held by the view.
 
void setConstraints (Vector< UILayoutConstraint > &&constraints)
 Returns the constraints held by the view.
 
void setConstraints (const Span< const UILayoutConstraint > &constraints)
 Returns the constraints held by the view.
 
void addConstraint (const UILayoutConstraint &constraint)
 Adds a constraint on the layout of the receiving view or its subviews.
 
void addConstraints (const Span< const UILayoutConstraint > &constraints)
 Adds multiple constraints on the layout of the receiving view or its subviews.
 
void addConstraints (const InitializerList< UILayoutConstraint > constraints)
 Adds multiple constraints on the layout of the receiving view or its subviews.
 
void removeConstraint (const UILayoutConstraint &constraint)
 Removes the specified constraint from the view.
 
void removeConstraints (const Span< const UILayoutConstraint > &constraints)
 Removes the specified constraints from the view.
 
void removeConstraints (const InitializerList< UILayoutConstraint > constraints)
 Removes the specified constraints from the view.
 
const UIEdgeInsetsgetLayoutMargins () const
 The default spacing to use when laying out content in the view.
 
void setLayoutMargins (const UIEdgeInsets &layoutMargins)
 The default spacing to use when laying out content in the view.
 
double getLayoutTopMargin () const
 The default spacing to use when laying out content in the view.
 
void setTopLayoutMargin (double topLayoutMargin)
 Generates a hash for the provided type.
 
double getBottomLayoutMargin () const
 The default spacing to use when laying out content in the view.
 
void setBottomLayoutMargin (double bottomLayoutMargin)
 The default spacing to use when laying out content in the view.
 
double getLeftLayoutMargin () const
 The default spacing to use when laying out content in the view.
 
void setLeftLayoutMargin (double leftLayoutMargin)
 The default spacing to use when laying out content in the view.
 
double getRightLayoutMargin () const
 The default spacing to use when laying out content in the view.
 
void setRightLayoutMargin (double rightLayoutMargin)
 The default spacing to use when laying out content in the view.
 
void setNeedsDisplay ()
 The displayIfNeeded methods check the value of this property to avoid unnecessary drawing, and all display methods set the value back to false when the view is up to date.
 
void setNeedsDisplay (const UIRect &invalidRect)
 Marks the region of the view within the specified rectangle as needing display, increasing the view's existing invalid region to include it.
 
bool getNeedsDisplay () const
 The displayIfNeeded methods check the value of this property to avoid unnecessary drawing, and all display methods set the value back to false when the view is up to date.
 
void display (UIGraphicsContext &context)
 Displays the view and all its subviews if possible.
 
void display (UIGraphicsContext &context, const UIRect &aRect)
 Acts as display(), but confining drawing to a rectangular region of the view.
 
void displayIgnoringOpacity (UIGraphicsContext &context)
 Displays the view but does not back up to the first opaque ancestor—it simply causes the view and its descendants to execute their drawing code.
 
virtual void displayIgnoringOpacity (UIGraphicsContext &context, const UIRect &aRect)
 Displays the view but confines drawing to a specified region and does not back up to the first opaque ancestor—it simply causes the view and its descendants to execute their drawing code.
 
void displayIfNeeded (UIGraphicsContext &context)
 Displays the view and all its subviews if any part of the view has been marked as needing display.
 
void displayIfNeeded (UIGraphicsContext &context, const UIRect &aRect)
 Acts as displayIfNeeded(), but confining drawing to a rectangular region of the view.
 
void displayIfNeededIgnoringOpacity (UIGraphicsContext &context)
 Acts as displayIfNeeded(), except that this method doesn’t back up to the first opaque ancestor—it simply causes the view and its descendants to execute their drawing code.
 
void displayIfNeededIgnoringOpacity (UIGraphicsContext &context, const UIRect &aRect)
 Displays the view but confines drawing to a specified region and does not back up to the first opaque ancestor—it simply causes the view and its descendants to execute their drawing code.
 
bool canDraw () const
 A Boolean value indicating whether drawing commands will produce any results.
 
const Vector< UIRect > & getRectsBeingDrawn () const
 Returns by a list of non-overlapping rectangles that define the area the view is being asked to draw in draw().
 
bool needsToDraw (const UIRect &aRect) const noexcept
 Returns a Boolean value indicating whether the specified rectangle intersects any part of the area that the view is being asked to draw.
 
virtual bool getClearsContextBeforeDrawing () const noexcept
 A Boolean value that determines whether the view's bounds should be automatically cleared before drawing.
 
virtual bool getClipsToBounds () const
 A Boolean value that determines whether subviews are confined to the bounds of the view.
 
double getContentScaleFactor () const
 The scale factor applied to the view.
 
void setContentScaleFactor (const Optional< double > &contentScaleFactor)
 The scale factor applied to the view.
 
bool isFirstResponder () const noexcept
 Determines if this view is the current first responder.
 
virtual UIScrollViewgetScrollView () const
 Gets the closest parent scroll view to this view.
 
virtual bool canBecomeKeyView () const
 When the value of this property is true, the view can become the key view.
 
virtual bool needsPanelToBecomeKey () const
 The default value of this property is false.
 
UIViewgetNextKeyView () const
 The view object that follows the current view in the key view loop.
 
void setNextKeyView (UIView *nextKeyView)
 The view object that follows the current view in the key view loop.
 
UIViewgetNextValidKeyView () const
 The value in this property is nullptr if there is no view that follows the current view and accepts the first responder status.
 
UIViewgetPreviousKeyView () const
 The value in this property is nullptr if there is no view preceding the current view in the key view loop.
 
UIViewgetPreviousValidKeyView () const
 The value in this property is nullptr if there is no view that precedes the current view and accepts the first responder status.
 
AffineTransform getTransformFrom (const UIView *aView=nullptr) const
 
const AffineTransform & getTransformFromWindow () const
 
AffineTransform getTransformFromSuperView () const
 
const AffineTransform & getTransformFromBacking () const
 
AffineTransform getTransformTo (const UIView *aView=nullptr) const
 
const AffineTransform & getTransformToWindow () const
 
AffineTransform getTransformToSuperView () const
 
const AffineTransform & getTransformToBacking () const
 
UIPoint convertFrom (const UIPoint &aPoint, const UIView *aView=nullptr) const
 Converts a point from the coordinate system of a given view to that of the view.
 
UIPoint convertFromWindow (const UIPoint &aPoint) const
 Converts a point from the coordinate system of a given view to that of the view.
 
UIPoint convertFromSuperView (const UIPoint &aPoint) const
 Converts a point from the coordinate system of a given view to that of the view.
 
UIPoint convertFromBacking (const UIPoint &aPoint) const
 Converts a point from its pixel aligned backing store coordinate system to the view’s interior coordinate system.
 
UIPoint convertTo (const UIPoint &aPoint, const UIView *aView=nullptr) const
 Converts a point from the view's coordinate system to that of a given view.
 
UIPoint convertToWindow (const UIPoint &aPoint) const
 Converts a point from the view's coordinate system to that of a given view.
 
UIPoint convertToSuperView (const UIPoint &aPoint) const
 Converts a point from the view's coordinate system to that of a given view.
 
UIPoint convertToBacking (const UIPoint &aPoint) const
 Converts a point from the view’s interior coordinate system to its pixel aligned backing store coordinate system.
 
UISize convertFrom (const UISize &aSize, const UIView *aView=nullptr) const
 Converts a size from another view's coordinate system to that of the view.
 
UISize convertFromWindow (const UISize &aSize) const
 Converts a point from the coordinate system of a given view to that of the view.
 
UISize convertFromSuperView (const UISize &aSize) const
 Converts a point from the coordinate system of a given view to that of the view.
 
UISize convertFromBacking (const UISize &aSize) const
 Converts a size from its pixel aligned backing store coordinate system to the view’s interior coordinate system.
 
UISize convertTo (const UISize &aSize, const UIView *aView=nullptr) const
 Converts a size from the view's coordinate system to that of another view.
 
UISize convertToWindow (const UISize &aSize) const
 Converts a point from the view's coordinate system to that of a given view.
 
UISize convertToSuperView (const UISize &aSize) const
 Converts a point from the view's coordinate system to that of a given view.
 
UISize convertToBacking (const UISize &aSize) const
 Converts a size from the view’s interior coordinate system to its pixel aligned backing store coordinate system.
 
UIRect convertFrom (const UIRect &aRect, const UIView *aView=nullptr) const
 Converts a rectangle from the coordinate system of another view to that of the view.
 
UIRect convertFromWindow (const UIRect &aRect) const
 Converts a point from the coordinate system of a given view to that of the view.
 
UIRect convertFromSuperView (const UIRect &aRect) const
 Converts a point from the coordinate system of a given view to that of the view.
 
UIRect convertFromBacking (const UIRect &aRect) const
 Converts a rectangle from its pixel aligned backing store coordinate system to the view’s interior coordinate system.
 
UIRect convertTo (const UIRect &aRect, const UIView *aView=nullptr) const
 Converts a rectangle from the view's coordinate system to that of another view.
 
UIRect convertToWindow (const UIRect &aRect) const
 Converts a point from the view's coordinate system to that of a given view.
 
UIRect convertToSuperView (const UIRect &aRect) const
 Converts a point from the view's coordinate system to that of a given view.
 
UIRect convertToBacking (const UIRect &aRect) const
 Converts a rectangle from the view’s interior coordinate system to its pixel aligned backing store coordinate system.
 
UIViewControllergetViewController () const noexcept
 The UIView controller, if any.
 
const StringgetName () const
 A human readable string that represents the view.
 
void setName (const String &name)
 Generates a hash for the provided type.
 
virtual StringView getTypeName () const
 A string that represents the view type.
 
UIRespondergetNextResponder () const final
 The next responder after this one, or nil if it has none.
 
- Public Member Functions inherited from CeresEngine::UIResponder
virtual ~UIResponder ()=default
 
virtual bool acceptsFirstResponder () const
 A Boolean value that indicates whether the responder accepts first responder status.
 
virtual bool becomeFirstResponder ()
 Notifies the receiver that it's about to become first responder in its window.
 
virtual bool resignFirstResponder ()
 Notifies the receiver that it's been asked to relinquish its status as first responder in its window.
 
virtual void mouseMoved (const UIMouseEvent &event)
 Informs the receiver that the mouse has moved.
 
virtual void mouseEntered (const UIMouseEvent &event)
 Informs the receiver that the cursor has entered a tracking rectangle.
 
virtual void mouseExited (const UIMouseEvent &event)
 Informs the receiver that the cursor has exited a tracking rectangle.
 
virtual void rightMouseDown (const UIMouseEvent &event)
 Informs the receiver that the user has pressed the right mouse button.
 
virtual void rightMouseDragged (const UIMouseEvent &event)
 Informs the receiver that the user has moved the mouse with the right button pressed.
 
virtual void rightMouseUp (const UIMouseEvent &event)
 Informs the receiver that the user has released the right mouse button.
 
virtual void otherMouseDown (const UIMouseEvent &event)
 Informs the receiver that the user has pressed a mouse button other than the left or right one.
 
virtual void otherMouseDragged (const UIMouseEvent &event)
 Informs the receiver that the user has moved the mouse with a button other than the left or right button pressed.
 
virtual void otherMouseUp (const UIMouseEvent &event)
 Informs the receiver that the user has released a mouse button other than the left or right button.
 
virtual void scrollWheel (const UIMouseEvent &event)
 Informs the receiver that the mouse's scroll wheel has moved.
 
virtual void keyDown (const UIKeyEvent &event)
 Informs the receiver that the user has pressed a key.
 
virtual void keyUp (const UIKeyEvent &event)
 Informs the receiver that the user has released a key.
 
virtual void interpretKeyEvents (const Vector< UIKeyEvent > &events)
 Handles a series of key events.
 
virtual bool performKeyEquivalent (const UIKeyEvent &event)
 Handle a key equivalent.
 
virtual void flushBufferedKeyEvents ()
 Clears any unprocessed key events when overridden by subclasses.
 
virtual void cursorUpdate (const UIEvent &event)
 Informs the receiver that the mouse cursor has moved into a cursor rectangle.
 
virtual void flagsChanged (const UIEvent &event)
 Informs the receiver that the user has pressed or released a modifier key (Shift, Control, and so on).
 
- Public Member Functions inherited from CeresEngine::RefCounted< UIView, RefCounter< false > >
 RefCounted (Args &&... args)
 Creates a new RefCounted object and constructs a new Deleter by forwarding Args to it.
 
void retain () noexcept
 Retains the object by increment it's reference count by one.
 
bool release () noexcept
 Relases the object by decrementing it's reference count by one.
 

Public Attributes

struct { 
 
   UIDelegate< UISplitView, void()>   willResizeSubviews 
 Notifies the delegate when the split view is about to resize its subviews. More...
 
   UIDelegate< UISplitView, void()>   didResizeSubviews 
 Notifies the delegate when the split view resizes its subviews. More...
 
   UIDelegate< UISplitView, bool(UIView *subView)>   canCollapseSubview = false 
 Allows the delegate to determine whether the user can collapse and expand the specified subview. More...
 
   UIDelegate< UISplitView, void()>   layoutSubviews 
 Allows the delegate to specify custom sizing behavior for the subviews of the split view. More...
 
   UIDelegate< UISplitView, double(double proposedMinimum, UInt32 dividerIndex)>   constrainMinimumCoordinate 
 Allows the delegate to constrain the minimum coordinate limit of a divider when the user drags it. More...
 
   UIDelegate< UISplitView, double(double proposedMaximum, UInt32 dividerIndex)>   constrainMaximumCoordinate 
 Allows the delegate to constrain the maximum coordinate limit of a divider when the user drags it. More...
 
   UIDelegate< UISplitView, double(double proposedPosition, UInt32 dividerIndex)>   constrainSplitPosition 
 Allows the delegate to constrain the divider to certain positions. More...
 
delegate 
 
- Public Attributes inherited from CeresEngine::UIView
const UILayoutAnchor left
 The left side of the object's alignment rectangle.
 
const UILayoutAnchor right
 The right side of the object's alignment rectangle.
 
const UILayoutAnchor top
 The top of the object's alignment rectangle.
 
const UILayoutAnchor bottom
 The bottom of the object's alignment rectangle.
 
const UILayoutAnchor width
 The width of the object's alignment rectangle.
 
const UILayoutAnchor height
 The height of the object's alignment rectangle.
 
const UILayoutAnchor centerX
 The center along the x-axis of the object's alignment rectangle.
 
const UILayoutAnchor centerY
 The center along the y-axis of the object's alignment rectangle.
 
const UILayoutAnchor lastBaseline
 The object's baseline.
 
const UILayoutAnchor firstBaseline
 The object's baseline.
 
const UILayoutAnchor leftMargin
 The object's left margin.
 
const UILayoutAnchor rightMargin
 The object's right margin.
 
const UILayoutAnchor topMargin
 The object's top margin.
 
const UILayoutAnchor bottomMargin
 The object's bottom margin.
 
const UILayoutAnchor centerXWithinMargins
 The center along the x-axis between the object's left and right margin.
 
const UILayoutAnchor centerYWithinMargins
 The center along the y-axis between the object's top and bottom margin.
 

Protected Member Functions

virtual void drawDivider (UIGraphicsContext &context, const UIRect &aRect)
 Draws a divider between two of the split view's subviews.
 
void layoutSubviews () override
 Lays out subviews.
 
void didAddSubview (UIView &view) override
 Overridden by subclasses to perform additional actions when subviews are added to the view.
 
void didRemoveSubview (UIView &view) override
 Overridden by subclasses to perform additional actions when subviews are removed to the view.
 
void draw (UIGraphicsContext &context, const UIRect &dirtyRect) override
 Overridden by subclasses to draw the view's texture within the specified rectangle.
 
- Protected Member Functions inherited from CeresEngine::UIView
virtual void willRemoveSubview (UIView &view)
 Overridden by subclasses to perform additional actions before subviews are removed from the view.
 
virtual void willMoveToSuperView (UIView *superView)
 Informs the view that its superview is about to change to the specified superview (which may be nil).
 
virtual void didMoveToSuperView (UIView *superView)
 Informs the view that its superview has changed (possibly to nil).
 
virtual void willMoveToWindow (UIWindow *window)
 Informs the view that it's being added to the view hierarchy of the specified window object (which may be nil).
 
virtual void didMoveToWindow (UIWindow *window)
 Informs the view that it has been added to a new view hierarchy.
 
virtual void didHide ()
 Invoked when the view is hidden, either directly, or in response to an ancestor being hidden.
 
virtual void didUnhide ()
 Invoked when the view is unhidden, either directly, or in response to an ancestor being unhidden.
 
virtual void willDraw ()
 Informs the view that it will be required to draw content.
 
virtual void tintColorDidChange ()
 Called by the system when the tintColor property changes.
 
virtual void didChangeFrame (const UIRect &oldFrame)
 Called whenever the view frame changes, either internally or programmatically by calls to setFrame.
 
virtual void didChangeBounds (const UIRect &oldBounds)
 Called whenever the view bounds changes, either internally or programmatically by calls to setBounds.
 
void invalidateIntrinsicContentSize ()
 Invalidates the view's intrinsic content size.
 
void updateIntrinsicContentSize ()
 

Private Attributes

bool mVertical = true
 A Boolean value that determines the geometric orientation of the split view's dividers.
 
DividerStyle mDividerStyle = DividerStyle::PaneSplitter
 The style of divider between views.
 
UIColor mDividerColor
 The color of the dividers that the split view draws between subviews.
 
UInt32 mDragIndex = kUndefinedDragIndex
 The divider index currently being dragged.
 

Static Private Attributes

static const UInt32 kUndefinedDragIndex
 A constant that represents an undefined drag index.
 

Additional Inherited Members

- Static Public Member Functions inherited from CeresEngine::UIResponder
static void dispatch (UIResponder *const firstResponder, const UIEvent &event)
 Dispatches a UIEvent to the given first responder.
 
- Static Public Attributes inherited from CeresEngine::UIView
static const double kNoInstrinsicMetric
 Used to indicate that a view has no intrinsic metric for a given numeric property.
 
static const UISize kNoIntrinsicSize
 Used to indicate that a view has no intrinsic metric for a given size property.
 
static const UInt32 kInvalidViewIndex
 Used to indicate that an invalid view index.
 
static const UIRect kDefaultFrame
 A rectangle that represents the default frame set by a view without an explicit frame.
 
static const UIColorAppearanceProperty tintColorProperty
 Determines the default value for the tintColor property if not overridden by the view.
 
static const UIPaintAppearanceProperty labelPaintProperty
 The primary color to use for text labels.
 
static const UIPaintAppearanceProperty secondaryLabelPaintProperty
 The secondary color to use for text labels.
 
static const UIPaintAppearanceProperty tertiaryLabelPaintProperty
 The tertiary color to use for text labels.
 
static const UIPaintAppearanceProperty quaternaryLabelPaintProperty
 The quaternary color to use for text labels and separators.
 
static const UIPaintAppearanceProperty textPaintProperty
 The color to use for text.
 
static const UIPaintAppearanceProperty placeholderTextPaintProperty
 The color to use for placeholder text in controls or text views.
 
static const UIPaintAppearanceProperty selectedTextPaintProperty
 The color to use for selected text.
 
static const UIPaintAppearanceProperty textBackgroundPaintProperty
 The color to use for the background area behind text.
 
static const UIPaintAppearanceProperty selectedTextBackgroundPaintProperty
 The color to use for the background of selected text.
 
static const UIPaintAppearanceProperty keyboardFocusIndicatorPaintProperty
 The color to use for the keyboard focus ring around controls.
 
static const UIPaintAppearanceProperty unemphasizedSelectedTextPaintProperty
 The color to use for selected text in an unemphasized context.
 
static const UIPaintAppearanceProperty unemphasizedSelectedTextBackgroundPaintProperty
 The color to use for the text background in an unemphasized context.
 
static const UIPaintAppearanceProperty linkPaintProperty
 The color to use for links.
 
static const UIPaintAppearanceProperty separatorPaintProperty
 The color to use for separators between different sections of content.
 
static const UIPaintAppearanceProperty selectedContentBackgroundPaintProperty
 The color to use for the background of selected and emphasized content.
 
static const UIPaintAppearanceProperty unemphasizedSelectedContentBackgroundPaintProperty
 The color to use for selected and unemphasized content.
 
static const UIPaintAppearanceProperty selectedMenuItemTextPaintProperty
 The color to use for the text in menu items.
 
static const UIPaintAppearanceProperty gridPaintProperty
 The color to use for the optional gridlines, such as those in a table view.
 
static const UIPaintAppearanceProperty headerTextPaintProperty
 The color to use for text in header cells in table views and outline views.
 
static const UIPaintAppearanceProperty alternatingContentBackgroundColorsProperty
 The colors to use for alternating content, typically found in table views and collection views.
 
static const UIPaintAppearanceProperty controlAccentPaintProperty
 The user's current accent color preference.
 
static const UIPaintAppearanceProperty controlPaintProperty
 The color to use for the flat surfaces of a control.
 
static const UIPaintAppearanceProperty controlBackgroundPaintProperty
 The color to use for the background of large controls, such as scroll views or table views.
 
static const UIPaintAppearanceProperty controlTextPaintProperty
 The color to use for text on enabled controls.
 
static const UIPaintAppearanceProperty disabledControlTextPaintProperty
 The color to use for text on disabled controls.
 
static const UIPaintAppearanceProperty currentControlTintProperty
 The current system control tint color.
 
static const UIPaintAppearanceProperty selectedControlPaintProperty
 The color to use for the face of a selected control—that is, a control that has been clicked or is being dragged.
 
static const UIPaintAppearanceProperty selectedControlTextPaintProperty
 The color to use for text in a selected control—that is, a control being clicked or dragged.
 
static const UIPaintAppearanceProperty alternateSelectedControlTextPaintProperty
 The color to use for text in a selected control.
 
static const UIPaintAppearanceProperty scrubberTexturedBackgroundPaintProperty
 The patterned color to use for the background of a scrubber control.
 
static const UIPaintAppearanceProperty windowBackgroundPaintProperty
 The color to use for the window background.
 
static const UIPaintAppearanceProperty windowFrameTextPaintProperty
 The color to use for text in a window's frame.
 
static const UIPaintAppearanceProperty underPageBackgroundPaintProperty
 The color to use in the area beneath your window's views.
 
static const UIPaintAppearanceProperty findHighlightPaintProperty
 The highlight color to use for the bubble that shows inline search result values.
 
static const UIPaintAppearanceProperty highlightPaintProperty
 The color to use as a virtual light source on the screen.
 
static const UIPaintAppearanceProperty shadowPaintProperty
 The color to use for virtual shadows cast by raised objects on the screen.
 
static const UIFontAppearanceProperty fontProperty
 The default font used by all UI elements.
 
static const UIFloatAppearanceProperty fontSizeProperty
 The default font size used by all UI elements.
 

Detailed Description

A view that arranges two or more views in a linear stack running horizontally or vertically.

By default, dividers have a horizontal orientation so that the split view arranges its panes vertically from top to bottom.

Divider indices are zero-based. If the vertical property is false, which is the default value, the top divider has an index of 0. If vertical is true, the leading divider has an index of 0.

Member Enumeration Documentation

◆ DividerStyle

Constants that specify the style of the split view's dividers.

Enumerator
Thick 

A thick style divider displays between subviews.

Thin 

A thin style divider displays between subviews.

PaneSplitter 

A thick style divider with a 3D appearance displays between subviews.

Constructor & Destructor Documentation

◆ UISplitView() [1/3]

CeresEngine::UISplitView::UISplitView ( )

Creates a new UISplitView with default settings.

◆ UISplitView() [2/3]

CeresEngine::UISplitView::UISplitView ( DividerStyle  dividerStyle)
explicit

Create a new UISplitView with a custom divider style.

Parameters
dividerStyleThe style of divider between views.

◆ UISplitView() [3/3]

CeresEngine::UISplitView::UISplitView ( DividerStyle  dividerStyle,
const UIColor dividerColor 
)
explicit

Create a new UISplitView with a custom divider style.

Parameters
dividerStyleThe style of divider between views.
dividerColorThe color of the dividers that the split view draws between subviews.

◆ ~UISplitView()

CeresEngine::UISplitView::~UISplitView ( )
override

Destroys the UISplitView and releases it's subviews.

Member Function Documentation

◆ adjustSubViews()

void CeresEngine::UISplitView::adjustSubViews ( )

Adjusts the sizes of the split view's subviews so they (plus the dividers) fill the split view.

When you call this method, the split view's subviews resize proportionally; the relative sizes of the subviews don't change.

The default implementation of this method resizes subviews proportionally so that the ratio of heights (when using horizontal dividers) or widths (when using vertical dividers) doesn't change, even though the absolute sizes change.

Call this method on split views where you've added or removed subviews to reestablish the consistency of subview placement.

◆ didAddSubview()

void CeresEngine::UISplitView::didAddSubview ( UIView view)
overrideprotectedvirtual

Overridden by subclasses to perform additional actions when subviews are added to the view.

Reimplemented from CeresEngine::UIView.

◆ didRemoveSubview()

void CeresEngine::UISplitView::didRemoveSubview ( UIView view)
overrideprotectedvirtual

Overridden by subclasses to perform additional actions when subviews are removed to the view.

Reimplemented from CeresEngine::UIView.

◆ draw()

void CeresEngine::UISplitView::draw ( UIGraphicsContext context,
const UIRect dirtyRect 
)
overrideprotectedvirtual

Overridden by subclasses to draw the view's texture within the specified rectangle.

Use this method to draw the specified portion of your view's content. Your implementation of this method should be as fast as possible and do as little work as possible. The dirtyRect parameter helps you achieve better performance by specifying the portion of the view that needs to be drawn. You should always limit drawing to the content inside this rectangle. For even better performance, you can call the getRectsBeingDrawn() method and use the list of rectangles returned by that method to limit drawing even further. You can also use the needsToDraw() method test whether objects in a particular rectangle need to be drawn.

The default implementation does nothing. Subclasses should override this method if they do custom drawing. Prior to calling this method, the framework creates an appropriate drawing context and configures it for drawing to the view; you do not need to configure the drawing context yourself.

If your custom view is a direct UIView subclass, you do not need to call super. For all other views, call super at some point in your implementation so that the parent class can perform any additional drawing.

Note
If the view's isOpaque property is true, the view must completely fill the dirtyRect rectangle with opaque content.
Parameters
dirtyRectA rectangle defining the portion of the view that requires redrawing. This rectangle usually represents the portion of the view that requires updating. When responsive scrolling is enabled, this rectangle can also represent a nonvisible portion of the view that frameworks wants to cache.

Reimplemented from CeresEngine::UIView.

◆ drawDivider()

virtual void CeresEngine::UISplitView::drawDivider ( UIGraphicsContext context,
const UIRect aRect 
)
protectedvirtual

Draws a divider between two of the split view's subviews.

If you override this method to use a custom style for the divider, you may need to change the size of the divider.

Parameters
contextThe UI graphics context object to submit drawing commands to.
aRectThe entire divider rectangle in the split view's flipped coordinate system.

◆ getDividerColor()

const UIColor & CeresEngine::UISplitView::getDividerColor ( ) const
inlinenoexcept

The color of the dividers that the split view draws between subviews.

◆ getDividerIndexAtPoint()

UInt32 CeresEngine::UISplitView::getDividerIndexAtPoint ( const UIPoint point) const

Computes the divider index for the view at the given point.

Parameters
pointThe point to compute the divider index for.
Returns
The index of the divider at is below the given point.

◆ getDividerRectAtIndex()

virtual UIRect CeresEngine::UISplitView::getDividerRectAtIndex ( UInt32  index) const
virtual

Gets the divider rect for the divider with the given index.

Note
This is used by getDividerIndexAtPoint() to compute the divider as well as internally to compute the spacing between views.
Parameters
indexThe index of the divider to return a rect for.
Returns
A rectangle that includes the bounding area of the divider.

◆ getDividerStyle()

DividerStyle CeresEngine::UISplitView::getDividerStyle ( ) const
inlinenoexcept

The style of divider between views.

See also
DividerStyle for the possible values.

◆ getDividerThickness()

virtual double CeresEngine::UISplitView::getDividerThickness ( ) const
virtualnoexcept

The thickness of the dividers for the split view.

◆ isSubviewCollapsed()

bool CeresEngine::UISplitView::isSubviewCollapsed ( const UIView subView) const

Returns whether the specified view is in a collapsed state.

Parameters
subViewThe subview in the split view.
Returns
true if subview is in a collapsed state; otherwise, false.

◆ isVertical()

bool CeresEngine::UISplitView::isVertical ( ) const
inlinenoexcept

A Boolean value that determines the geometric orientation of the split view's dividers.

The default value of this property is true, which indicates vertical dividers and views that stack one after another the other (left-to-right) in the containing split view.

To specify horizontal dividers and a horizontal (top-to-bottom) arrangement of views within a split view, set this property to false.

◆ layoutSubviews()

void CeresEngine::UISplitView::layoutSubviews ( )
overrideprotectedvirtual

Lays out subviews.

Subclasses can override this method as needed to perform more precise layout of their subviews. You should override this method only if the autoresizing behavior of the subviews do not offer the behavior you want. You can use your implementation to set the frame rectangles of your subviews directly.

You should not call this method directly. If you want to force a layout update, call the setNeedsLayout() method instead to do so prior to the next drawing update. If you want to update the layout of your views immediately, call the layoutIfNeeded() method.

Reimplemented from CeresEngine::UIView.

◆ mouseDown()

void CeresEngine::UISplitView::mouseDown ( const UIMouseEvent event)
overridevirtual

Informs the receiver that the user has pressed the left mouse button.

Reimplemented from CeresEngine::UIResponder.

◆ mouseDragged()

void CeresEngine::UISplitView::mouseDragged ( const UIMouseEvent event)
overridevirtual

Informs the receiver that the user has moved the mouse with the left button pressed.

Reimplemented from CeresEngine::UIResponder.

◆ mouseUp()

void CeresEngine::UISplitView::mouseUp ( const UIMouseEvent event)
overridevirtual

Informs the receiver that the user has released the left mouse button.

Reimplemented from CeresEngine::UIResponder.

◆ setDividerColor()

void CeresEngine::UISplitView::setDividerColor ( const UIColor dividerColor)

The color of the dividers that the split view draws between subviews.

◆ setDividerStyle()

void CeresEngine::UISplitView::setDividerStyle ( DividerStyle  dividerStyle)

The style of divider between views.

See also
DividerStyle for the possible values.

◆ setPosition()

void CeresEngine::UISplitView::setPosition ( double  position,
UInt32  index 
)

Sets the position of the divider at the specified index.

The default implementation of this method behaves as if the user were attempting to drag the divider to the proposed position, so the system applies the constraints that the delegate imposes and one of the views adjacent to the divider may collapse.

Parameters
positionThe position of the divider.
indexThe index of the divider.

◆ setVertical()

void CeresEngine::UISplitView::setVertical ( bool  vertical)

Generates a hash for the provided type.

Type must have a std::hash specialization.

Template Parameters
Tthe type to be hashed
Parameters
vThe value to be hashed
Returns
The hashed value

◆ UIView() [1/6]

CeresEngine::UIView::UIView ( )

Initializes new UIView object with an empty frame rectangle.

◆ UIView() [2/6]

CeresEngine::UIView::UIView ( const double  x,
const double  y,
const double  width,
const double  height,
const String name = "" 
)
inlineexplicit

Initializes new UIView object with an frame rectangle size.

The view is placed at the origin.

Parameters
xThe frame rectangle origin x coordinate for the created view object.
yThe frame rectangle origin y coordinate for the created view object.
widthThe frame rectangle width for the created view object.
heightThe frame rectangle height for the created view object.

◆ UIView() [3/6]

CeresEngine::UIView::UIView ( const String name)
explicit

Initializes new UIView object with an empty frame rectangle and custom name.

◆ UIView() [4/6]

CeresEngine::UIView::UIView ( const UIPoint origin,
const UISize size,
const String name = "" 
)
inlineexplicit

Initializes new UIView object with an frame rectangle size.

The view is placed at the origin.

Parameters
originThe frame rectangle origin for the created view object.
sizeThe frame rectangle size for the created view object.

◆ UIView() [5/6]

CeresEngine::UIView::UIView ( const UIRect frame,
const String name = "" 
)
explicit

Initializes new UIView object with a frame rectangle.

Parameters
frameThe frame rectangle for the created view object.

◆ UIView() [6/6]

CeresEngine::UIView::UIView ( const UISize size,
const String name = "" 
)
inlineexplicit

Initializes new UIView object with an frame rectangle size.

The view is placed at the origin.

Parameters
sizeThe frame rectangle size for the created view object.

Member Data Documentation

◆ canCollapseSubview

UIDelegate<UISplitView, bool(UIView* subView)> CeresEngine::UISplitView::canCollapseSubview = false

Allows the delegate to determine whether the user can collapse and expand the specified subview.

The subview expands when the user drags the divider beyond the halfway mark between its minimum size and its edge.

A collapsed subview isn't visible, but the split view object retains it with the same size as before the collapse.

If the delegate doesn't implement this method, the subviews can't collapse.

Parameters
subViewThe subview to collapse.
Returns
true if subview collapses when the user drags a divider beyond the halfway mark between its minimum size and its edge; otherwise, false.

◆ constrainMaximumCoordinate

UIDelegate<UISplitView, double(double proposedMaximum, UInt32 dividerIndex)> CeresEngine::UISplitView::constrainMaximumCoordinate

Allows the delegate to constrain the maximum coordinate limit of a divider when the user drags it.

The delegate receives this message before the split view begins tracking the cursor to position a divider. You can further constrain the limits, but you can't extend the divider limits.

If the split bars are horizontal (views are one on top of the other), proposedMaximum is the bottom limit. If the split bars are vertical (views are side by side), proposedMaximum is the right limit. The initial value of proposedMaximum is the bottom (or right side) of the subview after the divider.

Parameters
proposedMaximumThe proposed maximum coordinate limit of the subview in the split view's flipped coordinate system.
dividerIndexSpecifies the divider the user is moving, with the first divider being 0 and increasing from top to bottom (or left to right).
Returns
The maximum coordinate limit of the divider.

◆ constrainMinimumCoordinate

UIDelegate<UISplitView, double(double proposedMinimum, UInt32 dividerIndex)> CeresEngine::UISplitView::constrainMinimumCoordinate

Allows the delegate to constrain the minimum coordinate limit of a divider when the user drags it.

The delegate receives this message before the split view begins tracking the cursor to position a divider. You can further constrain the limits, but you can't extend the divider limits.

If the split bars are horizontal (views are one on top of the other), proposedMinimum is the top limit. If the split bars are vertical (views are side by side), proposedMinimum is the left limit. The initial value of proposedMinimum is the top (or left side) of the subview before the divider.

Parameters
proposedMinimumThe proposed minimum coordinate limit of the subview in the split view's flipped coordinate system.
dividerIndexSpecifies the divider the user is moving, with the first divider being 0 and increasing from top to bottom (or left to right).
Returns
The minimum coordinate limit of the divider.

◆ constrainSplitPosition

UIDelegate<UISplitView, double(double proposedPosition, UInt32 dividerIndex)> CeresEngine::UISplitView::constrainSplitPosition

Allows the delegate to constrain the divider to certain positions.

If the delegate implements this method, the split view calls it repeatedly as the user moves the divider.

If a subview's height must be a multiple of a certain number, use this method to return the multiple nearest to proposedPosition.

Parameters
proposedPositionThe cursor's current position, and the proposed position of the divider.
dividerIndexThe index of the divider the user is moving, with the first divider being 0 and increasing from top to bottom (or left to right).
Returns
The position for constraining the divider.

◆ [struct]

struct { ... } CeresEngine::UISplitView::delegate

◆ didResizeSubviews

UIDelegate<UISplitView, void()> CeresEngine::UISplitView::didResizeSubviews

Notifies the delegate when the split view resizes its subviews.

The view invokes this method after the split view resizes two of its subviews in response to the repositioning of a divider.

◆ kUndefinedDragIndex

const UInt32 CeresEngine::UISplitView::kUndefinedDragIndex
staticprivate

A constant that represents an undefined drag index.

◆ layoutSubviews

UIDelegate<UISplitView, void()> CeresEngine::UISplitView::layoutSubviews

Allows the delegate to specify custom sizing behavior for the subviews of the split view.

If the delegate implements this method, it receives this message after the split view resizes.

Resize the subviews so that the sum of the sizes of the subviews plus the sum of the thickness of the dividers equals the size of the new frame of the UISplitView. You can get the thickness of a divider through the getDividerThickness() method.

If you implement this delegate method to resize subviews on your own, the UISplitView doesn't perform any error checking for you. However, you can invoke adjustSubviews() to perform the default sizing behavior.

◆ mDividerColor

UIColor CeresEngine::UISplitView::mDividerColor
private

The color of the dividers that the split view draws between subviews.

◆ mDividerStyle

DividerStyle CeresEngine::UISplitView::mDividerStyle = DividerStyle::PaneSplitter
private

The style of divider between views.

See also
DividerStyle for the possible values.

◆ mDragIndex

UInt32 CeresEngine::UISplitView::mDragIndex = kUndefinedDragIndex
private

The divider index currently being dragged.

◆ mVertical

bool CeresEngine::UISplitView::mVertical = true
private

A Boolean value that determines the geometric orientation of the split view's dividers.

The default value of this property is true, which indicates vertical dividers and views that stack one after another the other (left-to-right) in the containing split view.

To specify horizontal dividers and a horizontal (top-to-bottom) arrangement of views within a split view, set this property to false.

◆ willResizeSubviews

UIDelegate<UISplitView, void()> CeresEngine::UISplitView::willResizeSubviews

Notifies the delegate when the split view is about to resize its subviews.

The view invokes this method before the split view resizes two of its subviews in response to the repositioning of a divider.


The documentation for this class was generated from the following file: