$root.$iwindows.WINDOW.$objs.Complex Grid

Parent: $root.$iwindows.WINDOW.$objs
 
Children 

Class notation

Properties Methods Events 

Presents data as a series of columns and rows similar to a spreadsheet; in runtime the user can create new rows, enter data into cells, and size the columns.

Properties

Object specific 
$borderradiusRadius for rounded border corners.1 to 4 pixel values separated by -,in order topleft,topright,bottomright,bottomleft.If bottomleft is omitted it is topright.If bottomright is omitted it is topleft.If topright is omitted it is topleft
$calculationEither a calculation,the result of which is the value searched when typing text; or a literal string enclosed in single or double quotes, which is the name of the column containing the value searched when typing text
$canclickvertheaderIf true,the vertical header of the grid will accept clicks and highlight selected lines,provided that the $enterable property of the grid is kFalse
$canresizecolumnsIf true, the user can use the mouse to resize the columns of the object
$canresizeheaderIf true, the header on the complex grid can be resized
$canresizerowsOne of the kResize... constants,indicating how the user can use the mouse to resize the rows of the object
kResizeHeaderAndRows kResizeHeaderOnly kResizeNone kResizeRowsOnly
$columnsNumber of columns. This can only be assigned when the design window containing the complex grid is open
$dropbetweenlinesIf true, the object highlights between lines during drag and drop
$enterableIf true, the field is enterable
$extendableIf true, the grid automatically extends to allow the user to enter more lines
$extendedgridlinesIf true,the gridlines will extend beyond the final row to the bottom of the complex grid
$fieldstylefocusedThe style in system class #STYLES assigned to this field in addition to $fieldstyle when the control has focus
$firstselThe number of the first selected character or line in the current contents
$firstvisThe number of the first visible character or line in the contents
$gridsectionThe type of the complex grid section containing the object. One of the kGrid... constants
$headerborderThe border style for the grid header
kBorder3DFace kBorder3DHilite kBorderBevel kBorderChisel kBorderCtrlComboBox kBorderCtrlDropList kBorderCtrlEdit kBorderCtrlGroupBox kBorderCtrlList kBorderCtrlListCell kBorderCtrlShadow kBorderCtrlShadowEx kBorderCtrlTabPane kBorderDefault kBorderEmbossed kBorderEmbossedChisel kBorderInset kBorderInsetBevel kBorderNone kBorderPlain kBorderShadow kBorderSingleEmbossed kBorderSingleInset
$headerfillcolorThe fill color for the grid or headed list box header
$headerheightThe height of the grid header
$headerlinestyleThe line style for the grid header
$hilitelineIf true, the object highlights lines during drag and drop
$horzfooterborderThe border style for the grid horizontal footer
kBorder3DFace kBorder3DHilite kBorderBevel kBorderChisel kBorderCtrlComboBox kBorderCtrlDropList kBorderCtrlEdit kBorderCtrlGroupBox kBorderCtrlList kBorderCtrlListCell kBorderCtrlShadow kBorderCtrlShadowEx kBorderCtrlTabPane kBorderDefault kBorderEmbossed kBorderEmbossedChisel kBorderInset kBorderInsetBevel kBorderNone kBorderPlain kBorderShadow kBorderSingleEmbossed kBorderSingleInset
$horzfooterfillcolorThe fill color for the grid horizontal footer
$horzfooterheightThe height of the grid horizontal footer
$horzfooterlinestyleThe line style for the grid horizontal footer
$horzheaderborderThe border style for the grid horizontal header
kBorder3DFace kBorder3DHilite kBorderBevel kBorderChisel kBorderCtrlComboBox kBorderCtrlDropList kBorderCtrlEdit kBorderCtrlGroupBox kBorderCtrlList kBorderCtrlListCell kBorderCtrlShadow kBorderCtrlShadowEx kBorderCtrlTabPane kBorderDefault kBorderEmbossed kBorderEmbossedChisel kBorderInset kBorderInsetBevel kBorderNone kBorderPlain kBorderShadow kBorderSingleEmbossed kBorderSingleInset
$horzheaderfillcolorThe fill color for the grid horizontal header
$horzheaderheightThe height of the grid horizontal header
$horzheaderlinestyleThe line style for the grid horizontal header
$lastselThe number of the final selected character or line in the current contents
$lastvisThe number of the final fully visible character or line in the contents
$multipleselectIf true, the field allows the user to select more than one line
$rowborderThe border style for the grid row section
kBorder3DFace kBorder3DHilite kBorderBevel kBorderChisel kBorderCtrlComboBox kBorderCtrlDropList kBorderCtrlEdit kBorderCtrlGroupBox kBorderCtrlList kBorderCtrlListCell kBorderCtrlShadow kBorderCtrlShadowEx kBorderCtrlTabPane kBorderDefault kBorderEmbossed kBorderEmbossedChisel kBorderInset kBorderInsetBevel kBorderNone kBorderPlain kBorderShadow kBorderSingleEmbossed kBorderSingleInset
$rowdividerlinestyleThe line style for the grid row divider
$rowheightThe height for the grid row
$selectionbackcolorThe color of selected lines. kColorDefault means use the default color. When not kColorDefault only applies when the control has the focus
$selectiontextcolorThe text color of selected lines. kColorDefault means use the default color. When not kColorDefault applies irrespective of whether the control has the focus
$showheaderIf true, the grid has a header
$showhorzfooterIf true, the grid has a scrollable horizontal footer
$showhorzheaderIf true, the grid has a scrollable horizontal header
$showvertheaderIf true, the grid has a scrollable vertical header
$slideouttypeA kGridSlideOut... constant that specifies how the columns slide out for a grid with 2 or more columns and no horizontal scroll bar
kGridSlideOutTypeLeft kGridSlideOutTypeLeftRight kGridSlideOutTypeNone kGridSlideOutTypeRight
$tooltipposA kTooltipPos... constant that specifies where $tooltip appears relative to the control
kTooltipPosBottom kTooltipPosLeft kTooltipPosMouse kTooltipPosRight kTooltipPosTop
$vertheaderborderThe border style for the grid vertical header
kBorder3DFace kBorder3DHilite kBorderBevel kBorderChisel kBorderCtrlComboBox kBorderCtrlDropList kBorderCtrlEdit kBorderCtrlGroupBox kBorderCtrlList kBorderCtrlListCell kBorderCtrlShadow kBorderCtrlShadowEx kBorderCtrlTabPane kBorderDefault kBorderEmbossed kBorderEmbossedChisel kBorderInset kBorderInsetBevel kBorderNone kBorderPlain kBorderShadow kBorderSingleEmbossed kBorderSingleInset
$vertheaderfillcolorThe fill color for the grid vertical header
$vertheaderlinecolorThe line color for the vertical header
$vertheaderlinestyleThe line style for the vertical header
$vertheaderwidthThe width of the vertical header
Standard$active $backcolor $backpattern $bordercolor $candropcursor $componentinfo $container $contextmenu $cursor $dataname $disablesystemfocus $dragborder $dragiconid $dragmode $dragrange $dropmode $edgefloat $effect $enabled $fieldstyle $forecolor $framehwnd $gridcolumn $hasfocus $height $helpfile $horzscroll $hscroll $hwnd $ident $keyevents $left $mouseevents $name $nodropcursor $objtype $order $osdropflags $rmouseevents $selected $sidepanel $sidepanelmode $statusevents $tooltip $top $userinfo $vertscroll $visible $vscroll $width

Methods

Object specific 
$clearexceptions$clearexceptions([iRowNumber]) Clears row based attribute exceptions in complex grid fields; omit iRowNumber to clear all exceptions
$getrowheight$getrowheight([iRow=-1]) returns the complex grid row height. iRow is row number (-1 current row)
$sendevent$sendevent(iEvent[,eventParameters...]) Sends event iEvent (an ev... constant value) to the object with eventParameters passed as name,value pairs, for example $sendevent(evClick,'pLineNumber',2).Returns kFalse if the event is discarded
$setrowheight$setrowheight(iSz[,iRow=-1,iNewSize=-1,iCurve=kAnimationCurveEaseOut,iAnimDuration=350]) animates change to row height using iSz (kGridRowSize...).iRow is row number (-1 current row).If expanding iNewSize is new size (-1 to use $rowheight)
$showpanel$showpanel(iAction[,iMode=kSidePanelModeAuto]) executes kSidePanelAction... on a side panel object. iMode only applies to kSidePanelActionShow,and must be kSidePanelModeCover/Push/Auto. For JS client,$showpanel must be executed on the client
$slideoutcolumn$slideoutcolumn(iDirection[,iRow=-1,iType=kGridSlideOutTypeRight]) uses iDirection (a kGridSlideDirection... constant) to hide or show iType (a kGridSlideOutType... constant).iRow is -1 for current row or a row number
Standard$redraw

Events

Object specific 
evCellBeforeAlways sent to a cell before the focus enters
Parameters
pEventCodeThe event code
pHorzCellThe horizontal cell id
pVertCellThe vertical cell id
evCellChangedSent to a field after the grid cell has been changed
Parameters
pEventCodeThe event code
pHorzCellThe horizontal cell id
pVertCellThe vertical cell id
pCellDataThe cell data
evCellChangingSent to a field before the grid cell is changed
Parameters
pEventCodeThe event code
pHorzCellThe horizontal cell id
pVertCellThe vertical cell id
pCellDataThe cell data
evExtendSent to grid field when the list is to be extended
Parameters
pEventCodeThe event code
pRowA reference to the list row
pLineNumberThe line number in the list
evFixedCellClickedSent to the grid when a fixed cell is clicked
Parameters
pEventCodeThe event code
pHorzCellThe horizontal cell id
pVertCellThe vertical cell id
evScrollTipSent to the grid field during scrolling so the scroll tip can be changed
Parameters
pEventCodeThe event code
pIsVertScrollIf true,the scrolltip is for the vertical scroll bar
pScrollPosThe new scroll position that the scrollbar has been moved to
pScrollTipThe string to be used in the scrolltip
evWillHideSent to a field before it is hidden. Currently only used when the field is set as a side panel
Parameters
pEventCodeThe event code
pSidePanelIf true,this object is being hidden or shown as a side panel
evWillShowSent to a field before it becomes visible. Currently only used when the field is set as a side panel
Parameters
pEventCodeThe event code
pSidePanelIf true,this object is being hidden or shown as a side panel
StandardevAfter evBefore evCanDrop evClick evClipChangedData evDisabled evDrag evDragBorder evDragFinished evDrop evEnabled evHidden evHScrolled evKey evMouseDouble evMouseDown evMouseEnter evMouseLeave evMouseUp evOpenContextMenu evRMouseDouble evRMouseDown evRMouseUp evSent evShiftTab evShown evTab evVScrolled evWillDrop

Children

Top 

$bobjs$dividers$methods$objs