-->ColdFusion 初级教程-->网格数据选择选项

ColdFusion

后页 前页
目录
北极星书库
网格数据选择选项


你可以控制用户如何与你的网格控件相交互,你可以限制一个用户只能浏览网格中的数据。你可以在SELECTMOOE属性中指定几个不同的选择选项。


· Single——限制用户只能选择网格控件的一个单元格。


· Column——当用户选择一个单元格时,包含此单元格的一列数据均被选取。


· Row——当用户选择一个单元格时,包含此单元格的一行数据均被选取。


· Browse——用户不能选择单元格,只能浏览数据。


· Edit——用户可以编辑单元格数据。


选择模式与form变量


根据SELECTMODE属性的不同取值,网格数据被提交为不同形式的form变量:


· 当SELECTMODE=“single”时,返回的变量为grid-name.selectedname及被选中的值。


· 当SELECTMODE=“Column”时,返回的是被选列的用逗号隔开的所有字段值。


· 当SELECTMODE=“Row”时,返回的变量为gridname.Columnl_name和grid_ name.Column2_name等,以及相应的被选字段值。


· 当SELECTMODE=“Browse”时,没有返回数据。


· 当SELECTMODE=“Edit”时,如果单元格数据被修改,则创建并返回三个一维数组。


使用URL属性


当在单元格中使用URL时,SELECTMODE属性的值决定了该链接是限制于一个单元格,还是扩展到该单元格所在的行或列。当用户点击一个链接时,一个CFGRIDKEY变量被追加到URL后面,其格式为:


http://myserver.com?CFGRIDKEY=selection


Selection的值由SELECTMODE属性的值决定:


· 当SELECTMODE=“single”时,Selection即用户选中的单元格的值。


· 当SELECTMODE=“ROW”时,Selection是被选单元格所在行的各单元格的值,用逗号将各单元格的值隔开,起始于该行的第一个单元格。


· 当SELECTMODE=“Column”时,Selection是被选单元格所在列的各单元格的值,起始于该列的第一个单元格,各单元格的值用逗号隔开。


HREF属性


你可以用HREF属性将一个超链接与被选中的行或单元格相关联。ColdFusion将HREF属性的值理解为一个存储链接文本的查询字段或链接文本自身。HREF的链接目标仅限于当前的应用程序文件。


在下面的这段代码中,两个CFGRIDCOLUMN使用了HREF属性,由于HREF属性引用了另一个CFGRIDCOLUMN,从而每一行都链接一个不同的URL,此URL由被选中行的dept_url字段的值决定。注意最后一个CFGRIDCOLUMN是一个隐藏字段,用于隐藏dept_url字段的值。


<CFFORM NAME="GridForm"


ACTION="catch_grid10.cfm"


TARGET="Lower">


<CFGRID NAME="grid_ten"


HEIGHT=170


WIDTH=400


HSPACE=10


VSPACE=6


ALIGN="Right"


SELECTMODE="Row"


ROWHEADERS="Yes"


COLHEADERS="Yes"


QUERY="DeptList"


GRIDDATAALIGN="Left"


HIGHLIGHTHREF="No"


APPENDKEY="No"


SORT="Yes">


<CFGRIDCOLUMN NAME="dept_id"


HEADER="Department"


WIDTH=80


ITALIC="No"


HEADERALIGN="Center"


HEADERITALIC="No"


HEADERBOLD="Yes"


HREF="dept_url"


TYPE="Numeric">


<CFGRIDCOLUMN NAME="dept_name"


HEADER="Name"


ITALIC="No"


HEADERALIGN="Center"


HEADERITALIC="No"


HEADERBOLD="Yes"


HREF="dept_url">


<CFGRIDCOLUMN NAME="dept_url"


DISPLAY="No">


</CFGRID>


<INPUT TYPE="Submit" VALUE="Submit"> <BR>


</CFFORM>


CFGRIDKEY的APPENDKEY属性


当用户选择了网格数据并提交表单时,CFGRIDKEY变量即被追加到URL后面,传递给ACTION属性所指的文件。你可以通过设置APPENDKEY=“NO”来禁止这个URL变量。


后页
前页
目录
北极星书库