ReportControl_GetInit¶
ReportControl_GetInit converts a string matrix into a scalar string which can be used to initialize the report control in a dialog box.
-
ssInit = ReportControl_GetInit(smMatrix)
-
ssInit = ReportControl_GetInit(smMatrix, bUseSaveSep)
-
ssInit = ReportControl_GetInit(smMatrix, bUseSaveSep, smSel)
-
ssInit = ReportControl_GetInit(smMatrix, bUseSaveSep, rvSel)
Return Value
ssInit is a scalar string.
Parameters
-
smMatrix
smMatrix is a string matrix with as many columns as the report control.
-
bUseSaveSep
bUseSaveSep specifies the cell separators. If the parameter is not given, the records are separated by an OR character
|
and the elements of a record are separated by a tab character\t
. The selection is separated by a@
character. If the parameter has the value TRUE (1), the value\0x01
is used instead of the OR character. The selection is separated by the value\0x02
instead of the@
character. In this case, the string starts with the value\0x01
. The separators\0x01
and\0x02
must be used if the report control contains “Marker” combo boxes, because the init string of marker combo boxes already contains@
characters. The cells of a record are separated by a tabulator character “\t
”.
-
smSel
smSel is a string matrix containg the selected rows.
-
rvSel
rvSel is a vector with the indices of the selected rows of smMatrix. if rvSel is 0 now row is selected.
History
Version | Description |
---|---|
5.5.0 | rvSel = 0 is valid. |
5.3.0 | Add third parameter |
4.2.2 | New |
See also
Overview Dialogboxes, DialogBox, CreateListBoxText, GetListBoxText, ReportControl_GetMatrix
id-963202