16 KiB
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
-
Control creating method
- Automatic creation: drag corresponding slider control through interface designer in miniStudio, and miniStudio 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
IDis 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 | miniStudio 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 | miniStudio 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 | miniStudio 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 | miniStudio 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 | miniStudio 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 | miniStudio 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 | miniStudio 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
``` ```---++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 | miniStudio 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 | miniStudio 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 | miniStudio 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 | miniStudio 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 | miniStudio 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
[Next](MStudioMGNCSV1dot0PGENP2C7][Previous]] < MStudioMGNCSV1dot0PGEN][Index > [[MStudioMGNCSV1dot0PGENP2C9)
<< | Table of Contents | >>