TMlSkinSpinEdit

A numeric edit with up/down arrows for stepping the value.

Category
Edits & pickers
Unit
uMlSkinSpinEdit.pas
Inherits from
TMlSkinPngEdit → TMlSkinCustomControl

Notes

  • Read and write the number through Value, bounded by MinValue and MaxValue.
  • StepSize is how much each arrow click adds or subtracts; the default is 1.
  • The arrows fire OnUpButtonClick and OnDownButtonClick.

Example

From the demo MlSkin.Demo.滚动消息栏.v3.0 (.dfm form file)

object se1: TMlSkinSpinEdit
  Left = 211
  Top = 34
  Width = 58
  Height = 26
  Cursor = crIBeam
  MinValue = 1
  MaxValue = 1000
  Value = 15
  FontHint.Charset = DEFAULT_CHARSET
  FontHint.Color = 11711154
  FontHint.Height = -11
  FontHint.Name = 'Tahoma'
  FontHint.Style = []
  BorderNormal = 'MlSkinBorderNormal'
  BorderHot = 'MlSkinBorderHot'
  Text = '15'
  EdItems = <
  ...

Properties 13

NameTypeDefaultDescription
MinValueInteger0Lowest value allowed.
MaxValueInteger100Highest value allowed.
StepSizeInteger1How much one arrow click adds or subtracts; the default is 1.
ValueInteger0The current number; values outside MinValue–MaxValue are clamped back into range.
FontHintTFont—Font of the placeholder text, usually lighter than the main text.
BorderNormalTMlResID—Border image in the normal state, given as an image ID or path.
BorderHotTMlResID—Border image used on hover or while focused.
ReadOnlyBooleanFalseRead-only: the content cannot be edited, but it can still be selected and copied.
Textstring—The text shown or typed in the control.
TextHintstring—Placeholder text shown in a light color while the control is empty, for example "Type a keyword".
MaxLengthInteger0Maximum number of characters; 0 means no limit.
EdItemsTMlEditItems—The items inside the edit: each has its images (normal, hot, pressed), text, position and visibility — this is how clear, search or reveal-password buttons are built.
SpaceTMlSpaceSize—Padding between the text and the border (left, top, right, bottom); switch its Active on first.

Events 3

NameTypeDefaultDescription
OnUpButtonClickTNotifyEvent—Fires when the up arrow is clicked.
OnDownButtonClickTNotifyEvent—Fires when the down arrow is clicked.
OnChangeTNotifyEvent—Fires when the content changes.
Properties of TMlSkinPngEdit 3
NameTypeDefaultDescription
TextHintHideInKeyBooleanFalseWhen the placeholder disappears: with this on it stays while focused and hides only once a character is typed.
CursorColorTColorclBlackColour of the caret.
DisableIMEBooleanFalseDisables the IME so only Latin letters and digits can be typed — useful for account or serial number fields.
Properties of TMlSkinCustomControl 5
NameTypeDefaultDescription
AboutTMlAboutInfo—A design-time property: double-clicking it in the Object Inspector opens the MLSkin about box with the component version. It has no effect at run time and is not stored in the .dfm.
TransparentBooleanTrueTransparent background: the control skips its own fill and shows the form background (image or color) instead.
ColorTColorclWhiteBackground color of the control; ignored while Transparent is on.
AutoInvalidateBooleanFalseRepaints automatically when the content changes. Turn it on if property changes do not show up.
EraseBackgroundBooleanFalseWhether the background is erased before painting; worth toggling if the control flickers.
Events of TMlSkinCustomControl 4
NameTypeDefaultDescription
OnDPIChangedTMlDPIChangedEvent—Fires when the screen DPI changes, for example when the window moves to a monitor with a different scaling — a good place to re-adjust anything you draw yourself.
OnBackgroundChangingTMlBackgroundEvent—Fires just before the background changes, giving you a chance to adjust what is drawn.
OnBackgroundChangedTMlCustomDrawEvent—Fires after the background has been drawn, so you can paint on top of it.
OnVisibleChangedTNotifyEvent—Fires when the control is shown or hidden.

Only the properties and events MLSkin adds are listed here. Standard VCL properties such as Align, Anchors, Font and OnClick are available too and behave exactly as on the stock controls.

Offline helpA PDF / CHM version is available for offline reading.