CFGRID

"-->
 <cfgrid name = "name"          height = "integer"          width = "integer"          autoWidth = "Yes" or "No"          vSpace = "integer"          hSpace = "integer"          align = "value"          query = "query_name"          insert = "Yes" or "No"          delete = "Yes" or "No"          sort = "Yes" or "No"          font = "column_font"          fontSize = "size"          italic = "Yes" or "No"          bold = "Yes" or "No"          textColor = "web color"          href="URL"          hrefKey = "column_name"          target = "URL_target"          appendKey = "Yes" or "No"          highlightHref = "Yes" or "No"          onValidate = "javascript_function"          onError = "text"          gridDataAlign = "position"          gridLines = "Yes" or "No"          rowHeight = "pixels"          rowHeaders = "Yes" or "No"          rowHeaderAlign = "position"          rowHeaderFont = "font_name"          rowHeaderFontSize = "size"          rowHeaderItalic = "Yes" or "No"          rowHeaderBold = "Yes" or "No"          rowHeaderTextColor = "web color"          rowHeaderWidth = "col_width"          colHeaders = "Yes" or "No"          colHeaderAlign = "position"          colHeaderFont = "font_name"          colHeaderFontSize = "size"          colHeaderItalic = "Yes" or "No"          colHeaderBold = "Yes" or "No"          colHeaderTextColor = "web color"          bgColor = "web color"          selectColor = "web color"          selectMode = "mode"          maxRows = "number"          notSupported = "text"          pictureBar = "Yes" or "No"          insertButton = "text"          deleteButton = "text"          sortAscendingButton = "text"          sortDescendingButton = "text">  </cfgrid> 

Description

Used within the CFFORM tag and enable grid control of table data in a form. To specify column data, use the CFGRIDCOLUMN tag. To render a grid, you must specify a value for one of these: CFGRIDCOLUMN width attribute, CFGRID coheaders attribute, CFGRID autowidth attribute.

Attributes

name (Required)

Name of the grid.

height (Optional)

Height of the grid.

width (Optional)

Width of the grid.

autoWidth (Optional)

Default: No

  • Yes. Sets column widths so that all columns display within grid width.

  • No. Sets columns to equal widths.

vSpace (Optional)

Vertical space above and below the grid.

hSpace (Optional)

Horizontal space to left and right of the grid.

align (Optional)

Alignment can be any of the following values: Top, Left, Bottom, Baseline, Texttop, Absbottom, Middle, Absmiddle, and Right.

query (Optional)

Name of a query associated with the grid.

insert (Optional)

Default: No. If Yes, user can insert row data in the grid. Only works if selectmode="edit".

delete (Optional)

Default: No. If Yes, user can delete row data from the grid. Only works if selectmode="edit".

sort (Optional)

Default: No. The sort button performs simple text sorts on a column, which allows the user to sort columns by clicking the column title. If Yes, sort buttons display on the grid.

font (Optional)

Sets the font of the data in the grid.

fontSize (Optional)

Size of text in the grid.

italic (Optional)

Default: No. If Yes, displays text in italics.

bold (Optional)

Default: No. If Yes, displays text in bold.

textColor (Optional)

Default: black. Color of text as hex value or web color.

href (Optional)

If a grid is associated with a query, this is the URL to associate with a grid item or query column.

hrefKey (Optional)

If grid uses a query, this sets the name of a query column as a key.

target (Optional)

The name of a fame to open the associated a URL.

appendKey (Optional)

Default: Yes, which appends a query value to the URL and passes it to the page specified in the action of the form.

highlightHref (Optional)

Default: Yes; any associated href links are highlighted.

onValidate (Optional)

Used to call a JavaScript function for input validation.

onError (Optional)

A JavaScript function to use if the validation fails.

gridDataAlignu

Default: Left

Options are Left, Right, or Center.

gridLines (Optional)

Default: Yes, which enables row and column rules in the grid.

rowHeight (Optional)

Minimum row height of the grid.

rowHeaders (Optional)

Default: Yes, which displays a column of numeric row labels in the grid.

rowHeaderAlign (Optional)

Default: Left

Options are Left, Right, or Center.

rowHeaderFont (Optional)

Row label font.

rowHeaderFontSize (Optional)

Row label text size.

rowHeaderItalic (Optional)

Default: No. If Yes, displays row label text in italics.

rowHeaderBold (Optional)

Default: No. If Yes, displays row label text in bold.

rowHeaderTextColor (Optional)

Default: black; text color of row headers.

colHeaders (Optional)

Default: Yes, which displays column headers in the grid

colHeaderAlign (Optional)

Default: Left

Options are Left, Right, or Center.

colHeaderFont (Optional)

Font of column header.

colHeaderFontSize (Optional)

Size of column header text.

colHeaderItalic (Optional)

Default: No. If Yes, displays column headers in italics.

colHeaderBold (Optional)

Default: No. If Yes, displays column headers in bold.

colHeaderTextColor (Optional)

Color of column headers.

bgColor (Optional)

Background color of the grid.

selectColor (Optional)

Background color for a selected item.

selectMode (Optional)

Default: Browse

Selection mode for items in the grid.

  • Edit. User can edit grid data. With Single, user selections are limited to the selected cell.

  • Row. User selections automatically extend to the row that contains the selected cell.

  • Column. User selections automatically extend to the column that contains the selected cell.

  • Browse. User can only browse grid data.

maxRows (Optional)

Maximum number of rows to display in the grid.

notSupported (Optional)

Text to display if the browser does not support Java or has Java support disabled.

pictureBar (Optional)

Default: No. If Yes, images for Insert, Delete, and Sort buttons.

insertButton (Optional)

Default: insert. Only works if selectmode = "edit".

deleteButton (Optional)

Default: delete. Only works if selectmode = "edit".

sortAscendingButton (Optional)

Default: A -> Z

sortDescendingButton (Optional)

Default : Z -> A



Inside ColdFusion MX
Inside Coldfusion MX
ISBN: 0735713049
EAN: 2147483647
Year: 2005
Pages: 579

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net