Parent: $root.$iwindows.WINDOW.$objs
Children
A headed list box is a type of window field that displays data from a list variable in a table format. You can add button style headers to each column of the list on which the user can click to sort the data. You can also make the columns sizeable, and set other properties that control its appearance.
Object specific | |
$boldheader | If true, the heading has a bold font |
$borderradius | Radius 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 |
$buttonstyle | The drawing style of a button:kSystemButton,kUserButton,kNoBorderButton,kHeadingButton,kComboButton,kRoundButton,kLargeRoundButton, or kIDEButton.For headed and tree lists,it is the style of the header button: kSystemButton or kUserButton kSystemButton kUserButton |
$calculation | The calculation used to format the variable for display |
$candragdisplayorder | If true,and $enableheader is also true,the user can drag and drop a column in the header,to change $displayorder |
$canresizecolumns | If true, the user can use the mouse to resize the columns of the object |
$colcount | Returns the number of columns in the list |
$columnalignmode | Controls how $setcolumnalign affects the control. One of kAlignModeAll,kAlignModeBody, kAlignModeHeading and kAlignModeFooter kAlignModeAll kAlignModeBody kAlignModeFooter kAlignModeHeading kAlignModeNone |
$columnnames | The names of the columns |
$columnscontextmenu | A comma separated list of the column numbers to be enabled in the heading context menu. The menu allows the user to show and hide the columns specified by this property. If left empty,there is no menu |
$columnsvisible | A comma separated list of numeric flags,indicating which columns are visible. A value of 1 means the column is visible, and a value of 0 means the column is invisible |
$columnwidths | Comma separated list of column widths,expressed in pixels |
$contentlinecolor | The color of lines drawn in the content of the control.kColorDefault means draw dotted lines.All other values mean draw single pixel lines of the specified color |
$contents | The current contents of the object |
$defaultwidth | The default width of a column |
$disablecolumntooltips | If true, automatic column tooltips are disabled for the headed list.Unless this property is set to kTrue,the headed list automatically generates a tooltip for a column if the text for the column is too long to fully display |
$disableellipsis | If ($cobj.$disableellipsis|$clib.$prefs.$disableellipsis) window instance headed list boxes,and tree lists with more than one column,do not draw an ellipsis when the displayed value is truncated due to insufficient space |
$disablehottracking | If true,the control does not draw any highlighting to show that the mouse is over the main body of the control but not pressed |
$displayorder | Comma separated list of column numbers,indicating the order in which columns are displayed by the headed list.Initially set to 1,2,...,$colcount.Reset to the initial value whenever you change the number of columns |
$dropbetweenlines | If true, the object highlights between lines during drag and drop |
$enableheader | If true, the headings can be clicked on |
$fieldstylefocused | The style in system class #STYLES assigned to this field in addition to $fieldstyle when the control has focus |
$firstsel | The number of the first selected character or line in the current contents |
$firstvis | The number of the first visible character or line in the contents |
$footer | A row containing the contents of the footer of the headed list box.#NULL if $footer has not been assigned |
$gridsection | The type of the complex grid section containing the object. One of the kGrid... constants |
$headerfillcolor | The fill color for the grid or headed list box header |
$headerfontsize | The font size for the text in the header;if this is zero,the header text font size is $fontsize |
$headertextcolor | The text color for the header |
$hidefooter | If true,the footer is hidden |
$hideheader | If true, the heading is hidden |
$hiliteline | If true, the object highlights lines during drag and drop |
$hiliteonecol | Column number for highlight. If greater than zero, the column with this number is the only highlighted column when a line is selected. To highlight whole lines when selected, set this property to zero |
$lastsel | The number of the final selected character or line in the current contents |
$lastvis | The number of the final fully visible character or line in the contents |
$linebackgroundcol | If non-zero,the column number in the dataname list that contains color values that override the default background color of each line (the value zero or kColorDefault in this column means use the normal background color for the line) |
$linehtextra | The number of extra pixels added to the height of each line |
$maxeditchars | The maximum number of characters allowed when editing the text for an icon, or headed list box column; zero means editing is not allowed |
$multipleselect | If true, the field allows the user to select more than one line |
$resizecolumn | The column number of the column that is resized appropriately when the width of the control changes. Zero means no column is resized, and the last column extends if necessary |
$rowbuttons | Slide out row buttons for the left of right sides of the list |
$selectionbackcolor | The color of selected lines. kColorDefault means use the default color. When not kColorDefault only applies when the control has the focus |
$selectiontextcolor | The text color of selected lines. kColorDefault means use the default color. When not kColorDefault applies irrespective of whether the control has the focus |
$showcolumnlines | If true, the control displays lines between columns |
$showcolumnslinesifempty | If true, the list is empty and $showcolumnlines is true, the column lines will be always be shown |
$showheaderlines | If true,the control displays lines between column headers |
$showrowlines | If true, row lines will be shown |
$studioide | If true,the control draws in a platform independent IDE style |
$tooltippos | A kTooltipPos... constant that specifies where $tooltip appears relative to the control kTooltipPosBottom kTooltipPosLeft kTooltipPosMouse kTooltipPosRight kTooltipPosTop |
Standard | $active $align $alpha $backcolor $backgroundtheme $backpattern $bordercolor $candropcursor $componentinfo $container $contextmenu $cursor $dataname $disablefocus $disablefontsizekeys $disablesystemfocus $dragborder $dragiconid $dragmode $dragrange $dropmode $edgefloat $effect $enabled $fieldstyle $font $fontsize $fontstyle $forecolor $framehwnd $gridcolumn $hasfocus $height $helpfile $horzscroll $hscroll $hwnd $ident $keyevents $left $linestyle $local $mouseevents $name $nodropcursor $objtype $order $osdropflags $rmouseevents $selected $sidepanel $sidepanelmode $statusevents $textcolor $tooltip $top $userinfo $vertscroll $visible $vscroll $width |
Object specific | |
$autosizecolumn | $autosizecolumn(iColumnNumber) resizes iColumn to the maximum width of the text in iColumn given every row |
$columnheaderstyle | $columnheaderstyle(iColumnNumber[,summedStyleConstants]) sets or gets the additional styles to apply to the column header of the specified column |
$edittext | $edittext(iColumnnumber[,bSetCurrentField=kFalse]) invokes in place text editing for the specified column on the current line of the headed list box when it is the current field or if bSetCurrentField is kTrue, if the line is selected |
$getcolumnalign | $getcolumnalign(iColumnNumber) gets the column alignment for the specified column |
$getedittext | $getedittext(iLine,iColumn[,bStripTextEscapes=kTrue]) gets the text to edit from the specified line and column, in a headed list box |
$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 |
$setcolumnalign | $setcolumnalign(iColumnNumber,[kLeftJst|kRightJst|kCenterJst]) sets the column alignment for the specified column |
$setrowbuttons | $setrowbuttons(bLeftIcon[,cIcnID,iBackTintColor,bDisabled,cTooltip]) Modify left or right row buttons.Call with 1 parameter to remove all left or right buttons.Call with 2 or more parameters to add a button with SVG icon id cIcnID |
$setsortcolumn | $setsortcolumn(iColumnnumber,bDescending) sets the sort column for the headed list,and whether the direction is ascending or descending.This controls the drawing of the sort arrow.To clear the sort column,pass zero in iColumnnumber |
$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 |
Standard | $redraw |
Object specific | |||||||
evIconDeleteFinished | Sent to an icon array when all selected lines have been deleted Parameters
| ||||||
evIconDeleteStarting | Sent to an icon array when the selected lines are about to be deleted Parameters
| ||||||
evIconEditFinished | Sent to an icon array when new edit text has been stored in the array Parameters
| ||||||
evIconEditFinishing | Sent to an icon array before new edit text is stored in the array Parameters
| ||||||
evIconEditStarting | Sent to an icon array when the text is about to be edited Parameters
| ||||||
evWillHide | Sent to a field before it is hidden. Currently only used when the field is set as a side panel Parameters
| ||||||
evWillShow | Sent to a field before it becomes visible. Currently only used when the field is set as a side panel Parameters
| ||||||
Standard | evAfter evBefore evCanDrop evClick evClipChangedData evDisabled evDoubleClick evDrag evDragBorder evDragFinished evDrop evEnabled evHidden evHScrolled evKey evMouseDouble evMouseDown evMouseEnter evMouseLeave evMouseUp evOpenContextMenu evRMouseDouble evRMouseDown evRMouseUp evSent evShiftTab evShown evTab evVScrolled evWillDrop |
$methods |