<< Click here to display Table of Contents >> Navigation: Trading Objects Reference > Chart:

NewXY

Contents

NewXY is the starting method used to create Bar, Scatter, Line, linear and, or Logarithmic charts.

Notes:

After this method has been executed, the type of features available on a chart are determined by adding other methods to the chart to generate the kind of chart needed.

When NewXY is executed:

•First parameter is a text-value that places the characters into the chart's title label area.

•Second parameter is a numeric value that determines the chart's outside boundary width in pixels.

•Third parameter is value that determines the chart's outside vertical height in pixels.

•Fourth parameter is an optional modification string value that can rotate the orientation of the X & Y axis, the scaling of the data from a Linear to a Log scaled display, and it can add a drop shadow effect to the resulting image.

Syntax:
Chart.NewXY( ChartTextName, ChartPixelWidth, ChartPixelHeight, [ChartOptions] )

Parameter:

Description:

ChartTextName

Text assigned to this parameter will be placed in the title bar area above the chart image.

ChartPixelWidth

Chart width is determined by the number of pixel entered into this parameter.

ChartPixelHeight

Chart height is determined by the number of pixel entered into this parameter.

[ChartOptions]

There are three optional words that can change a chart:

Methods:	Descriptions:
Log	Using the Log option in this parameter will convert the Y-Axis scale of the chart display from a Linear-scale to a Log-scale presentation
Shadow	This option adds a drop shadow effect to the chart's appearance. When used the shadow effect reduces the plot area of the image by the size of the added drop shadow effect. Color used for the shadow will be different from the normal white color of the background to make its appearance noticeable.
Vertical	Bar, Contour, Dot, and Line charts are oriented according the placement of the X & Y axis locations. In most charts the orientation of the X-Axis is placed at the bottom of the chart, and the Y-Axis is place along the side, or vertical axis. This option allows the X & Y Axis locations to be rotated so that the X-Axis is positioned along the side, or vertical axis, and it places the Y-Axis along the bottom axis. When "Vertical" is used in this optional parameter location, the chart's data axis locations will show its visual information rotated 90-degrees to the right. Vertical bars which show their value by their height orientation along an image's side or vertical axis will change to displaying horizontal bars that show their value in a left to right orientation along the rotated bottom axis. Contour, dot and line information will also be rotated when those type of displays are added to the chart image space.
Combined Methods	All three methods can be combined as an additional instruction to the NewXY chart method. Example: "Vertical Shadow" will create a rotated axis chart with a drop shadow effect "Log Shadow" will create a rotated axis with a drop shadow effect. "Log Vertical Shadow" will create a rotated axis Log chart with a drop shadow effect.

Example:
NewXY function is required in the code scripts to start the creation of all the custom charts except the Pie Charts: •AddBarSeries •AddContourLayer •AddLineLayer •AddLineSeries •AddScatter