BannerTextProvider 是 Syncfusion WinForms 的扩展器控件,用于在编辑器控件为空时显示水印/占位提示文本,用户交互后自动隐藏。
用途:为 TextBoxExt、ComboBoxAdv、CurrencyTextBox 等编辑器控件添加水印、占位符或提示文本。
主要能力:支持 FocusMode(控件获得焦点时文本消失)和 EditMode(控件有内容时文本才消失)两种模式;可设置文字颜色、字体和可见性;可同时作用于 14 种以上编辑器控件;支持通过窗体设计器或代码添加。
使用方式:创建 BannerTextProvider 实例(通常在 Form 设计器或 Form_Load 中),再创建 BannerTextInfo 设置 Text、Visible、Font、Color、Mode,最后调用 bannerTextProvider.SetBannerText(控件, bannerInfo) 绑定。示例:BannerTextProvider bannerTextProvider = new BannerTextProvider(this.components); 然后 bannerTextProvider.SetBannerText(textBox, new BannerTextInfo("Type here...", true));。可通过循环为多个控件批量设置占位文本。
适用场景:需要表单输入提示、临时引导文本或持久水印的 WinForms 应用。
限制:仅支持指定的 14 种以上控件;需引用 Syncfusion.Shared.Base 程序集;设置前应先清空控件默认 Text 属性;其他平台、收费与价格信息暂未提供。