NumPad 组件 — sgcHTML | eSeGeCe

NumPad

TsgcHTMLComponent_NumPad — 一个专为销售点录入打造的触控数字/货币键盘,带有快捷金额按钮,以及一个始终提交与地区设置无关的数字的隐藏字段,适用于 Delphi、C++ Builder 和 .NET。

TsgcHTMLComponent_NumPad

设置 ModeDecimalPlaces,然后读取 HTML 属性;键盘会在 FieldName 下提交像 12.50 这样的数字,绝不会提交按地区格式化的 12,50

组件类

TsgcHTMLComponent_NumPad

渲染为

计算器风格键盘 + 显示屏 + 内联脚本

语言

Delphi, C++ Builder, .NET

在每个浏览器中都读取一致的数字

该组件写入标记和自身脚本中的每一个数字,都经过与地区设置无关的格式化程序处理,绝不会经过遵循浏览器区域设置的例程。

uses
  sgcHTML_Component_NumPad;

var
  oPad: TsgcHTMLComponent_NumPad;
begin
  oPad := TsgcHTMLComponent_NumPad.Create(nil);
  try
    oPad.PadID := 'till_amount';
    oPad.FieldName := 'amount';
    oPad.Mode := npCurrency;
    oPad.CurrencySymbol := '$';
    oPad.DecimalPlaces := 2;
    oPad.QuickAmounts.CommaText := '5,10,20,50';   // tender shortcut buttons

    WebModule.Response := oPad.HTML;   // display + calculator-style keys + quick amounts
  finally
    oPad.Free;
  end;
end;
// includes: sgcHTML_Component_NumPad.hpp

TsgcHTMLComponent_NumPad *oPad = new TsgcHTMLComponent_NumPad(NULL);
try
{
  oPad->PadID = "till_amount";
  oPad->FieldName = "amount";
  oPad->Mode = npCurrency;
  oPad->CurrencySymbol = "$";
  oPad->DecimalPlaces = 2;
  oPad->QuickAmounts->CommaText = "5,10,20,50";

  String html = oPad->HTML;   // display + calculator-style keys + quick amounts
}
__finally
{
  delete oPad;
}
using esegece.sgcWebSockets;

var pad = new TsgcHTMLComponent_NumPad();
pad.PadID = "till_amount";
pad.FieldName = "amount";
pad.Mode = npCurrency;
pad.CurrencySymbol = "$";
pad.DecimalPlaces = 2;
pad.QuickAmounts.CommaText = "5,10,20,50";

string html = pad.HTML;   // display + calculator-style keys + quick amounts

关键属性与方法

您最常使用的成员。

Mode

npInteger(完全没有小数点键)、npDecimal(默认)或 npCurrency(前缀为 CurrencySymbol)。

DecimalPlaces

默认值为 2,限制在 0–6 之间。键盘显示或提交的每个值都会补齐/四舍五入到这一位数的小数。

QuickAmounts

一个 TStrings,保存收款快捷数字;每个条目都会被解析并通过同一个与地区设置无关的格式化程序重新输出,因此格式错误的条目会被丢弃,而不会出现在页面上。

FieldName

标准化后的值提交所用的隐藏字段,默认值为 amount

MaxValue

0(默认)表示没有上限;大于 0 时,会拒绝任何会超过该上限的按键输入。

WSSend / Action

设置其中任一项后,Enter 键会变为真正的提交按钮,通过 sgcHTMX WebSocket 桥推送或 POST 到 Action;始终会触发一个 sgc:numpad DOM 事件。

继续探索

在线帮助此组件的完整 API 参考和使用指南。
所有 sgcHTML 组件浏览 80 多个组件的完整功能矩阵。
下载免费试用版30 天试用版附带 60.HTML 演示项目。
价格Single、Team 和 Site 授权,均含完整源代码。
超值之选:All-AccesseSeGeCe 全部产品,含高级支持,每年 €1,059 起。
查看 All-Access 价格

准备好开始了吗?

下载免费试用版,开始在 Delphi、C++ Builder 和 .NET 中构建 Web 界面。