下拉列表控件更多...

类 FineUIPro.DropDownList 继承关系图:

Public 成员函数
	DropDownList ()
	构造函数

override void	DataBind ()
	绑定到数据源

bool	LoadPostData (string postDataKey, System.Collections.Specialized.NameValueCollection postCollection)
	处理回发数据

void	RaisePostDataChangedEvent ()
	触发回发数据改变事件

virtual void	RaisePostBackEvent (string eventArgument)
	处理回发事件

void	ClearSelection ()
	清空选中项

string	GetClearSelectionReference ()
	获取清空选中项的客户端脚本

Public 成员函数继承自 FineUIPro.TextField
	TextField ()
	构造函数

Public 成员函数继承自 FineUIPro.Field
	Field ()
	构造函数

void	Reset ()
	重置此字段的值（比如用来清空FileUpload的内容）

virtual string	GetResetReference ()
	获取重置此字段的客户端脚本

virtual string	GetValueReference ()
	获取此字段值的客户端脚本（注意返回的脚本不带结束分号）

void	MarkInvalid (string message)
	设置字段验证失败的提示信息

void	ClearInvalid ()
	清除验证失败的提示信息

string	GetMarkInvalidReference (string message)
	获取字段验证失败提示信息的客户端脚本

string	GetClearInvalidReference ()
	获取清除验证失败提示信息的客户端脚本

new void	Focus ()
	使控件获得焦点

void	Focus (bool selectText)
	使控件获得焦点，并选中控件中的文本内容

void	Focus (bool selectText, int delayMilliseconds)
	使控件获得焦点，并选中控件中的文本内容

string	GetFocusReference ()
	获得使控件获得焦点的脚本

string	GetFocusReference (bool selectText)
	获得使控件获得焦点，并选中控件中的文本内容的脚本

string	GetFocusReference (bool selectText, int delayMilliseconds)
	获得使控件获得焦点，并选中控件中的文本内容的脚本

Public 成员函数继承自 FineUIPro.BoxComponent
	BoxComponent ()
	构造函数

Public 成员函数继承自 FineUIPro.Component
	Component ()
	构造函数

Public 成员函数继承自 FineUIPro.ControlBase
	ControlBase ()
	构造函数

override void	RenderControl (HtmlTextWriter writer)
	重载 RenderControl，为了向子控件公开 RenderBeginTag 和 RenderEndTag 两个方法

bool	PropertyModified (string propertyName)
	回发过程中此属性是否被改变如果是客户端可以改变的属性，仅在服务器端改变时才返回 true，（如果仅是客户端改变，则返回 false，因为客户端改变的属性不需要再输出相应的 JavaScript 脚本）

bool	PropertyModified (params string[] propertyNames)
	回发过程中这些属性是否被改变只要任何属性被改变，就返回 true

void	RecoverPropertiesFromJObject (JObject state)
	从JObject恢复控件的属性

JObject	ConvertPropertiesToJObject (List< string > propertyList)
	将控件的属性列表转化为JObject对象

string	GetPostBackEventReference ()
	获取回发页面的客户端脚本（比如：__doPostBack('btnChangeEnable','');)

string	GetPostBackEventReference (string eventArgument)
	获取回发页面的客户端脚本（比如：__doPostBack('btnChangeEnable','true');)

string	GetPostBackEventReference (string eventArgument, bool enableAjax)
	获取回发页面的客户端脚本（比如：__doPostBack('btnChangeEnable','true');)

string	GetPostBackEventReference (string eventArgument, bool enableAjax, bool persistOriginal)
	获取回发页面的客户端脚本（比如：__doPostBack('btnChangeEnable','true');)

属性
virtual string	EmptyText `[get, set]`
	文本框为空时显示的文本

string	Text `[get, set]`
	[AJAX属性]用户输入的文本（只有在单选、允许编辑、不强制选择的情况下才有效）

int	SelectedIndex `[get, set]`
	[AJAX属性]选中项的索引

string	SelectedText `[get]`
	选中项的文本

ListItem	SelectedItem `[get]`
	选中项

string	SelectedValue `[get, set]`
	[AJAX属性]选中项的值

string[]	SelectedValueArray `[get, set]`
	[AJAX属性]选中项的值

int[]	SelectedIndexArray `[get, set]`
	[AJAX属性]选中项的索引

ListItem[]	SelectedItemArray `[get]`
	选中项

string	FilterFunction `[get, set]`
	自定义过滤器函数（仅在EnableEdit=true时有效）

bool	EnableClickAction `[get, set]`
	点击输入框是否触发默认行为

bool	ChangeOnDblClick `[get, set]`
	双击改变选中项（配合参数EnableClickAction=false使用）

bool	TopSpaceFirst `[get, set]`
	优先使用上部空间显示弹出框

bool	MatchFieldWidth `[get, set]`
	下拉列表和字段的宽度相匹配

bool	EnableCheckBoxSelect `[get, set]`
	启用多选框

bool	AutoSelectFirstItem `[get, set]`
	如果未定义选中项，则自动选中第一个子项（默认为true）

bool	EnableMultiSelect `[get, set]`
	是否可以选择多项

string	MultiSelectSeparator `[get, set]`
	选择多项的分隔符

bool	ForceSelection `[get, set]`
	是否强制选中下拉列表中的项（多选时此属性无效）

bool	AutoShowClearIcon `[get, set]`
	自动显示清空图标

bool	EnableClearIconClickEvent `[get, set]`
	启用清空图标的回发事件

bool	EnableEdit `[get, set]`
	是否可编辑，以便在录入时自动过滤下拉框中的值

bool	EnableGroup `[get, set]`
	是否启用分组显示

bool	EnableSimulateTree `[get, set]`
	是否启用模拟树显示

string	DataSimulateTreeLevelField `[get, set]`
	模拟树显示时指示所在层次的数据字段

string	DataEnableSelectField `[get, set]`
	是否可选择的字段

bool	AutoPostBack `[get, set]`
	是否自动回发

string[]	DataDisplayFields `[get, set]`
	列表项显示字段名称列表

string	DataDisplayFormatString `[get, set]`
	列表项显示字段的格式化字符串

string	DataGroupField `[get, set]`
	分组字段

string	DataGroupFormatString `[get, set]`
	分组的格式化字符串

string	DataTextField `[get, set]`
	文本字段

string	DataTextFormatString `[get, set]`
	文本的格式化字符串

string	DataValueField `[get, set]`
	值字段

object	DataSource `[get, set]`
	数据源

JArray	F_Items `[get, set]`
	保存的列表项数据（内部使用）

virtual ListItemCollection	Items `[get]`
	列表项集合

EventHandler	SelectedIndexChanged
	选中项改变事件（需要启用AutoPostBack）

EventHandler< ListItemEventArgs >	ItemDataBound
	列表项绑定后事件

EventHandler< ListPreItemEventArgs >	PreItemDataBound
	列表项绑定前事件

virtual EventHandler	ClearIconClick
	清空图标的回发事件（需要启用AutoShowClearIcon和EnableClearIconClick）

bool	IsUserInput `[get]`
	是否为用户自行输入值

属性继承自 FineUIPro.TextField
bool	AutoComplete `[get, set]`
	启用表单字段的自动完成功能

bool	EnablePrefix `[get, set]`
	启用前缀文本

string	Prefix `[get, set]`
	前缀文本

bool	EnableSuffix `[get, set]`
	启用后缀文本

string	Suffix `[get, set]`
	后缀文本

bool	ValidateForValue `[get, set]`
	对值进行验证（MinLength, MaxLength, Required, Regex, RegexPattern）

bool	Required `[get, set]`
	是否必填项（对显示文本进行验证）

string	RequiredMessage `[get, set]`
	为空时提示信息

int?	MaxLength `[get, set]`
	最大长度（对显示文本进行验证）

string	MaxLengthMessage `[get, set]`
	超过最大长度时提示信息

int?	MinLength `[get, set]`
	最小长度（对显示文本进行验证）

string	MinLengthMessage `[get, set]`
	少于最小长度时提示信息

RegexPattern	RegexPattern `[get, set]`
	正则表达式常用类型（对显示文本进行验证）

string	Regex `[get, set]`
	正则表达式（对显示文本进行验证）

string	RegexMessage `[get, set]`
	不满足正则表达式时提示信息

bool	RegexIgnoreCase `[get, set]`
	正则表达式是否忽略大小写

string	CompareControl `[get, set]`
	需要比较的控件（对值进行验证）

string	CompareValue `[get, set]`
	需要比较的值（对值进行验证）

Operator	CompareOperator `[get, set]`
	比较操作符

CompareType	CompareType `[get, set]`
	比较的类型

string	CompareMessage `[get, set]`
	不满足比较条件时提示信息

virtual string	NextFocusControl `[get, set]`
	响应回车键获得焦点的控件

virtual string	NextClickControl `[get, set]`
	响应回车键自动点击的控件

属性继承自 FineUIPro.Field
string	ValidatorFunction `[get, set]`
	客户端验证函数（JavaScript函数）

bool	ShowLabel `[get, set]`
	是否显示标签

bool	ShowEmptyLabel `[get, set]`
	是否显示空白的标签

string	Label `[get, set]`
	[AJAX属性]标签文本

bool	ShowRedStar `[get, set]`
	用来标识必填项的红色星号

virtual bool	Readonly `[get, set]`
	[AJAX属性]表单控件的只读状态

virtual ? short	TabIndex `[get, set]`
	Tab按键的跳转顺序

string	LabelSeparator `[get, set]`
	表单中字段与标签的分隔符

LabelAlign	LabelAlign `[get, set]`
	表单中标签的位置

MessageTarget	MessageTarget `[get, set]`
	无效字段提示消息的位置

Unit?	OffsetRight `[get, set]`
	距离右侧边界的宽度（相当于设置CSS样式margin-right）

Unit?	LabelWidth `[get, set]`
	标签的宽度

bool	EnableValidateTrim `[get, set]`
	验证时去除文本的前后空白字符

属性继承自 FineUIPro.BoxComponent
Unit	Width `[get, set]`
	宽度

Unit	Height `[get, set]`
	高度

string	AnchorValue `[get, set]`
	锚点值（当父容器的Layout=Anchor时有效）

string	ColumnWidth `[get, set]`
	列的宽度（当父容器的Layout=Column时有效）

Unit	AbsoluteX `[get, set]`
	绝对定位的X坐标（当父容器的Layout=Absolute时有效）

Unit	AbsoluteY `[get, set]`
	绝对定位的Y坐标（当父容器的Layout=Absolute时有效）

int	TableConfigColumns `[get, set]`
	表格列数（当父容器的Layout=Table时有效）

int	TableRowspan `[get, set]`
	表格合并行（当父容器的Layout=Table时有效）

int	TableColspan `[get, set]`
	表格合并列（当父容器的Layout=Table时有效）

BoxLayoutAlign	BoxConfigAlign `[get, set]`
	控制子控件的位置（当本容器的Layout=VBox或者HBox时有效）

BoxLayoutPosition	BoxConfigPosition `[get, set]`
	控制子控件的位置（当本容器的Layout=VBox或者HBox时有效）

string	BoxConfigPadding `[get, set]`
	内边距（当本容器的Layout=VBox或者HBox时有效）

string	BoxConfigChildMargin `[get, set]`
	子控件的外边距（当本容器的Layout=VBox或者HBox时有效）

string	BoxConfigLastChildMargin `[get, set]`
	最后一个子控件的外边距（当本容器的Layout=VBox或者HBox时有效）

int	BoxFlex `[get, set]`
	控制子控件的尺寸（当父容器的Layout=VBox或者HBox时有效）

Unit	BlockConfigSpace `[get, set]`
	块间距（当本容器的Layout=Block时有效）

int	BlockConfigBlockCount `[get, set]`
	自定义总块数（当本容器的Layout=Block时有效）

int	Block `[get, set]`
	块大小，超小屏幕（当父容器的Layout=Block时有效）

int	BlockSM `[get, set]`
	块大小，小屏幕（当父容器的Layout=Block时有效）

int	BlockMD `[get, set]`
	块大小，中等屏幕（当父容器的Layout=Block时有效）

int	BlockLG `[get, set]`
	块大小，大屏幕（当父容器的Layout=Block时有效）

bool	RegionSplit `[get, set]`
	是否启用区域分隔条

bool	RegionSplitDraggable `[get, set]`
	区域分隔条是否可拖动

bool	RegionSplitIcon `[get, set]`
	是否显示区域分隔条图标

Unit	RegionSplitWidth `[get, set]`
	区域分隔条的宽度

bool	RegionSplitTransparent `[get, set]`
	区域分隔条是否透明

string	RegionPercent `[get, set]`
	区域的百分比尺寸（当父容器的Layout=Region时有效）

bool	RegionSplitHeaderClass `[get, set]`
	是否为区域分隔条使用表头样式

Position	RegionPosition `[get, set]`
	区域所在的位置

属性继承自 FineUIPro.Component
virtual ? bool	EncodeText `[get, set]`

virtual bool	FocusOnPageLoad `[get, set]`
	页面加载后立即获得焦点

virtual string	CssClass `[get, set]`
	[AJAX属性]控件样式类名

virtual string	CssStyle `[get, set]`
	[AJAX属性]控件样式

string	Margin `[get, set]`
	外边距

Unit	MarginRight `[get, set]`
	右侧外边距

Unit	MarginLeft `[get, set]`
	左侧外边距

Unit	MarginTop `[get, set]`
	顶部外边距

Unit	MarginBottom `[get, set]`
	底部外边距

属性继承自 FineUIPro.ControlBase
override bool	EnableViewState `[get]`
	不支持此属性

override string	ClientID `[get]`
	控件的客户端ID（比如：RegionPanel1_Button1）

string	WrapperID `[get]`
	控件外部容器的客户端ID（比如：Button1_wrapper）

string	ProductName `[get]`
	产品名称

virtual string	ProductVersion `[get]`
	产品版本

virtual JObject	Attributes `[get, set]`
	HTML标签属性

string	AttributeDataTag `[get, set]`
	HTML标签属性（data-tag）

override string	ID `[get, set]`
	控件ID

virtual bool	Enabled `[get, set]`
	[AJAX属性]是否可用

bool	RenderToClient `[get, set]`
	指示控件是否被渲染出来（显示隐藏控件，请使用Hidden属性）

override bool	Visible `[get]`
	是否向前台输出控件（避免使用此属性！！如果要显示隐藏控件，请使用Hidden属性）

virtual bool	Hidden `[get, set]`
	[AJAX属性]是否隐藏控件

virtual HideMode	HideMode `[get, set]`
	隐藏模式

virtual bool	EnableAjax `[get, set]`
	是否启用AJAX

bool	EnableAjaxLoading `[get, set]`
	是否启用Ajax正在加载提示

AjaxLoadingType	AjaxLoadingType `[get, set]`
	Ajax正在加载提示的类型

string	AjaxLoadingText `[get, set]`
	AJAX提示的文本

string	AjaxLoadingMaskText `[get, set]`
	Mask类型的AJAX提示文本

bool	ShowAjaxLoadingMaskText `[get, set]`
	是否显示Mask类型的提示文本

bool	IsFineUIAjaxPostBack `[get]`
	是否处于FineUI的AJAX回发过程

bool	IsFineUIProAjaxPostBack `[get]`
	是否处于FineUI的AJAX回发过程

virtual ListenerCollection	Listeners `[get]`
	客户端事件列表

详细描述

下拉列表控件

构造及析构函数说明

◆ DropDownList()

FineUIPro.DropDownList.DropDownList ( )

构造函数

成员函数说明

◆ ClearSelection()

void FineUIPro.DropDownList.ClearSelection ( )

清空选中项

◆ DataBind()

override void FineUIPro.DropDownList.DataBind ( )

绑定到数据源

◆ GetClearSelectionReference()

string FineUIPro.DropDownList.GetClearSelectionReference ( )

获取清空选中项的客户端脚本

返回: 客户端脚本

◆ LoadPostData()

bool FineUIPro.DropDownList.LoadPostData	(	string	postDataKey,
		System::Collections::Specialized::NameValueCollection	postCollection
	)

处理回发数据

参数

postDataKey	回发数据键
postCollection	回发数据集

返回: 回发数据是否改变

◆ RaisePostBackEvent()

virtual void FineUIPro.DropDownList.RaisePostBackEvent ( string eventArgument )

virtual

处理回发事件

参数

eventArgument 事件参数

◆ RaisePostDataChangedEvent()

void FineUIPro.DropDownList.RaisePostDataChangedEvent ( )

触发回发数据改变事件

属性说明

◆ AutoPostBack

bool FineUIPro.DropDownList.AutoPostBack

getset

是否自动回发

◆ AutoSelectFirstItem

bool FineUIPro.DropDownList.AutoSelectFirstItem

getset

如果未定义选中项，则自动选中第一个子项（默认为true）

◆ AutoShowClearIcon

bool FineUIPro.DropDownList.AutoShowClearIcon

getset

自动显示清空图标

◆ ChangeOnDblClick

bool FineUIPro.DropDownList.ChangeOnDblClick

getset

双击改变选中项（配合参数EnableClickAction=false使用）

◆ ClearIconClick

virtual EventHandler FineUIPro.DropDownList.ClearIconClick

addremove

清空图标的回发事件（需要启用AutoShowClearIcon和EnableClearIconClick）

◆ DataDisplayFields

string [] FineUIPro.DropDownList.DataDisplayFields

getset

列表项显示字段名称列表

◆ DataDisplayFormatString

string FineUIPro.DropDownList.DataDisplayFormatString

getset

列表项显示字段的格式化字符串

◆ DataEnableSelectField

string FineUIPro.DropDownList.DataEnableSelectField

getset

是否可选择的字段

◆ DataGroupField

string FineUIPro.DropDownList.DataGroupField

getset

分组字段

◆ DataGroupFormatString

string FineUIPro.DropDownList.DataGroupFormatString

getset

分组的格式化字符串

◆ DataSimulateTreeLevelField

string FineUIPro.DropDownList.DataSimulateTreeLevelField

getset

模拟树显示时指示所在层次的数据字段

◆ DataSource

object FineUIPro.DropDownList.DataSource

getset

数据源

◆ DataTextField

string FineUIPro.DropDownList.DataTextField

getset

文本字段

◆ DataTextFormatString

string FineUIPro.DropDownList.DataTextFormatString

getset

文本的格式化字符串

◆ DataValueField

string FineUIPro.DropDownList.DataValueField

getset

值字段

◆ EmptyText

virtual string FineUIPro.DropDownList.EmptyText

getset

文本框为空时显示的文本

◆ EnableCheckBoxSelect

bool FineUIPro.DropDownList.EnableCheckBoxSelect

getset

启用多选框

◆ EnableClearIconClickEvent

bool FineUIPro.DropDownList.EnableClearIconClickEvent

getset

启用清空图标的回发事件

◆ EnableClickAction

bool FineUIPro.DropDownList.EnableClickAction

getset

点击输入框是否触发默认行为

◆ EnableEdit

bool FineUIPro.DropDownList.EnableEdit

getset

是否可编辑，以便在录入时自动过滤下拉框中的值

◆ EnableGroup

bool FineUIPro.DropDownList.EnableGroup

getset

是否启用分组显示

◆ EnableMultiSelect

bool FineUIPro.DropDownList.EnableMultiSelect

getset

是否可以选择多项

◆ EnableSimulateTree

bool FineUIPro.DropDownList.EnableSimulateTree

getset

是否启用模拟树显示

◆ F_Items

JArray FineUIPro.DropDownList.F_Items

getset

保存的列表项数据（内部使用）

◆ FilterFunction

string FineUIPro.DropDownList.FilterFunction

getset

自定义过滤器函数（仅在EnableEdit=true时有效）

◆ ForceSelection

bool FineUIPro.DropDownList.ForceSelection

getset

是否强制选中下拉列表中的项（多选时此属性无效）

◆ IsUserInput

bool FineUIPro.DropDownList.IsUserInput

get

是否为用户自行输入值

◆ ItemDataBound

EventHandler<ListItemEventArgs> FineUIPro.DropDownList.ItemDataBound

addremove

列表项绑定后事件

◆ Items

virtual ListItemCollection FineUIPro.DropDownList.Items

get

列表项集合

◆ MatchFieldWidth

bool FineUIPro.DropDownList.MatchFieldWidth

getset

下拉列表和字段的宽度相匹配

◆ MultiSelectSeparator

string FineUIPro.DropDownList.MultiSelectSeparator

getset

选择多项的分隔符

◆ PreItemDataBound

EventHandler<ListPreItemEventArgs> FineUIPro.DropDownList.PreItemDataBound

addremove

列表项绑定前事件

◆ SelectedIndex

int FineUIPro.DropDownList.SelectedIndex

getset

[AJAX属性]选中项的索引

◆ SelectedIndexArray

int [] FineUIPro.DropDownList.SelectedIndexArray

getset

[AJAX属性]选中项的索引

◆ SelectedIndexChanged

EventHandler FineUIPro.DropDownList.SelectedIndexChanged

addremove

选中项改变事件（需要启用AutoPostBack）

◆ SelectedItem

ListItem FineUIPro.DropDownList.SelectedItem

get

选中项

◆ SelectedItemArray

ListItem [] FineUIPro.DropDownList.SelectedItemArray

get

选中项

◆ SelectedText

string FineUIPro.DropDownList.SelectedText

get

选中项的文本

◆ SelectedValue

string FineUIPro.DropDownList.SelectedValue

getset

[AJAX属性]选中项的值

◆ SelectedValueArray

string [] FineUIPro.DropDownList.SelectedValueArray

getset

[AJAX属性]选中项的值

◆ Text

string FineUIPro.DropDownList.Text

getset

[AJAX属性]用户输入的文本（只有在单选、允许编辑、不强制选择的情况下才有效）

◆ TopSpaceFirst

bool FineUIPro.DropDownList.TopSpaceFirst

getset

优先使用上部空间显示弹出框

该类的文档由以下文件生成:

DropDownList.cs

Public 成员函数

属性

详细描述

构造及析构函数说明

◆ DropDownList()

成员函数说明

◆ ClearSelection()

◆ DataBind()

◆ GetClearSelectionReference()

◆ LoadPostData()

◆ RaisePostBackEvent()

◆ RaisePostDataChangedEvent()

属性说明

◆ AutoPostBack

◆ AutoSelectFirstItem

◆ AutoShowClearIcon

◆ ChangeOnDblClick

◆ ClearIconClick

◆ DataDisplayFields

◆ DataDisplayFormatString

◆ DataEnableSelectField

◆ DataGroupField

◆ DataGroupFormatString

◆ DataSimulateTreeLevelField

◆ DataSource

◆ DataTextField

◆ DataTextFormatString

◆ DataValueField

◆ EmptyText

◆ EnableCheckBoxSelect

◆ EnableClearIconClickEvent

◆ EnableClickAction

◆ EnableEdit

◆ EnableGroup

◆ EnableMultiSelect

◆ EnableSimulateTree

◆ F_Items

◆ FilterFunction

◆ ForceSelection

◆ IsUserInput

◆ ItemDataBound

◆ Items

◆ MatchFieldWidth

◆ MultiSelectSeparator

◆ PreItemDataBound

◆ SelectedIndex

◆ SelectedIndexArray

◆ SelectedIndexChanged

◆ SelectedItem

◆ SelectedItemArray

◆ SelectedText

◆ SelectedValue

◆ SelectedValueArray

◆ Text

◆ TopSpaceFirst