PRIM_MD.Tab (PRIM_MD.Tab)
Material Design Tab
Ancestors - Panel (PRIM_PANL)Container (PRIM_CPST)Control (PRIM_CTRL)Object (PRIM_OBJT)
Details
Prim_MD.Tab is a panel designed contain Tab Items. The Tab will generally be located below the app bar at the top of a web application The Tabs make for easy navigaton between Views, Dialogs and Tab Sheets
Example
This is a simpified example showing how the various parts interact.
Begin_Com Role(*EXTENDS #PRIM_WEB) Theme(#SYS_THEME) Layoutmanager(#LayoutPageLayout) Define_Com Class(#PRIM_TBLO) Name(#LayoutPageLayout) Define_Com Class(#PRIM_TBLO.Row) Name(#LayoutPageRow1) Displayposition(2) Parent(#LayoutPageLayout) Height(64) Units(Pixels) Define_Com Class(#PRIM_TBLO.Row) Name(#LayoutPageRow2) Displayposition(3) Parent(#LayoutPageLayout) Define_Com Class(#PRIM_TBLO.Column) Name(#LayoutPageColumn1) Displayposition(1) Parent(#LayoutPageLayout) Define_Com Class(#PRIM_TBLO.Row) Name(#LayoutPageLayoutRow1) Displayposition(1) Parent(#LayoutPageLayout) Height(48) Units(Pixels) Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutPageLayoutItem1) Manage(#Tab) Parent(#LayoutPageLayout) Row(#LayoutPageRow1) Column(#LayoutPageColumn1) Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutPageLayoutItem2) Manage(#ViewContainer) Parent(#LayoutPageLayout) Row(#LayoutPageRow2) Column(#LayoutPageColumn1) Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutPageLayoutItem3) Column(#LayoutPageColumn1) Manage(#Appbar) Parent(#LayoutPageLayout) Row(#LayoutPageLayoutRow1) Define_Com Class(#PRIM_TBLO) Name(#LayoutTab) Define_Com Class(#PRIM_TBLO.Column) Name(#LayoutTabColum) Parent(#LayoutTab) Displayposition(1) Define_Com Class(#PRIM_TBLO.Row) Name(#LayoutTabRow1) Parent(#LayoutTab) Displayposition(1) Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutTabItem1) Manage(#TabItem1) Parent(#LayoutTab) Row(#LayoutTabRow1) Column(#LayoutTabColum) Flow(CenterHorizontal) Sizing(FitToHeight) Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutTabItem2) Manage(#TabItem2) Parent(#LayoutTab) Row(#LayoutTabRow1) Column(#LayoutTabColum) Flow(CenterHorizontal) Sizing(FitToHeight) Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutTabItem3) Manage(#TabItem3) Parent(#LayoutTab) Row(#LayoutTabRow1) Column(#LayoutTabColum) Flow(CenterHorizontal) Sizing(FitToHeight) Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutTabItem4) Column(#LayoutTabColum) Parent(#LayoutTab) Row(#LayoutTabRow1) Sizing(FitToHeight) Flow(CenterHorizontal) Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutTabItem5) Column(#LayoutTabColum) Manage(#TabItem4) Parent(#LayoutTab) Row(#LayoutTabRow1) Sizing(None) Flow(CenterHorizontal) Define_Com Class(#PRIM_MD.AppBar) Name(#Appbar) Caption('Title') Displayposition(3) Icon('menu') Parent(#COM_OWNER) Tabposition(3) Themedrawstyle('Heading2') Height(48) Width(1200) Define_Com Class(#PRIM_MD.Tab) Name(#Tab) Displayposition(1) Height(64) Parent(#COM_OWNER) Tabposition(1) Themedrawstyle('DarkTitle') Width(1200) Layoutmanager(#LayoutTab) Top(48) Define_Com Class(#prim_md.TabItem) Name(#TabItem1) Parent(#Tab) Displayposition(1) Height(64) Tabposition(1) Caption('Show View 1') Left(430) Top(0) View(#View1) Width(85) Icon('search') Iconalignment(AboveCaption) Iconheight(32) Themedrawstyle('DarkTitle') Define_Com Class(#prim_md.TabItem) Name(#TabItem2) Parent(#Tab) Displayposition(2) Height(64) Left(515) Tabposition(2) Top(0) Caption('Show View 2') View(#View2) Width(85) Icon('view_week') Iconalignment(AboveCaption) Iconheight(32) Themedrawstyle('DarkTitle') Define_Com Class(#prim_md.TabItem) Name(#TabItem3) Parent(#Tab) Displayposition(3) Height(64) Left(600) Tabposition(3) Top(0) Caption('Show View 3') View(#View3) Width(85) Icon('watch') Iconalignment(AboveCaption) Iconheight(32) Themedrawstyle('DarkTitle') Define_Com Class(#PRIM_MD.TabItem) Name(#TabItem4) Caption('Show Dialog') Displayposition(4) Height(64) Left(685) Parent(#Tab) Tabposition(4) Top(0) Width(85) Icon('settings') Iconalignment(AboveCaption) Iconheight(32) Themedrawstyle('DarkTitle') Dialog(#Dialog) Define_Com Class(#prim_md.ViewContainer) Name(#ViewContainer) Parent(#COM_OWNER) Displayposition(2) Tabposition(2) Height(688) Top(112) Width(1200) Define_Com Class(#PRIM_view) Name(#View1) Parent(#ViewContainer) Displayposition(1) Tabposition(1) Height(688) Left(400) Width(1200) Define_Com Class(#PRIM_view) Name(#View2) Parent(#ViewContainer) Displayposition(3) Tabposition(3) Height(688) Width(1200) Top(226) Define_Com Class(#PRIM_view) Name(#View3) Parent(#ViewContainer) Displayposition(2) Tabposition(2) Height(688) Left(800) Width(1200) Define_Com Class(#PRIM_DLG) Name(#Dialog) Height(400) Autoclose(True) Define_Com Class(#prim_md.Label) Name(#Label1) Parent(#View1) Displayposition(1) Tabposition(1) Caption('View 1') Height(120) Left(0) Themedrawstyle('Title') Top(0) Width(360) Define_Com Class(#prim_md.Label) Name(#Label2) Parent(#View2) Displayposition(1) Tabposition(1) Caption('View 2') Height(120) Left(0) Themedrawstyle('Title') Top(0) Width(360) Define_Com Class(#prim_md.Label) Name(#Label3) Parent(#View3) Displayposition(1) Tabposition(1) Caption('View 3') Height(120) Left(0) Themedrawstyle('Title') Top(0) Width(360) Define_Com Class(#prim_md.Label) Name(#Label4) Parent(#Dialog) Displayposition(1) Tabposition(1) Caption('Dialog') Height(120) Left(0) Themedrawstyle('Title') Top(0) Width(360) End_Com
Properties
| Name | Description |
|---|---|
| BusyUpdates | BusyUpdates specifies how the control updates itself Inherited from Control (PRIM_CTRL) |
| BusyUpdatesOfParent | BusyUpdatesOfParent specifies whether the parent controls updates Inherited from Control (PRIM_CTRL) |
| CanFocus | CanFocus returns a value indicating whether the control can receive keyboard focus Inherited from Control (PRIM_CTRL) |
| ComponentClassName | ComponentClassName is the name of the component's class. Inherited from Object (PRIM_OBJT) |
| ComponentControls | ComponentControls is a collection of all the controls contained in this component. Inherited from Container (PRIM_CPST) |
| ComponentMembers | ComponentMembers provides access to all the member components of this component Inherited from Object (PRIM_OBJT) |
| ComponentPatternName | ComponentPatternName is used to qualify the class of the component. Inherited from Object (PRIM_OBJT) |
| ComponentTag | Generic space allowing a value to be stored for the instance Inherited from Object (PRIM_OBJT) |
| ComponentType | ComponentType gives you access to the type information about the component Inherited from Object (PRIM_OBJT) |
| ComponentTypeName | ComponentTypeName is the fully qualified name of the component's class. Inherited from Object (PRIM_OBJT) |
| Cursor | Cursor sets the cursor image Inherited from Control (PRIM_CTRL) |
| DesignManager | Reference to a Design Manager instance for this panel Inherited from Panel (PRIM_PANL) |
| DisableNoScroll | DisableNoScroll controls whether scroll bars are displayed. Inherited from Panel (PRIM_PANL) |
| DisplayPosition | DisplayPosition determines the order in which components are shown Inherited from Control (PRIM_CTRL) |
| DragStyle | DragStyle determines how a component can be dragged Inherited from Control (PRIM_CTRL) |
| EnableChildren | EnableChildren specifies if the parent sets the Enabled property of child components Inherited from Container (PRIM_CPST) |
| Enabled | Enable activates/deactivates the component Inherited from Control (PRIM_CTRL) |
| FixedPosition | Fix the control position so that it does not move if the parent is scrolled Inherited from Control (PRIM_CTRL) |
| Focus | Focus tells whether the component has focus Inherited from Control (PRIM_CTRL) |
| FocusedStyle | Reference to a style to be applied when the control is focus Inherited from Control (PRIM_CTRL) |
| FocusedStyles | Collection of styles to be applied when the control is focus Inherited from Control (PRIM_CTRL) |
| Handle | Returns the Windows handle in desktop applications Inherited from Control (PRIM_CTRL) |
| Height | The height of the control in pixels Inherited from Control (PRIM_CTRL) |
| Hint | Caption displayed when the mouse hovers over the control Inherited from Control (PRIM_CTRL) |
| HintPopup | HintPopup allows a PopupPanel instance to be used instead of the default hint text box Inherited from Control (PRIM_CTRL) |
| HintShow | Enabled or disable the appearance of hints Inherited from Control (PRIM_CTRL) |
| HintShowOfParent | Delegate hints appearance to the parent control Inherited from Control (PRIM_CTRL) |
| HintTitle | HintTitle defines the text shown at the top of the hint window in emphasized text Inherited from Control (PRIM_CTRL) |
| HorizontalScroll | Show the horizontal scroll bar Inherited from Panel (PRIM_PANL) |
| HorizontalScrollInc | HorizontalScrollInc specifies the pixel increment for horizontal scroll bar. Inherited from Panel (PRIM_PANL) |
| HorizontalScrollPos | HorizontalScrollPos sets the position of the horizontal scroll bar Inherited from Panel (PRIM_PANL) |
| HorizontalScrollRemainder | Specifies the pixels remaining to the right of the current scroll position Inherited from Panel (PRIM_PANL) |
| Image | Repository enrolled image to show in the control Inherited from Panel (PRIM_PANL) |
| ImageAlignment | Position of the image within the panel Inherited from Panel (PRIM_PANL) |
| IsAnimating | IsAnimating indicates that a control is currently being animated Inherited from Control (PRIM_CTRL) |
| IsRealized | True if the control is currently realized Inherited from Control (PRIM_CTRL) |
| LayoutManager | Reference to a layout manager used to control the position of child controls Inherited from Panel (PRIM_PANL) |
| Left | Position of the control relative to the left boundary of its parent Inherited from Control (PRIM_CTRL) |
| Modified | Modified indicates that the contents of the component have changed Inherited from Control (PRIM_CTRL) |
| MouseOver | MouseOver determines whether the mouse is directly over a control Inherited from Control (PRIM_CTRL) |
| MouseOverPart | True if the cursor is within the bounds of a child component Inherited from Container (PRIM_CPST) |
| MouseOverStyle | MouseOverStyle defines the style to be applied to a control when the mouse is over it Inherited from Control (PRIM_CTRL) |
| MouseOverStyles | MouseOverStyles is a collection of styles to be applied to a control when the mouse is over it Inherited from Control (PRIM_CTRL) |
| Name | Name identifies the component Inherited from Object (PRIM_OBJT) |
| Opacity | Opacity denotes the appearance of a control in terms of its interaction with its background Inherited from Control (PRIM_CTRL) |
| Owner | Owner owns this component Inherited from Object (PRIM_OBJT) |
| Parent | Reference to the control in which this control is visually positioned Inherited from Control (PRIM_CTRL) |
| Popup | Popup allows a PopupPanel instance to be used instead of the typical right click popup menu Inherited from Control (PRIM_CTRL) |
| PopupMenu | Reference to a PopupMenu to be shown on a right click Inherited from Control (PRIM_CTRL) |
| PrivateStyle | Style applied to the control but not inherited by child controls Inherited from Container (PRIM_CPST) |
| PrivateStyles | Collection of styles applied to the control but not inherited by child controls Inherited from Container (PRIM_CPST) |
| RenderStyle | Render content as DirectX or defer to the parent control Inherited from Panel (PRIM_PANL) |
| Rotation | Rotation allows a control to rotate a number of degrees about a given origin Inherited from Control (PRIM_CTRL) |
| RotationOriginLeft | RotationOriginLeft defines the left coordinate of an imaginary point around which a control will rotate Inherited from Control (PRIM_CTRL) |
| RotationOriginTop | RotationOriginTop defines the top coordinate of an imaginary point around which a control will rotate Inherited from Control (PRIM_CTRL) |
| ScaleHeight | ScaleHeight is the percentage of the height to use in the visual appearance of a control Inherited from Control (PRIM_CTRL) |
| ScaleOriginLeft | ScaleOriginLeft defines the left coordinate of an imaginary point from which a control will scale Inherited from Control (PRIM_CTRL) |
| ScaleOriginTop | ScaleOriginTop defines the top coordinate of an imaginary point from which a control will scale Inherited from Control (PRIM_CTRL) |
| ScaleWidth | ScaleWidth is the percentage of the width to use in the visual appearance of a control Inherited from Control (PRIM_CTRL) |
| ScreenLeft | ScreenLeft sets the distance from the left of the screen Inherited from Control (PRIM_CTRL) |
| ScreenTop | ScreenTop sets the distance from the top of the screen Inherited from Control (PRIM_CTRL) |
| ScrollLeft | Left position of a horizontally scrolled child control relative to its parent control Inherited from Control (PRIM_CTRL) |
| ScrollTop | Top position of a vertically scrolled child control relative to its parent control Inherited from Control (PRIM_CTRL) |
| SelectionColor | Underline color displayed on tab menu item that is associated with active view or tab sheet |
| ShowSelection | Show selection when the control does not have focus |
| SkewLeft | SkewLeft defines the angle at which to skew the control horizontally Inherited from Control (PRIM_CTRL) |
| SkewOriginLeft | SkewOriginLeft defines the left coordinate of an imaginary point from which a control will skew Inherited from Control (PRIM_CTRL) |
| SkewOriginTop | SkewOriginTop defines the top coordinate of an imaginary point from which a control will skew Inherited from Control (PRIM_CTRL) |
| SkewTop | SkewTop defines the angle at which to skew the control vertically Inherited from Control (PRIM_CTRL) |
| Style | Style defines the style to be applied to a control Inherited from Control (PRIM_CTRL) |
| Styles | Collection of styles to be applied to the control Inherited from Control (PRIM_CTRL) |
| TabPosition | TabPosition sets the order of focus when the Tab key is used Inherited from Control (PRIM_CTRL) |
| TabStop | Set to false to stop focus being given to the control via the Tab key Inherited from Control (PRIM_CTRL) |
| ThemeBackground | Themed background for Material Design themed applications Inherited from Panel (PRIM_PANL) |
| ThemeDrawStyle | Name of the Theme DrawStyle to be applied to the panel Inherited from Panel (PRIM_PANL) |
| ThemeStyle | Specifies how theme usage is determined Inherited from Panel (PRIM_PANL) |
| Top | Position of the control relative to the top boundary of its parent Inherited from Control (PRIM_CTRL) |
| TouchMove | Determines how the control will respond to touch move processing Inherited from Control (PRIM_CTRL) |
| TouchRotate | Determines how the control will respond to touch rotation Inherited from Control (PRIM_CTRL) |
| TouchScale | Determines how the control will respond to touch scaling Inherited from Control (PRIM_CTRL) |
| TouchSize | Determines whether a control can be resized Inherited from Control (PRIM_CTRL) |
| VerticalScroll | Show the vertical scroll bar Inherited from Panel (PRIM_PANL) |
| VerticalScrollInc | VerticalScrollInc specifies the pixel increment for vertical scroll bar. Inherited from Panel (PRIM_PANL) |
| VerticalScrollPos | VerticalScrollPos sets the position of the vertical scroll bar Inherited from Panel (PRIM_PANL) |
| VerticalScrollRemainder | Specifies the pixels left to the botom from the current scroll position Inherited from Panel (PRIM_PANL) |
| ViewStyle | Defines the appearance and behaviour of the tabs pages in the bottom dock area |
| Visible | Show or hide the control Inherited from Control (PRIM_CTRL) |
| VisualStyle | VisualStyle sets the appearance Inherited from Control (PRIM_CTRL) |
| VisualStyleOfParent | Adopt the Visual style from the parent control Inherited from Control (PRIM_CTRL) |
| Width | Width of the component in pixels Inherited from Control (PRIM_CTRL) |
Events
| Name | Description |
|---|---|
| AnimationEnded | Fired when an animation is ended Inherited from Control (PRIM_CTRL) Cancelled |
| Click | Fired when the mouse is clicked on the control Inherited from Control (PRIM_CTRL) Origin, Handled |
| CreateInstance | CreateInstance is signalled when an instance of a component is created Inherited from Control (PRIM_CTRL) |
| DesignChanged | Fired when the a design is activated Inherited from Control (PRIM_CTRL) Design, DesignManager |
| DestroyInstance | DestroyInstance is signalled when an instance of a component is about to be destroyed Inherited from Control (PRIM_CTRL) |
| DoubleClick | Fired when the user double clicks Inherited from Control (PRIM_CTRL) Origin, Handled |
| DragDrop | Fired on mouse up to signify the end of a drag process Inherited from Control (PRIM_CTRL) PosX, PosY, Source, Payload, AggregatedSource, Origin, Handled, DragResult |
| DragOver | Fired during the drag and drop process when the cursor moves over the control Inherited from Control (PRIM_CTRL) PosX, PosY, Source, Payload, DragState, AcceptDrop, DragCursor, ShowDropHilight, AggregatedSource, Origin, Handled |
| EndDrag | Fired when the drag and drop process has completed Inherited from Control (PRIM_CTRL) Source, Payload, DragResult, AggregatedSource, Origin, Handled |
| Enter | Fired when the Enter key is pressed Inherited from Control (PRIM_CTRL) KeyCode, Char, IsAltDown, IsControlDown, IsShiftDown, Handled |
| Initialize | Fired after a component has been realized for the first time Inherited from Control (PRIM_CTRL) |
| KeyPress | Fired when a key is pressed on the keyboard Inherited from Control (PRIM_CTRL) KeyCode, Char, IsAltDown, IsControlDown, IsShiftDown, Handled |
| MouseEnter | The mouse has entered the bounds of the control Inherited from Control (PRIM_CTRL) |
| MouseHover | The mouse has hovered over the control Inherited from Control (PRIM_CTRL) Origin, Handled |
| MouseLeave | The mouse has left the bounds of the control Inherited from Control (PRIM_CTRL) |
| ScrollChanged | Fired when the scrollbars in a composite control are moved Inherited from Control (PRIM_CTRL) Orientation |
| SizeChanged | Fired when the size of the panel is changed Inherited from Control (PRIM_CTRL) |
| StartDrag | Fired when the user starts a drag and drop process Inherited from Control (PRIM_CTRL) Source, Payload, Continue, DragList, AggregatedSource, Origin, Handled |
| TabChanging | Fired when a Prim_tab.item is clicked
OpenItem, OpeningItem, CanChangeItem |
| TouchChange | Fired repeatedly between the TouchStart and TouchEnd boundaries to provide details of the touch events Inherited from Control (PRIM_CTRL) MoveLeft, MoveTop, ScaleWidth, ScaleHeight, Rotation, Continue |
| TouchEnd | Fired when the user stops touching the screen Inherited from Control (PRIM_CTRL) |
| TouchStart | Fired when the user first makes physical contact with the screen Inherited from Control (PRIM_CTRL) Origin, TouchMove, TouchRotate, TouchScale, TouchSize |
Methods
| Name | Description |
|---|---|
| FadeIn | Animate from invisible to visible Inherited from Control (PRIM_CTRL) Duration, Delay |
| FadeOut | Animate from visible to invisible Inherited from Control (PRIM_CTRL) Duration, Delay, Visible |
| HorizontalScrollTo | Set the horizontal scroll position using a child control Inherited from Panel (PRIM_PANL) Control, ScrollPosition |
| MoveFrom | Move a control from the specified position to the current position Inherited from Control (PRIM_CTRL) Left, Top, Duration, Delay |
| MoveTo | Animate a move from the specified number of pixels Inherited from Control (PRIM_CTRL) Left, Top, Duration, Delay |
| Realize | Creates the visual portion of dynamically created controls Inherited from Control (PRIM_CTRL) |
| Scale | Animate a change of scale Inherited from Control (PRIM_CTRL) ScaleWidth, ScaleHeight, Duration, Delay |
| SetFocus | Sets the control to be the focus control Inherited from Control (PRIM_CTRL) |
| ShowMessages | LANSA Internal Use Inherited from Control (PRIM_CTRL) |
| SizeTo | Changes and animates control size changing Inherited from Control (PRIM_CTRL) Width, Height, Duration, Delay |
| Transition | Animate the change from one control to another Inherited from Container (PRIM_CPST) From, To, TransitionType, Duration, Delay |
| Unrealize | Destroys the visual portion of dynamically created controls Inherited from Control (PRIM_CTRL) |
| UpdateDisplay | UpdateDisplay updates the display immediately Inherited from Control (PRIM_CTRL) |
| VerticalScrollTo | Set the vertical scroll position using a child control Inherited from Panel (PRIM_PANL) Control, ScrollPosition |
See also
LANSA Version 15, April 2020