This file describes syntax of 24U SimpleChart Plug-In's functions.
SChart_Version ( { versionFormat } )
Returns version string of the active 24U SimpleChart Plug-In, formated as requested by the parameter. Use:
"short" to get just the version number "long" to get the plug-in name followed by its version number "platform" to get the platform of the code currently running
SChart_Register ( registrationCode )
Attempts to unlock (register) your copy of 24U SimpleChart Plug-In with the specified code. If the code is valid, 24U SimpleChart Plug-In gets unlocked and stays in this state until you quit the FileMaker application, deactivate the plug-in, or the registration code expires. While unlocked, 24U SimpleChart Plug-In is fully functional and does not bother the user with a shareware reminder.
Returns a non-zero result when operation is not permitted.
SChart_New
Creates a new (empty) chart and sets parameters to default values.
Default setting for this chart will be :
hsize 320 vsize 240 backcol RGB(255,255,255) - white color textcol RGB( 0 , 0 , 0 ) - black color chartStyle "Pie"
Returns chartdata container.
SChart_Data( chartdataContainer ; Xdata ; Ydata ; seriesColor {; seriesName } )
Collect input data into the chart. When called for the first time, it does the same thing as SChart_New before collecting data.
chartdataContainer Container, which contains chart data and picture. Xdata Data for X axis. Ydata Data for Y axis. seriesColor Color of the current series in RGB format. seriesName Name of the current series.
Xdata and Ydata have 3 types of possible inputs.
1. fieldname or fieldname interval from current found set (data collected using GetNthRecord function )
2. written list of values separated by mark (Enter or ';')
3. reference to field where values are stored (in the same format as specified at point 2)
Returns chardata container.
SChart_Titles( chartdataContainer ; chartName ; XaxisName ; YaxisName )
Sets basic chart titles ( and if possible, redraws chart ).
chartdataContainer Container, which contains chart data and picture. chartName Text for labelling the chart. XaxisName Text for X axis of the chart. YaxisName Text for Y axis of the chart.
Returns chardata container.
SChart_PieColors( chartdataContainer ; color1 ; color2 ; color3 ; ... )
Pie chart has predefined color set. This function allows to set these colors by user. Mostly 256 colors can be set.
chartdataContainer Container, which contains chart data and picture. color1 Color RGB for 1st piece of the pie char. color2 Color RGB for 2nd piece of the pie char. color3 Color RGB for 3rd piece of the pie char.
Returns chardata container.
SChart_Style( chartdataContainer ; chartStyle {; chartSubstyle } )
Sets chart style (and if possible, redraws chart).
chartdataContainer Container, which contains chart data and picture. chartStyle Style of the chart. Currently there are 5 basic styles supported. chartSubstyle Substyle of the chart.
Supported styles:
pie chart variants "Pie","3DPie" line chart variants "Line","3DLine" area chart variants "Area","3DArea" hbar chart variants "HBar" or "Horizontal Bar","H3DBar" or "Horizontal 3DBar" vbar chart variants "VBar" or "Vertical Bar","V3DBar" or "Vertical 3DBar"
Supported substyles for pie charts:
"Percents" Pie labels will contain percent informations.(default) "Values" Pie labels will contain value informations. "Both" Pie labels will contain both informations.
Supported substyles for bar charts:
"Stacked" Series will be stacked in the chart.(default) "Beside" Series will be displayed beside.
Returns chardata container.
SChart_Draw( chartdataContainer ; hsize ; vsize {; backcol ; textcol } )
Sets chart parameters and draws it.
chartdataContainer Container, which contains chart data and picture. hsize Horizontal size of the chart in pixels. vsize Verical size of the chart in pixels. backcol Color RGB for the chart background. textcol Color RGB for the chart foreground and texts.
Returns chardata container.