複合數控控制元件
# Smart 控制元件使用(複合數控)
該組中包含一些雜項元件。
# 1. TAbClock
該元件顯示為一個數字時鐘圖形控制元件。可自動獲取並顯示目前的系統時間。
# 1.1. 屬性
- TAbClock元件主要屬性
| 屬性 | 功能說明 |
|---|---|
| AutoHint | 是否自動建立提示 |
| BevelInner | 確定元件的內斜角的樣式 |
| BevelOuter | 確定元件的外斜角的樣式 |
| ClockOption | 設定時鐘的屬性 |
# 1.1.1. AutoHint屬性
property AutoHint: Boolean;
1
該屬性用於確定控制元件是否建立自動提示。
# 1.1.2. BevelInner屬性
property BevelInner: TAbSBevel;
1
該屬性用於確定元件的內斜角的樣式。包含以下設定專案。
- BevelLine：設定邊線的樣式。
blNone：不顯示線條。blInner：僅顯示內線條。blOuter：僅顯示外線條。blBoth：雙線條。
- Color：設定填充顏色。
- OffSet：設定內邊線位置的偏移量。
- PenColor：設定邊線的顏色。
- Style：設定邊線的樣式。
- SurfaceGrad：設定背景的漸變外觀樣式。
# 1.1.3. BevelOuter屬性
property BevelOuter: TAbSBevel;
1
該屬性用於確定元件的外斜角的樣式。包含以下設定專案。
- BevelLine：設定邊線的樣式。
blNone：不顯示線條。blInner：僅顯示內線條。blOuter：僅顯示外線條。blBoth：雙線條。
- Color：設定填充顏色。
- OffSet：設定外邊線位置的偏移量。
- PenColor：設定邊線的顏色。
- Style：設定邊線的樣式。
- SurfaceGrad：設定背景的漸變外觀樣式。
# 1.1.4. ClockOption屬性
property ClockOption: TClockOption;
1
設定時鐘的顯示格式。coDate表示為僅顯示日期。coDateTime表示為顯示日期及時間。coTime表示為顯示時間。
# 2. TAbAnalogClock元件
該元件顯示為一個模擬指針的時鐘。可自動獲取並設定時間。
# 2.1. 屬性
- TAbAnalogClock元件主要屬性
| 屬性 | 功能說明 |
|---|---|
| ColorDiaH | 設定時鐘面板的整點刻度線的顏色 |
| ColorDiaM | 設定時鐘面板的分鐘刻度線的顏色 |
| ColorHHand | 設定時鐘小時指針的顏色 |
| ColorMHand | 設定時鐘分鐘指針的顏色 |
| ColorSHand | 設定時鐘秒指針的顏色 |
| Shadow | 設定指針的陰影濃度 |
| UseUtcOffset | 是否設定為UTC時間 |
| UTC_Offset | 設定UTC時差 |
# 3. TAbOpHourCounter元件
該元件可用於對操作時間進行計數。通過設定Count屬性為True來啟動計數器。如果達到設定的限制時間，則會觸發OnLimit事件。通過設定CountDown屬性為True以及Count為True，計數器將開啟倒計時模式直至計數變為0。此時將發生OnZero事件。使用IniSettings屬性，您可以指定一個檔案（ini樣式）， 可以在載入或者銷燬元件時節省時間。
使用SetTime方法可以設定計數器的時間。
# 3.1. 屬性
- TAbOpHourCounter元件主要屬性
| 屬性 | 功能說明 |
|---|---|
| BevelInner | 設定元件內斜邊的樣式 |
| BevelOuter | 設定元件外斜邊的樣式 |
| Count | 是否開啟計時功能 |
| CountDown | 是否啟用倒計時功能 |
| HourDigits | 小時位顯示的數值位數 |
| Indicate | 計時器顯示的時刻形式 |
| IniSettings | ini檔案的連線設定 |
| Limit | 時間限制的相關選項 |
| Options | 計時選項 |
| PresentValue | 當CountDown屬性為True且Options中的opPresetOnZero為True時，預設的起始計數 |
| SeparatorChar | 用於標識時間格式的分隔符號 |
| SeparatorHour | 用於標識時間中「小時」後面的標記符號 |
| SeparatorMin | 用於標識時間中「分鐘」後面的標記符號 |
| SeparatorSec | 用於標識時間中「秒」後面的標記符號 |
# 3.1.1. Count屬性
property Count: Boolean;
1
如果該屬性設定為True，則開啟計時。
# 3.1.2. CountDown屬性
property CountDown: Boolean;
1
如果該屬性設定為True，則計時器更改為倒計時模式。
# 3.1.3. HourDigits屬性
property HourDigits: Integer;
1
設定小時位顯示的數字的位數。
# 3.1.4. Indicate屬性
property Indicate: TOpHrIndicate;
1
設定計時器顯示的時間格式形式。
- oiHourMinSec：顯示時，分，秒。
- oiHourMin：顯示時，分。
- oiHour：顯示時。
# 3.1.5. IniSettings屬性
property IniSettings: TIniSettings;
1
連線到ini檔案的相關設定。
- AutoLoadSave：是否啟用自動載入及儲存配置。
- FileName：設定配置檔案的名稱。
- Section：設定設定片段的名稱。
- UseAppDir：是否使用應用名稱。
# 3.1.6. Limit屬性
property Limit: TTimeSetting;
1
當計數器計數並達到此限制時，就會發生OnLimit事件。 如果Options屬性中選擇了opStopOnLimit，則達到限制後計時器將停止。Limit中包含Hour(時)、Min(分)、Sec(秒)，設定該時分秒為限制點。
# 3.1.7. Options屬性
property Options: TOpHrOptions;
1
設定屬性的相關設定。
- opResetOnLimit：是否在計時達到限制后，重置計時器。
- opStopOnLimit：是否在計時達到限制后，停止計時。
- opPresentOnZero：是否顯示為倒計時操作。
# 3.1.8. PresentValue屬性
property PresetValue: TTimeSetting;
1
當CountDown屬性為True且Options中的opPresetOnZero為True時，預設的起始計數 。其中包含Hour(時)、Min(分)、Sec(秒)。
# 3.1.9. SeparatorChar屬性
property SeparatorChar: string;
1
用於標識時間格式的分隔符號。
# 3.1.10. SeparatorHour屬性
property SeparatorHour: string;
1
用於標識時間中「小時」後面的標記符號。
# 3.1.11. SeparatorMin屬性
property SeparatorMin: string;
1
用於標識時間中「分鐘」後面的標記符號。
# 3.1.12. SeparatorSec屬性
property SeparatorSec: string;
1
用於標識時間中「秒」後面的標記符號。
# 3.2. 事件
| 事件 | 何時觸發 |
|---|---|
| OnContextPopup | 在右鍵單擊控制元件或以其他方式呼叫彈出功能表（例如使用鍵盤）時觸發該事件 |
| OnLimit | 如果達到選定的限制條件，則觸發該事件 |
| OnZero | 如果時間計數變為0則觸發該事件 |
# 4. TAbLabel元件
無閃爍的標籤，可以根據整數輸入值（Digit）顯示不同的文字（DigitText）。
# 4.1. 屬性
- TAbOpHourCounter元件主要屬性
| 屬性 | 功能說明 |
|---|---|
| DefaultText | 如果Digit輸入的值不可用（在DigitText中），則顯示預設的文字 |
| Digit | 根據Digit的值顯示對應的文字（DigitText）。 |
| DigitText | 包含用分號分隔的文字 |
| Spacing | 設定文字邊緣的間距 |
| TextPosH | 文字在控制元件內的水平方向上的位置，有phLeft（居左），phCenter（居中），phRight（居右）的設定 |
| TextPosV | 文字在控制元件內的垂直方向上的位置，有pvBottom（居底），pvCenter（居中），pvTop（居頂）的設定 |
# 5. TAbBevel元件
該元件顯示為一個斜邊框。
# 5.1. 屬性
- TAbBevel元件主要屬性
| 屬性 | 功能說明 |
|---|---|
| BevelInner | 設定元件內斜邊的樣式 |
| BevelOuter | 設定元件外斜邊的樣式 |
| Options | 設定斜邊顯示的選項。opBevelInner表示是否顯示內邊框，opBevelOuter表示是否顯示外邊框，opTranparent表示背景是否透明 |
# 6. TAbPanel元件
該元件顯示為一個面板。
# 6.1. 屬性
- TAbPanel元件主要屬性
| 屬性 | 功能說明 |
|---|---|
| BevelInner | 設定元件內斜邊的樣式 |
| BevelOuter | 設定元件外斜邊的樣式 |
| Options | 設定斜邊顯示的選項。opBevelInner表示是否顯示內邊框，opBevelOuter表示是否顯示外邊框 |
# 7. TAbGradient元件
該元件用於繪製一個漸變色的圖層。
# 7.1. 屬性
- TAbGradient元件主要屬性
| 屬性 | 功能說明 |
|---|---|
| GradSettings | 設定漸變色的選項，ColorFrom表示漸變顏色的起始色，ColorTo表示為漸變顏色的終止色， Style表示為漸變色的樣式，Visible表示為漸變色是否可見 |
# 8. TAbTimerSpeedBtn元件
該元件為一個可以自動重複進行點選操作的快速按鈕。如果點選該按鈕，則在一個StartDelay屬性中指定的間隔時間后，啟用一系列以Interval屬性指定的時間間隔的OnClick事件。
# 8.1. 屬性
- TAbTimerSpeedBtn元件主要屬性
| 屬性 | 功能說明 |
|---|---|
| Interval | 設定重複點選事件的時間間隔，以ms為單位 |
| StartDelay | 設定間隔時間開始前的延時，以ms為單位 |
| TimerEnabled | 是否啟用按鈕的重複點選 |
# 9. TAbSpinButton元件
該元件為旋轉按鈕編輯/調整值的元件。
# 9.1. 屬性
- TAbSpinButton元件主要屬性
| 屬性 | 功能說明 |
|---|---|
| DownGlyph | 指定下按鈕位置顯示的點陣圖圖片 |
| DownNumGlyphs | 指定多個DownGlyph屬性的圖片源 |
| Enabled | 元件是否相應滑鼠，鍵盤以及計數器事件 |
| Interval | 如果用於持續按住按鈕，則指定其連續響應點選事件的時間間隔，以ms為單位 |
| StartDelay | 設定啟用自動重複點選事件前的時間延遲，以ms為單位 |
| UpGlyph | 指定上按鈕位置顯示的點陣圖圖片 |
| UpNumGlyphs | 指定多個UpGlyph屬性的圖片源 |
| Visble | 是否顯示該控制元件 |
# 9.2. 事件
| 事件 | 何時觸發 |
|---|---|
| OnDownClick | 當用戶點選下按鈕時觸發該事件 |
| OnUpClick | 當用戶點選上按鈕時觸發該事件 |
# 10. TAbNumEdit元件
該元件是在鍵入時具有輸入驗證的數字編輯元件，並具有可選的基數。
- 可選
EditBase以輸入整數，浮點數，十六進制或布林值 - 使用者和基礎相關的最小/最大限制
- 字首，用於更改輸入值的
EditBase - 浮點輸入已啟用指數（e和E）
- 乘數char（最後一個符號）
- 可在編輯時按ESC作為撤銷按鈕
- 向上/向下箭頭鍵支援
用於更改EditBase的字首型別：
| 字首 | 描述 |
|---|---|
| $ | 十六進字串 |
| & | 二進制字串 |
| % | 整形數值 |
| ！ | 浮點數值 |
支援的乘數字元：
| 字元 | 含義 | 因子 |
|---|---|---|
| E | Exa(兆兆兆) | 1e18 |
| P | Peta(千兆兆) | 1e15 |
| T | Tera(兆兆) | 1e12 |
| G | Giga(千兆) | 1e9 |
| M | Mega(兆) | 1e6 |
| k | kilo(千) | 1e3 |
| m | milli(毫) | 1e-3 |
| u | Micro(微) | 1e-6 |
| n | nano(納) | 1e-9 |
| p | pico(皮) | 1e-12 |
| f | femto(飛) | 1e-15 |
| a | atto(阿) | 1e-18 |
- 例如
EditBase屬性設定為ebFloat
- 指數：如需輸入的值為
1000，你可以輸入1e3或者e3。 - 乘數字元：如需輸入的值為
1000，你可以輸入1k或者k。 - 布林值型別的輸入轉換成浮點數、整數或者十六進制型別，使用字首
&。例如&101。 - 十六進制型別的輸入轉換成浮點是，整數或者布林值型別，使用字首
&。例如&FF。
# 10.1. 屬性
- TAbNumEdit元件主要屬性
| 屬性 | 功能說明 |
|---|---|
| ColorDefault | 設定輸入框的預設顏色 |
| ColorEditing | 編輯輸入內容判斷為有效時的背景顏色 |
| ColorError | 編輯輸入內容判斷為無效時的背景顏色 |
| DigitsBool | 輸入框顯示布林值的位數，有效輸入值：0..31,如果輸入為0則不會顯示前導0 |
| DigitsHex | 輸入框顯示十六進制的位數，有效輸入值：0...8,如果顯示為0則不會顯示前導0 |
| EditBase | 數字輸入顯示的數據型別，ebBin表示為二進制，ebFloat表示為浮點數，ebHex表示為十六進制，ebInt表示為整數型別 |
| EditorEnabled | 是否啟用編輯模式 |
| FormatStr | 浮點數顯示的格式化型別 |
| Increment | 指定每次按下向上或向下按鈕時值更改的量。 |
| MaxLength | 指定使用者可以輸入到編輯控制元件的最大字元數。 值為0表示沒有應用程式定義的長度限制 |
| MaxValue | 使用者定義的上限 |
# 11. TAbNumSpin元件
該元件是帶上下按鈕的編輯框，用於輸入/調整浮點數，整數，十六進制或二進制值。
- 包含
TAbNumEdit的所有功能。 - 具有最小值、最大值的限制。
- 可選增量（浮點數）。
- 乘法計數上下選擇的增量。
- 上下選擇的響應時間間隔（≥50ms）。
- 上下選擇響應的起始延遲時間。
- 乘法選擇。
- 如果在
Options屬性中選擇eoMultiply，則增量用於乘法（向上）和除法（向下）。
調整后的值可以限制為最小值/最大值（如果選項中為eoLimitMin / eoLimitMax）。 如果出現限制相應的按鈕變為「未啟用」（灰色）。
# 11.1. 屬性
- TAbNumSpin元件主要屬性
| 屬性 | 功能說明 |
|---|---|
| ColorDefault | 設定輸入框的預設顏色 |
| ColorEditing | 編輯輸入內容判斷為有效時的背景顏色 |
| ColorError | 編輯輸入內容判斷為無效時的背景顏色 |
| DigitsBool | 輸入框顯示布林值的位數，有效輸入值：0..31,如果輸入為0則不會顯示前導0 |
| DigitsHex | 輸入框顯示十六進制的位數，有效輸入值：0...8,如果顯示為0則不會顯示前導0 |
| EditBase | 數字輸入顯示的數據型別，ebBin表示為二進制，ebFloat表示為浮點數，ebHex表示為十六進制，ebInt表示為整數型別 |
| EditorEnabled | 是否啟用編輯模式 |
| FormatStr | 浮點數顯示的格式化型別 |
| Increment | 指定每次按下向上或向下按鈕時值更改的量。 |
| Interval | 如果使用者按住向上，向下按鈕時，自動重複響應事件的時間間隔。 |
| MaxLength | 指定使用者可以輸入到編輯控制元件的最大字元數。 值為0表示沒有應用程式定義的長度限制 |
| MaxValue | 使用者定義的上限 |
| StartDelay | 設定點選按鈕的延遲 |
# 12. TAbBMask元件
改元件是點陣圖遮罩元件的父元件，該元件在元件工具欄中是不可見的。
# 12.1. 屬性
- TAbBMask元件主要屬性
| 屬性 | 功能說明 |
|---|---|
| ColorShape | 負責元件的形狀，具有此顏色的圖片的所有區域均不包括在元件形狀中 |
| Picture | 形狀圖形 |
# 13. TAbMaskCanvas元件
該元件在所有顏色為ColorCanvas的畫素周圍建立一個矩形，並建立一個具有此矩形尺寸的點陣圖，該點陣圖用於雙緩衝圖形以避免閃爍。您可以通過ClipRect獲得畫布的寬度/高度。
# 13.1. 屬性
- TAbBMask元件主要屬性
| 屬性 | 功能說明 |
|---|---|
| ColorShape | 負責元件的形狀，具有此顏色的圖片的所有區域均不包括在元件形狀中 |
| Picture | 形狀圖形 |
| ColorCanvas | 負責元件的形狀，具有此顏色的圖片的所有區域都包含在自定義畫布中 |
# 13.2. 事件
| 事件 | 何時觸發 |
|---|---|
| OnChange | 當自定義畫布部件需要重繪時觸發該事件 |