RasterList( [parent [, displayMode [, thumbsize]]] )

Creates a list control. List controls take the entire area of their parent container. The following example creates a grid list control inside a document element with an id of "listDiv":
var list = new RasterList( "listDiv", "grid" );

list.add( null, ICONS32.GRAPHICS, null, "Customize" );
list.add( null, ICONS32.ADDRESS_BOOK, null, "Addresses" );
list.add( null, ICONS32.AUDIO_VOL_HIGH, null, "Sounds" );
list.add( null, ICONS32.ACCESSORIES, null, "Accessories" );
...

Parameters

Name Type   Description
parent object optional A string containing the ID of a DOM element, a DOM element object, or another #Control object. If this argument is null, the list is created but not attached to the DOM herarchy; RasterControl.setParent() must be invoked later to specify the parent container.
displayMode string optional Specifies how the list render its items. Possible values include:
  • "list" (default) - Items are display in a single column and tiled vertically. A 16x16 icon shows to the left of the text.
  • "grid" - Items are display in a grid-like pattern. Icon shows above the text. Text might wrap to a maximum of two lines and any overflow left is hidden.
  • "thumbs" - Items are display in a grid-like pattern. Thumbnail image shows above the text. Text might wrap to a maximum of three lines and any overflow left is hidden.
  • "table" - Items are display as rows in a table. A 16x16 icon shows to the left of the first column's text. If the item was created with a text[] array, each text element in the array is displayed as a column.
This value is case-sensitive. If this value is omitted or not recognized, a "list" value is assumed.
thumbsize number optional Specifies the maximum width or height of a thumbnail picture. This argument is used only when displayMode is "thumbs". If not given, this value defaults to 80 pixels. It is recommended the size is specified to match those from the thumbnails to avoid a jagged pixel-resize look.

See Also

Home Examples Download License
 
Copyright © 2010-2017 Edwin R. López