目录
北极星书库
你可以控制用户如何与你的网格控件相交互,你可以限制一个用户只能浏览网格中的数据。你可以在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变量。
前页
目录
北极星书库