minigui-docs/programming-guide/MiniGUIProgGuidePart2Chapter09.md

Chapter 8 of Part 2 Slider Control Class

---++Brief Introduction of Slider Control The slider control is mainly visual realization to the adjustment logic of a value. Through dragging and sliding the control, occasions of the users adjusting the brightness and volume and operation of adjusting the value of a certain range are more visual, avoiding the trouble of keyboard input.

• Hierarchical relation of slider control class

  • mWidget * mSlider * mTrackBar * mScrollBar
  • Control creating method
  • Automatic creation: drag corresponding slider control through interface designer in mStudio, and mStudio will automatically create control and provide visual control configuration, and at the same time, creation codes are generated automatically.
  • Manual generation: according to mGNCS control creation process, through programming, corresponding control window class ID is imported and control is generated. Manual programming sets control property and event handling.

---++mSlider

• Control window class: NCSCTRL_SLIDER
• Control English name: Slider
• Brief introduction: Basic class of slider series controls
• Schematic diagram:

%RED%The control is abstract control and cannot be used directly%ENDCOLOR%

---+++Style of mSlider

It is inherited from the style of mWidget | Style name | mStudio property name | Explanation | | NCSS_SLD_HORIZONTAL | -- | Create horizontal Slider control (default) | | NCSS_SLD_VERTICAL | -- | Create vertical Slider control |

Property of mSlider

It is inherited from the property of mWidget | Property | mStudio property name | Type | RW | Explanation || | NCSP_SLD_MAXPOS | -- | int | RW | Set the maximum value of slide range of Slider | Setting of the maximum and minimum values is generally done at initialization | | NCSP_SLD_MINPOS | -- | int | RW | Set the minimum value of slide range of Slider | ^ | | NCSP_SLD_CURPOS | -- | int | RW | Set the current location of the slide block || | NCSP_SLD_LINESTEP | -- | int | RW | Set step length (direction key) || | NCSP_SLD_PAGESTEP | -- | int | RW | Set step length (pageUp/pageDown) ||

Event of mSlider

It is inherited from the event of mWidget | Event ID | Parameter | Explanation | | NCSN_SLD_CHANGED | -- | Slide block location changes | | NCSN_SLD_REACHMAX | -- | The slide block reaches the maximum value | | NCSN_SLD_REACHMIN | -- | The slide block reaches the minimum value |

Method of mSlider

It is inherited from the method of mWidget

Example of mSlider

%RED%The control is abstract control and cannot be used directly%ENDCOLOR%

---++mTrackBar ---++mTrackBar

• Control window class: NCSCTRL_TRACKBAR
• Control English name: Trackbar
• Brief introduction: The slide block control adjusts the value within the range
• Schematic diagram:

---+++Style of mTrackBar It is inherited from the style of mSlider | Style | mStudio property name | Explanation | | NCSS_TRKBAR_HORIZONTAL | -- | Create horizontal Trackbar control (default) | | NCSS_TRKBAR_VERTICAL | -- | Create vertical Trackbar control | | NCSS_TRKBAR_NOTICK | Ruler -> False | Scale is not displayed | | ^ | Ruler -> True | Scale is displayed |

Property of mTrackBar

It is inherited from the property of mSlider | Property name | mStudio property name | Type | RW | Explanation || | NCSP_TRKBAR_MAXPOS | MaxPos | int | RW | Set the maximum value of the slide range of Trackbar | Setting of the maximum and minimum values is generally done at initialization | | NCSP_TRKBAR_MINPOS | MinPos | int | RW | Set the minimum value of the slide range of the Trackbar | ^ | | NCSP_TRKBAR_CURPOS | CurPos | int | RW | Set the current location of the slide block || | NCSP_TRKBAR_LINESTEP | LineStep | int | RW | Set step length (direction key) || | NCSP_TRKBAR_PAGESTEP | PageStep | int | RW | Set step length (pageUp/pageDown) ||

Event of mTrackBar

It is inherited from the event of mSlider | Event ID | Parameter | Explanation | | NCSN_TRKBAR_CHANGED | -- | Slide block location changes | | NCSN_TRKBAR_REACHMAX | -- | The slide block reaches the maximum value | | NCSN_TRKBAR_REACHMIN | -- | The slide block reaches the minimum value |

Method of mTrackBar

It is inherited from the method of mSlider

Renderers of mTrackBar

---++++ mTrackBar Classic Renderer

For the drawing of non client area, please refer to the renderer of mWidget | Property ID | Meaning | mStudio property name | Value type | Schematic diagram of the valid region | Value Region | | NCS_BGC_3DBODY | Color of slide block and slide rail | ColorBg3DBody | DWORD(ARGB) | | | | NCS_BGC_DISABLED_ITEM | Color of the slide block when the control is invalid | ColorBgDisable | DWORD(ARGB) || |

---++++ mTrackBar Skin Renderer

Refer to Appendix B : Specification for the Image Resource Used by Skin Renderer

---++++ mTrackBar Fashion Renderer

For the drawing of non client area, please refer to the drawing of Fashion renderer of mWidget

| Property ID | Meaning | mStudio property name | Value type | Schematic diagram of the valid region | Value Region | | NCS_BGC_3DBODY | Color of the slide block | ColorBg3DBody | DWORD(ARGB) | | | | NCS_BGC_DISABLED_ITEM | Color of the slide block when the control is invalid | ColorBgDisable | DWORD(ARGB) || | | NCS_BGC_TRKBAR_SLIDER | Color of the slide rail | SliderColor | DWORD(ARGB) || | | NCS_METRICS_3DBODY_ROUNDX | Round corner X radius of the slide block | ThumbRoundX | int | | 0 ~ 1/2 of the window width | | NCS_METRICS_3DBODY_ROUNDY | Round corner Y radius of the slide block | ThumbRoundY | int| | 0 ~ 1/2 of the window height |

---++++ mTrackBar Flat Renderer For the drawing of non client area, please refer to the drawing of Flat renderer of mWidget

| Property ID | Meaning | mStudio property name | Value type | Schematic diagram of the valid region | Value range | | NCS_FGC_3DBODY | Color of the slide block side | ColorFg3DBody | DWORD(ARGB) | | | | NCS_BGC_3DBODY | Color of the slide block | ColorBg3DBody | DWORD(ARGB) | Same as Classic renderer | |

Example of mTrackBar

Figure p2c8-1 Example of trackbar

List p2c8-1 trackbar.c

```cplusplus %INCLUDE{"%ATTACHURL%/trackbar.c.txt"}% ```

---++mScrollBar

• Control window class: NCSCTRL_SCROLLBAR
• Control English name: Scrollbar
• Brief introduction: Slide block that can be dragged, commonly used for window content display adjustment
• Schematic diagram:

---+++Style of mScrollBar

It is inherited from the style of mSlider | Style | mStudio property name | Explanation | | NCSS_SCRLBR_HORIZONTAL | -- | Create horizontal scrollbar control (default) | | NCSS_SCRLBR_VERTICAL | -- | Create vertical scrollbar control | | NCSS_SCRLBR_ARROWS | HaveArrows | Mark if a scroll bar has arrow | | NCSS_SCRLBR_LEFTDBLARROWS | DoubleArrows -> Left | Mark if a scroll bar has left double arrows (mutually exclude with NCSS_SCROLLBAR_RIGHTDBLARROWS) | | NCSS_SCRLBR_RIGHTDBLARROWS | DoubleArrows -> Right | Mark if a scroll bar has right double arrows (mutually exclude with NCSS_SCROLLBAR_LEFTDBLARROW) | | NCSS_SCRLBR_UPDBLARROWS | DoubleArrows -> Up | Mark if a scroll bar has up arrow (mutually exclude with NCSS_SCROLLBAR_DOWNDBLAROWS)| | NCSS_SCRLBR_DOWNDBLAROWS | DoubleArrows -> Down |Mark if a scroll bar has down arrow (mutually exclude with NCSS_SCROLLBAR_DUPDBLAROWS)|

Property of mScrollBar

It is inherited from the property of mSlider | Property name | mStudio property name | Type | RW | Explanation || | NCSP_SCRLBR_MAXPOS | MaxPos | int | RW | Set the maximum value of the slide range of scrollbar| Setting of maximum and minimum values is generally done at initialization | | NCSP_SCRLBR_MINPOS | MinPos | int | RW | Set the minimum value of the slide range of scrollbar | ^ | | NCSP_SCRLBR_CURPOS | CurPos | int | RW | Set current location of the slide block || | NCSP_SCRLBR_LINESTEP | LineStep | int | RW | Set step length (direction key) || | NCSP_SCRLBR_PAGESTEP | PageStep | int | RW | Set step length (pageUp/pageDown) ||

Event of mScrollBar

It is inherited from the event of mSlider | Event ID | Parameter | Explanation | | NCSN_SCRLBR_CHANGED | -- | Slide block location changed | | NCSN_SCRLBR_REACHMAX | -- | The slide block reaches the maximum value | | NCSN_SCRLBR_REACHMIN | -- | The slide block reaches the minimum value |

Method of mScrollBar

It is inherited from the method of mSlider

Renderer of mScrollBar

---++++ mScrollBar Classic Renderer

For the drawing of non client area, please refer to the renderer of mWidget

| Property ID | Meaning | mStudio property name | Value type | Schematic diagram of the valid region | Value Range | | NCS_BGC_3DBODY | Background color of the control | BgColor | DWORD(ARGB) | | | | NCS_BGC_DISABLED_ITEM | Color of the slide block and arrow button when the control is invalid | ColorBgDisable | DWORD(ARGB) || | | NCS_FGC_3DBODY | Color of the button up arrow | ArrowColor | DWORD(ARGB) | | | | NCS_FGC_DISABLED_ITEM | Color of the arrow when the button is invalid | ArrowColorDisable | DWORD(ARGB) | | |

---++++ mScrollBar Skin Renderer

Refer to Appendix B : Specification for the Image Resource Used by Skin Renderer

---++++ mScrollBar Fashion Renderer

For the drawing of non client area, please refer to the drawing of Fashion renderer of mWidget

| Property ID | Meaning | mStudio property name | Value type | Schematic diagram of the valid region | Value Range | | NCS_BGC_3DBODY | Color of the slide block and button | ColorBg3DBody | DWORD(ARGB) | | | | NCS_BGC_DISABLED_ITEM | Color of the slide block and arrow button when the control is invalid | ColorBgDisable | DWORD(ARGB) | Same as Classic renderer | | | NCS_BGC_WINDOW | Color of the slide rail | ColorBgWindow | DWORD(ARGB) | | | | NCS_FGC_DISABLED_ITEM | Color of the arrow when the button is invalid | ArrowColorDisable | DWORD(ARGB) | Same as Classic renderer | | | NCS_METRICS_3DBODY_ROUNDX | Round corner X radius of the slide block | RoundX | int | | 0 ~ 1/2 of the window width | | NCS_METRICS_3DBODY_ROUNDY | Round corner Y radius of the slide block | RoundY | int| | 0 ~ 1/2 of the window height | | NCS_MODE_BGC | Gradual change fill mode | GradientMode | int || GradientMode | | | | | | | |

---++++ mScrollBar Flat Renderer For the drawing of non client area, please reefer to the drawing of Flat renderer of mWidget

| Property ID | Meaning | mStudio property name | Value type | Schematic diagram of the valid region | Value range | | NCS_FGC_3DBODY | Color of the slide block and button side | ColorFg3DBody | DWORD(ARGB) | | | | NCS_BGC_3DBODY | Background color of the control | ColorBg3DBody | DWORD(ARGB) | | |

Example of mScrollbar

Figure p2c8-2 Example of scrollbar

List p2c8-2 scrollbar.c

%INCLUDE{"%ATTACHURL%/scrollbar.c.txt"}%

[Next](MStudioMGNCSV1dot0PGENP2C7][Previous]] < MStudioMGNCSV1dot0PGEN][Index > [[MStudioMGNCSV1dot0PGENP2C9)