下拉编辑器
下拉编辑器是使用弹出窗口的控件。 弹出窗口提供对编辑器细节数据 (供选择的列表项、备注数据、图像等) 的访问。 XtraEditors 库中包含的下拉编辑器在下面列出:
- CheckedComboBoxEdit
此编辑器在其下拉窗口中显示复选项列表。
- ColorEdit
允许选择颜色。 其弹出窗口显示的标签页面包括 Custom(自定义)、Web(网页) 和 System(系统) 调色板。
- ComboBoxEdit
允许从下拉列表中选择预定义项。 要获得更多信息,请参阅 组合框编辑器 主题。
- DateEdit
允许编辑器日期值。 其下拉窗口显示了一个日历,支持公元 0001 年 1 月 1 日至 9999 年 12 月 31 日。
- FontEdit
在下拉窗口中显示字体。
- ImageComboBoxEdit
允许从下拉列表中选择预定义项,并且支持列表项图像。 要获得更多信息,请参阅 组合框编辑器 主题。
- ImageEdit
允许在弹出窗口中显示图像。 要获得更多信息,请参阅 BLOB 编辑器 主题。
- LookUpEdit
允许从下拉多列数据感知列表中选择项。
- MemoExEdit
允许在弹出窗口中编辑备注数据。 要获得更多信息,请参阅 BLOB 编辑器 主题。
- MRUEdit
允许从下拉列表中选择最近输入的项。 要获得更多信息,请参阅 组合框编辑器 主题。
- PopupContainerEdit
允许在弹出窗口中显示控件。 要获得更多信息,请参阅 弹出式容器编辑器 主题。
下拉编辑器的公共功能
所有下拉编辑器的公共属性、方法和事件都由 PopupBaseEdit 和 RepositoryItemPopupBase 类提供,它们分别是编辑器和 repository 项类的基础类。
单击索引号被指派到 RepositoryItemPopupBase.ActionButtonIndex 属性的编辑器按钮可以激活弹出窗口。 最终用户也可以按下 ALT+向下键,或者按下由 RepositoryItemPopupBase.CloseUpKey 属性指定的快捷键。 要在代码中打开弹出窗口,则调用 PopupBaseEdit.ShowPopup 方法。 在每种情况下,在实际打开弹出窗口之前,PopupBaseEdit.QueryPopUp 事件都会被触发。 可以在其事件处理程序中阻止弹出窗口出现。
最终用户可以通过接受选择或取消选择来关闭下拉窗口。 同样地,您可以使用两种方法来关闭下拉窗口: PopupBaseEdit.ClosePopup 和 PopupBaseEdit.CancelPopup 方法分别接受或取消修改。
在关闭弹出窗口时,PopupBaseEdit.QueryCloseUp 和 PopupBaseEdit.CloseUp 事件被触发。 第一个事件可以用于阻止关闭窗口,避免用户把焦点从控件移开。 在所有情况下,PopupBaseEdit.CloseUp 事件都发生,仅用于提供窗口已经被关闭的消息。