the software that grows
with you
|
V32PGraph() |
|||||||||
| Prints a Vouch32 Graph object at the specified location on the printer page. | |||||||||
|
Syntax |
|||||||||
| V32PGraph( <nRow>,<nCol>,<n2Row>,<n2Col>,<aData>, <aLabels>, <aLegends>, [aColors], [nType], [cTitleTop], [cTitleLeft], [cTitleBottom], [cBkGdBitmap], [l3D], [lSpace], [lStacked], [lGridX], [lGridY], [lLegends], [lLabelsX], [lLabelsY], [lOutLines], [lData], [nPxlLeft], [nPxlTop], [nPxlWidth], [nPxlHeight], [nBGColor] ) | |||||||||
|
Arguments |
|||||||||
| nRow | Top row position to place the object on the page. | ||||||||
| nCol | Left column position to place to object on the page. | ||||||||
| n2Row | Bottom row position to determine the object's height on the page. | ||||||||
| n2Col | Right column postion to determine object's width on the page. | ||||||||
| aData | A two dimentional array of numeric data representing rows and columns. Len( aData ) will represent Labels and Len( aData[ 1 ] ) will represent Legends. | ||||||||
| aLabels | Array of character strings which will be displayed at the x-axis. This must match the rows in the <aData> or Len( <aData> ) otherwise graphics may not work properly. | ||||||||
| aLegends | Array of character strings representing columns in <aData> which will be displayed at the right side of the graph. Len( <aLegends> ) must match the Len( <aData>[ 1 ] ) otherwise graphics will not work properly. | ||||||||
| aColors | Array of RGB values matching the Len( <aLegends> ) used to draw the bars etc. The number of elements in <aColors> must be equal to elements in <aLegends>. Alternatively, you can avoid colors to let the graphics engine decide at its own the colors of bars etc. | ||||||||
| nType | One of the following values, default is
TYP_BARS
|
||||||||
| cTitleTop | Character string representing the title to be displayed at the top of graph window. The title will be displayed centered over the plotting area. Make it sure that <cTitleTop> must fit the plotting area otherwise excess portion from the right will be truncated to fit. It should be noted that <cTitleTop> is displayed in bold face Ariel font. | ||||||||
| cTitleLeft | Character string to be displayed verically at the left plane of the graphics window. It will be displayed centered at the left plane of the plotting area. Any exccess charcters will be truncated. | ||||||||
| cTitleBottom | Character string to be dispayed below the x-axis. It will be displaed centered along the x-axis plotting area. Any excess characters will be truncated from the right side. | ||||||||
| cBkGdBitmap | Fully qualified .BMP file name with drive, directory and extension information. If a valid BMP file, will be displayed within the boundries of back interior of plotting area. Please note that bitmap will not be displayed when graph is invoked. Instead it can be painted with clicking the right button anywhere within the graph window and selection appropriate option. | ||||||||
| l3D | Logical to specify whether chart is to be displayed as 3D. Default is TRUE. | ||||||||
| lSpace | Logical to specify whether chart is to be displayed as spaced. Default is FALSE. | ||||||||
| lStacked | Logical to specify whether chart is to be displayed as stacked. Default is FALSE. <lSpace> and <lStacked> are mustually exclusive options. If <lSpace> is set to TRUE, <lStacked> will be ignored and treated as FALSE. | ||||||||
| lGridX | Logical to specify whether chart is to be displayed with x-grids drawn. Default is TRUE. | ||||||||
| lGridY | Logical to specify whether chart is to be displayed with y-grids drawn. Default is TRUE. | ||||||||
| lLegends | Logical to specify whether chart is to be displayed with legends drawn. Default is TRUE. | ||||||||
| lLabelsX | Logical to specify whether chart is to be displayed with x-labels drawn. Default is TRUE. | ||||||||
| lLabelsY | Logical to specify whether chart is to be displayed with y-labels drawn. Default is TRUE. | ||||||||
| lOutLines | Logical to specify whether chart is to be displayed with outlines of bars drawn. Default is TRUE. | ||||||||
| lData | Logical to specify whether chart is to be displayed with data values drawn. Default is FALSE. | ||||||||
| nPxlLeft | Numeric to specify the left location on the desktop in terms of pixels. Default is 30. | ||||||||
| nPxlTop | Numeric to specify the top location on the desktop in terms of pixels. Default is 30. | ||||||||
| nPxlWidth | Numeric to specify the width of the chart window in terms of pixels. Default is 400. | ||||||||
| nPxlHeight | Numeric to specify the height of the chart window in terms of pixels. Default is 230. | ||||||||
| nBgColor | RGB color index as the background color of the chart window. Default is value returned by RGB( 255, 255, 255 ) that is white. | ||||||||
|
Returns |
|||||||||
| NIL | |||||||||
|
Description |
|||||||||
| V32PGraph()
prints a Vouch32 Graph object through Vouch32 Print Engine and can be
merged with other objects like, pictures, barcodes, lines, ellipses,
frames, lines, text, etc. This function uses the V32Graphs() object to
create a graph image and then rendering that image at the specified
coordinates of the page in question. The graph object is created exactly
the same way V32Graphs() function creates. For a brief period ( less than
1/5 of a second ) V32Graphs() window appears on the screen and
automatically closed after creating a graph object in memory. Then memory
image is rendered on the page at { nRow, nCol, n2Row, n2Col }region.
Please note that the window display of graph object and rendering of the image captured in that window and its subsequent rendering on page coordinates may be different from the perspective point of view. So your page coordinates must correspond to graph's window width and size. |
|||||||||
|
Usage |
|||||||||
|
Tips |
|||||||||