SelectList Class

GeonBit.UI

SelectList Class
List of items (strings) user can scroll and pick from.
Inheritance Hierarchy
SystemObject  GeonBit.UI.EntitiesEntity
    GeonBit.UI.EntitiesPanel
      GeonBit.UI.EntitiesSelectList

Namespace:  GeonBit.UI.Entities
Assembly:  GeonBit.UI (in GeonBit.UI.dll) Version: 1.0.0.0 (1.0.0.0)
Syntax
C#
public class SelectList : Panel

The SelectList type exposes the following members.

Constructors
  NameDescription
Public methodSelectList(Anchor, NullableVector2)
Create the select list with default values.
Public methodSelectList(Vector2, Anchor, NullableVector2, PanelSkin)
Create the select list.
Top
Properties
  NameDescription
Public propertyBackground
Optional background entity that will not respond to events and will always be rendered right behind this entity.
(Inherited from Entity.)
Public propertyCount
How many items currently in the list.
Public propertyDraggable
Is the entity draggable (eg can a user grab it and drag it around).
(Inherited from Entity.)
Public propertyEmpty
Is the list currently empty.
Public propertyEntityDefaultSize
Return the default size for this entity.
(Inherited from Entity.)
Public propertyFillColor
Entity fill color - this is just a sugarcoat to access the default fill color style property.
(Inherited from Entity.)
Public propertyInternalDestRect
Get internal destination rect.
(Inherited from Entity.)
Public propertyIsDirty
Get if this entity needs to recalculate destination rect.
(Inherited from Entity.)
Public propertyIsFocused
Does this entity or one of its children currently focused?
(Inherited from Entity.)
Public propertyIsMouseDown
Return if the mouse is currently pressing on this entity (eg over it and left mouse button is down).
(Inherited from Entity.)
Public propertyIsMouseOver
Return if the mouse is currently over this entity (regardless of weather or not mouse button is down).
(Inherited from Entity.)
Public propertyOpacity
Entity fill color opacity - this is just a sugarcoat to access the default fill color alpha style property.
(Inherited from Entity.)
Public propertyOutlineColor
Entity outline color - this is just a sugarcoat to access the default outline color style property.
(Inherited from Entity.)
Public propertyOutlineOpacity
Entity outline color opacity - this is just a sugarcoat to access the default outline color alpha style property.
(Inherited from Entity.)
Public propertyOutlineWidth
Entity outline width - this is just a sugarcoat to access the default outline color style property.
(Inherited from Entity.)
Public propertyPadding
Entity padding - this is just a sugarcoat to access the default padding style property.
(Inherited from Entity.)
Public propertyPanelOverflowBehavior
Set / get panel overflow behavior. Note: some modes require Render Targets, eg setting the 'UseRenderTarget' to true.
(Inherited from Panel.)
Public propertyParent
Get the direct parent of this entity.
(Inherited from Entity.)
Public propertyPriority
Return entity priority in drawing order and event handling.
(Inherited from Entity.)
Public propertyScale
Entity scale - this is just a sugarcoat to access the default scale style property.
(Inherited from Entity.)
Public propertyScrollbar
Get the scrollbar of this panel.
(Inherited from Panel.)
Public propertyScrollPosition
Current scrollbar position.
Public propertySelectedIndex
Currently selected item index (or -1 if none is selected).
Public propertySelectedValue
Currently selected item value (or null if none is selected).
Public propertyShadowColor
Entity shadow color - this is just a sugarcoat to access the default shadow color style property.
(Inherited from Entity.)
Public propertyShadowOffset
Entity shadow offset - this is just a sugarcoat to access the default shadow offset style property.
(Inherited from Entity.)
Public propertyShadowScale
Entity shadow scale - this is just a sugarcoat to access the default shadow scale style property.
(Inherited from Entity.)
Public propertySize
Entity current size property.
(Inherited from Entity.)
Public propertySkin
Set / get current panel skin.
(Inherited from Panel.)
Public propertySpaceAfter
Extra space (in pixels) to reserve *after* this entity when using Auto Anchors.
(Inherited from Entity.)
Public propertySpaceBefore
Extra space (in pixels) to reserve *before* this entity when using Auto Anchors.
(Inherited from Entity.)
Public propertyState
Current entity state (default / mouse hover / mouse down..).
(Inherited from Entity.)
Public propertyVisible
Set / get visibility.
(Inherited from Entity.)
Top
Methods
  NameDescription
Public methodAddChild
Add a child entity.
(Inherited from Entity.)
Public methodAddItem(String)
Add value to list.
Public methodAddItem(String, Int32)
Add value to list at a specific index.
Public methodBringToFront
Bring this entity to be on front (inside its parent).
(Inherited from Entity.)
Public methodCalcDestRect
Calculate and return the destination rectangle, eg the space this entity is rendered on.
(Inherited from Entity.)
Public methodCalcInternalRect
Calculate and return the internal destination rectangle (note: this relay on the dest rect having a valid value first).
(Inherited from Panel.)
Public methodClearChildren
Remove all children entities.
(Inherited from Entity.)
Public methodClearItems
Remove all items from the list.
Public methodDispose
Dispose unmanaged resources related to this panel (render target).
(Inherited from Panel.)
Public methodDraw
Draw this entity and its children.
(Inherited from Entity.)
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Public methodFindT(String, Boolean)
Find and return first occurance of a child entity with a given identifier and specific type.
(Inherited from Entity.)
Public methodGetActiveStyle
Return stylesheet property for current entity state (or default if undefined for state).
(Inherited from Entity.)
Public methodGetActualDestRect
Return actual destination rectangle. This can be override and implemented by things like Paragraph, where the actual destination rect is based on text content, font and word-wrap.
(Inherited from Entity.)
Public methodGetChildren
Return all children of this entity.
(Inherited from Entity.)
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetRelativeOffset
Return the relative offset, in pixels, from parent top-left corner.
(Inherited from Entity.)
Public methodGetStyleProperty
Return stylesheet property for a given state.
(Inherited from Entity.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodIsDeepChildOf
Check if this entity is a descendant of another entity. This goes up all the way to root.
(Inherited from Entity.)
Public methodIsDisabled
Return if this entity is currently disabled, due to self or one of the parents / grandparents being disabled.
(Inherited from Entity.)
Public methodIsInsideEntity
Test if a given point is inside entity's boundaries.
(Inherited from Entity.)
Public methodIsLocked
Return if this entity is currently locked, due to self or one of the parents / grandparents being locked.
(Inherited from Entity.)
Public methodIsNaturallyInteractable
Is the list a natrually-interactable entity.
(Overrides EntityIsNaturallyInteractable.)
Public methodIsVisible
Return if this entity is currently visible, eg this and all its parents and grandparents are visible.
(Inherited from Entity.)
Public methodIterateChildren
Iterate over children and call 'callback' for every direct child of this entity.
(Inherited from Entity.)
Public methodMarkAsDirty
Mark that this entity boundaries or style changed and it need to recalculate cached destination rect and other things.
(Inherited from Entity.)
Public methodMatchHeightToList
Calculate the height of the select list to match the height of all the items in it.
Public methodPropagateEventsTo(DropDown)
Propagate all events trigger by this entity to a given other entity. For example, if "OnClick" will be called on this entity, it will trigger OnClick on 'other' as well.
Public methodPropagateEventsTo(Entity)
Propagate all events trigger by this entity to a given other entity. For example, if "OnClick" will be called on this entity, it will trigger OnClick on 'other' as well.
(Inherited from Entity.)
Public methodPropagateEventsTo(SelectList)
Propagate all events trigger by this entity to a given other entity. For example, if "OnClick" will be called on this entity, it will trigger OnClick on 'other' as well.
Public methodRemoveChild
Remove child entity.
(Inherited from Entity.)
Public methodRemoveFromParent
Remove this entity from its parent.
(Inherited from Entity.)
Public methodRemoveItem(Int32)
Remove item from the list, by index.
Public methodRemoveItem(String)
Remove value from the list.
Public methodscrollToEnd
Move scrollbar to last item in list.
Public methodScrollToSelected
Move scrollbar to currently selected item.
Public methodSetAnchor
Set the anchor of this entity.
(Inherited from Entity.)
Public methodSetOffset
Set the offset of this entity.
(Inherited from Entity.)
Public methodSetPosition
Set the position and anchor of this entity.
(Inherited from Entity.)
Public methodSetStyleProperty
Set a stylesheet property.
(Inherited from Entity.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Public methodUnselect
Clear current selection.
Public methodUpdate
Called every frame to update entity state and call events.
(Inherited from Entity.)
Public methodUpdateDestinationRects
Update dest rect and internal dest rect. This is called internally whenever a change is made to the entity or its parent.
(Inherited from Entity.)
Public methodUpdateDestinationRectsIfDirty
Update dest rect and internal dest rect, but only if needed (eg if something changed since last update).
(Inherited from Entity.)
Public methodUpdateStyle
Update the entire stylesheet from a different stylesheet.
(Inherited from Entity.)
Top
Fields
  NameDescription
Public fieldAddWhenClipping
String to append when clipping items width.
Public fieldAfterDraw
Callback to execute every frame after this entity is rendered.
(Inherited from Entity.)
Public fieldAfterUpdate
Callback to execute every frame after this entity updates.
(Inherited from Entity.)
Public fieldAllowReselectValue
If true and user clicks on the item currently selected item, it will still invoke value change event as if a new value was selected.
Public fieldAttachedData
Optional data you can attach to this entity and retrieve later (for example when handling events).
(Inherited from Entity.)
Public fieldBeforeDraw
Callback to execute every frame before this entity is rendered.
(Inherited from Entity.)
Public fieldBeforeUpdate
Callback to execute every frame before this entity updates.
(Inherited from Entity.)
Public fieldClickThrough
If this boolean is true, events will just "go through" this entity to its children or entities behind it. This bool comes to solve conditions where you have two panels without skin that hide each other but you want users to be able to click on the bottom panel through the upper panel, provided it doesn't hit any of the first panel's children.
(Inherited from Entity.)
Public fieldClipTextIfOverflow
If true and an item in the list is too long for its width, the list will cut its value to fit width.
Public fieldStatic memberDefaultParagraphStyle
Default styling for select list labels. Note: loaded from UI theme xml file.
Public fieldStatic memberDefaultSize
Default select list size in pixels.
Public fieldStatic memberDefaultStyle
Default styling for the select list itself. Note: loaded from UI theme xml file.
Public fieldDisabled
If true, this entity and its children will be drawn in greyscale effect and will not respond to events.
(Inherited from Entity.)
Public fieldExtraMargin
Adds extra space outside the dest rect for collision detection. In other words, if extra margin is set to 10 and the user points with its mouse 5 pixels above this entity, it would still think the user points on the entity.
(Inherited from Entity.)
Public fieldExtraSpaceBetweenLines
Extra space (in pixels) between items on Y axis.
Public fieldIdentifier
Optional identifier you can attach to entities so you can later search and retrieve by.
(Inherited from Entity.)
Public fieldItemsScale
Scale items in list.
Public fieldLimitDraggingToParentBoundaries
If true, users will not be able to drag this entity outside its parent boundaries.
(Inherited from Entity.)
Public fieldLocked
If true, this entity and its children will not respond to events (but will be drawn normally, unlike when disabled).
(Inherited from Entity.)
Public fieldLockedItems
Optional dictionary of list indexes you want to lock. Every item in this dictionary set to true will be locked and user won't be able to select it.
Public fieldLockSelection
When set to true, users cannot change the currently selected value. Note: unlike the basic entity "Locked" that prevent all input from entity and its children, this method of locking will still allow users to scroll through the list, thus making it useable as a read-only list entity.
Public fieldMaxItems
If provided, will not be able to add any more of this number of items.
Public fieldOnClick
Callback to execute when user clicks on this entity (eg release mouse over it).
(Inherited from Entity.)
Public fieldOnFocusChange
Callback to execute every time this entity focus / unfocus.
(Inherited from Entity.)
Public fieldOnListChange
Special callback to execute when list size changes.
Public fieldOnMouseDown
Callback to execute when mouse button is pressed over this entity (called once when button is pressed).
(Inherited from Entity.)
Public fieldOnMouseEnter
Callback to execute when mouse start hovering over this entity (eg enters its region).
(Inherited from Entity.)
Public fieldOnMouseLeave
Callback to execute when mouse stop hovering over this entity (eg leaves its region).
(Inherited from Entity.)
Public fieldOnMouseReleased
Callback to execute when mouse button is released over this entity (called once when button is released).
(Inherited from Entity.)
Public fieldOnMouseWheelScroll
Callback to execute when mouse wheel scrolls and this entity is the active entity.
(Inherited from Entity.)
Public fieldOnStartDrag
Called when entity starts getting dragged (only if draggable).
(Inherited from Entity.)
Public fieldOnStopDrag
Called when entity stop getting dragged (only if draggable).
(Inherited from Entity.)
Public fieldOnValueChange
Callback to execute when entity value changes (relevant only for entities with value).
(Inherited from Entity.)
Public fieldOnVisiblityChange
Callback to execute every time the visibility of this entity changes (also invokes when parent becomes invisible / visible again).
(Inherited from Entity.)
Public fieldPromiscuousClicksMode
If in promiscuous mode, mouse button is pressed *outside* the entity and then released on the entity, click event will be fired. If false, in order to fire click event the mouse button must be pressed AND released over this entity (but can travel outside while being held down, as long as its released inside). Note: Windows default behavior is non promiscuous mode.
(Inherited from Entity.)
Public fieldToolTipText
Optional tooltip text to show if the user points on this entity for long enough.
(Inherited from Entity.)
Public fieldUseActualSizeForCollision
If true (default), will use the actual object size for collision detection. If false, will use the size property. This is useful for paragraphs, for example, where the actual width is based on text content and can vary and be totally different than the size set in the constructor.
(Inherited from Entity.)
Public fieldWhileDragging
Called every frame while the entity is being dragged.
(Inherited from Entity.)
Public fieldWhileMouseDown
Callback to execute every frame while mouse button is pressed over the entity.
(Inherited from Entity.)
Public fieldWhileMouseHover
Callback to execute every frame while mouse is hovering over the entity.
(Inherited from Entity.)
Top
See Also