The position of the legend. Valid options are 1 to 9 where 8=top, 2=bottom, 4=left, 6=right, and so on (look at the keypad).

Tip: The following combinations are NOT supported:

• Position Right (6) or Left (4) with LegendStacked = 0 and LegendAngle = 0
• Position Top (8) or Bottom (2) with LegendStacked = 0 and LegendAngle = 90

Tip: The text for the Legend is set using the .SetSetDescription() method.

Zoom

The point number for this data point. For normal graphs this is an incrementing integer, usually starting at 1. For time graphs it is a real with the format date + time, e.g. dataq.point = Date + (Time / 8640000).

The iColorGroupType has the following declaration:

iColorGroupType                Group, Type

Scrollbar                        Long
Background                       Long
ActiveCaption                    Long
InactiveCaption                  Long
Menu                             Long
Window                           Long
WindowFrame                      Long
MenuText                         Long
WindowText                       Long
CaptionText                      Long
ActiveBorder                     Long
InactiveBorder                   Long
AppWorkSpace                     Long
Highlight                        Long
HighlightText                    Long
BTNFace                          Long
BTNShadow                        Long
GrayText                         Long
BTNText                          Long
InactiveCaptionText              Long
BTNHighlight                     Long

DKShadow3D                       Long
Light3D                          Long
InfoText                         Long
InfoBK                           Long

HotLight                         Long
GradientActiveCaption            Long
GradientInactiveCaption          Long

MenuHighlight                    Long
MenuBar                          Long
                   

Desktop                          Long
Face3D                           Long
Shadow3D                         Long                
Highlight3D                      Long
HiLight3D                        Long
BTNHiLight                         Long

Fetched                          Long

                               End

The last Fetched field can be used to make sure that .GetWindowsColors() is called only once in your application. It is set to 1 by .GetWindowsColors().

Fetch the windows standard color and use them for set 1:

!DATA

iColor      Group(iColorGroupType)

            End

  CODE

    ThisGraph1.GetWindowsColors(iColor)

    ThisGraph1.SetSetColors(1, Color:Black, iColor:BTNFace, Color:Black, Color:White)

If the Point is omitted or 0, a call to .GetPoint() will be made, and this point will be used.

The Lookback parameter shows which way to look for the closest value where no value exists for the given Set at the supplied Point:

• LookBack = 0 will not look for the closest value.
• LookBack = -1 will look for the nearest lower point (to the left) where Set has a value.
• LookBack = 1 will look for the nearest higher point (to the right) were Set has a value.

Get the mouse coordinates:

MyChart.GetMousePos(MouseX, MouseY)

Draw a red circle at (20, 20):

MyChart.SetPen(Color:Red, Pen:Solid, 1)
MyChart.DrawEllipse(20, 20, 10, 10, Color:Red)
MyChart.Display()

Draw a red right-shaded square on the graph region, with bottom left-hand corner at (10, 10):

a[1] = 10; a[2] = 10; a[3] = 10; a[4] = 20; a[5] = 20; a[6] = 20; a[7] = 20; a[8]= 10

MyChart.SetPen(Color:Red, Pen:Solid, 2)
MyChart.DrawPolygon(a, Color:Red, 100, Color:White)
MyChart.Display()

Change set 3's data labeling attributes:

MyChart.SetSetDataLabels(3, 0, '@N5.2', 1, 1) 

Change set 3 to be displayed as a bar chart:
MyChart.SetSetType(3, Insight:Bar)

MyChart.Draw()

Make set 3 invisible:

MyChart.SetSetVisible(3, 0)

MyChart.Draw()

If Set has the value 0 (which is its default value), the Autoscale, YAxisMin, YAxisMax and YAxisStep fields for each set will be assigned the values passed as parameters, and the YAxisMin, YAxisMax and Autoscale fields of the graph object will be assigned these values as well. Unless SeperateYAxis is set to true, the latter fields will be used to draw a single y-axis. Otherwise, the fields for each individual set will be used to draw a separate y-axis. If Set has a value other than 0, only the fields of the set with set number Set will be adjusted, and these will be used to draw its separate y-axis.

Change set 3 to force a 0 to 100 display range on its y-axis:
MyChart.SetSetYAxis (3, False, 0, 100)

Specify the y-axis labeling information for set 3:

MyChart.SetSetYAxis(3, False, 0, 0, '@N5.2')

See the section on the LabelQ for some nifty example code. Also, if you are using the template, make sure you tick the Generate SetLabelFonts() option on the Advanced Tab if you are going to embed code here.

Embed any code here that you would like to execute after the view has been opened but before any of its records are read.

Note that this method will only be generated by the template if you are using an SQL backend. If this is not the case and you try to embed code in this method, you may get an error similar to the one described for .SetPointName() in the Common Errors Section of the User Guide.

This method can be used to embed any code that you would to execute after a data point's attributes have been set but before it has been Put back in the DataQ.

Note that this method will only be generated by the template if you have specified some Conditional Point Overrides on the Colors Tab of one of your sets. If this is not the case and you try to embed code in this method, you may get an error similar to the one described for .SetPointName() in the Common Errors Section of the User Guide.

Make all data points at x-axis point 2 red and of triangular shape:

IF self.DataQ.Point = 2

   self.DataQ.FillColor = Color:Red

   self.DataQ.Shape     = Insight:Triangle

END

If the point name is stored in the View or Queue, it would typically have been assigned by .AddItem(). If the point name for a given point is not yet assigned then .SetPointName() will be called for that point. You can embed code here that modifies the return value to a custom point name of your choice.

Note that to make sure the template generates this method you need to enter a '+' in the Point Name field of the X-Axis Tab. If this is not the case and you try to embed code in this method, you may get an error as described in the Common Errors Section of the User Guide.

See also Making your own Point Names in the FAQ.

Change the point name for each point to the appropriate month abbreviation:
execute month(fil:date)
  ReturnValue = 'Jan'
  ReturnValue = 'Feb'
  ReturnValue = 'March'
  ReturnValue = 'April'
  ReturnValue = 'May'
  ReturnValue = 'June'
  ReturnValue = 'July'
  ReturnValue = 'Aug'
  ReturnValue = 'Sept'
  ReturnValue = 'Oct'
  ReturnValue = 'Nov'
  ReturnValue = 'Dec'
end

If the point number is stored in the View or Queue, it would typically have been assigned by .AddItem(). If the point number for a given point is not yet assigned then .SetPointNumber() will be called for that point. You can embed code here that modifies the return value to a custom point number of your choice.

Note that this method will only be generated by the template if either the Point Number on the Main X-Axis Tab or the Point Number on one of your Set's X-Axis Tabs is an expression. You can force this by entering a single '+' in the entry. If this is not the case and you try to embed code in this method, you may get an error similar to the one described for .SetPointName() in the Common Errors Section of the User Guide.

The closing value for the current record.

See also .AddItem()  for more details.

Note that this method will only be generated by the template if the Close Field on one of your Set's Set Tabs is an expression (providing your graph is a Gantt or Hi-Lo chart). You can force this by entering a single '+' in the entry. If this is not the case and you try to embed code in this method, you may get an error similar to the one described for .SetPointName() in the Common Errors Section of the User Guide.

Make the closing value the current time (for a Gantt graph):

ReturnValue = clock()

See also .AddItem()  for more details.

Note that this method will only be generated by the template if the High Field on one of your Set's Set Tabs is an expression.You can force this by entering a single '+' in the entry. If this is not the case and you try to embed code in this method, you may get an error similar to the one described for .SetPointName() in the Common Errors Section of the User Guide.

Choose a random value for the top of each bar of your Bar graph:

ReturnValue = random(1, 100)

See also .AddItem()  for more details.

Note that this method will only be generated by the template if the Low Field on one of your Set's Set Tabs is an expression. You can force this by entering a single '+' in the entry. If this is not the case and you try to embed code in this method, you may get an error similar to the one described for .SetPointName() in the Common Errors Section of the User Guide.

Choose a random value for the bottom of each bar of your Bar graph:

ReturnValue = random(1, 10)

See also .AddItem()  for more details.

Note that this method will only be generated by the template if the Open Field on one of your Set's Set Tabs is an expression (providing your graph is a Gantt or Hi-Lo chart).You can force this by entering a single '+' in the entry. If this is not the case and you try to embed code in this method, you may get an error similar to the one described for .SetPointName() in the Common Errors Section of the User Guide.

Choose a random value for the opening value of each bar of your Hi-Lo graph:

ReturnValue = random(1, 10)

Creates an embed point in .ResetQueue() allowing you to specify the set number for each record of the view or queue with id number ID, providing that the Set parameter passed to .AddItem() for this view or queue was 0. In this case, this method is called by .ResetQueue() for each record of the queue or view. Use this embed point if you wish the data of a particular view or queue to span multiple sets.

Use this embed point if you wish the data of a particular view or queue to span multiple sets.

Note that this method will only be generated by the template if you have chosen to Override the Set Number to a non-fixed value. If this is not the case and you try to embed code in this method, you may get an error similar to the one described for .SetPointName() in the Common Errors Section of the User Guide.

Assign the set number of each member of the queue depending on its name:

if PlottingQueue.Name = 'Sales'

  ReturnValue = 1

elsif PlottingQueue.Name = 'Returns'

  ReturnValue = 2

end

Creates an embed point in .ResetQueue() allowing you validate the current record in the view or queue before it is processed. This method is called by .ResetQueue() for each record of the queue or view with id number ID. If it returns false, the current record in the view or queue will be ignored.

The below illustrates how to implement the suggestion mentioned in the Notes above, where ID is being passed as parameter to this ValidateRecord method, and ThisGraph5:Parent:1 is the variable that was passed as the parent field to .AddItem():

ReturnValue = Parent.ValidateRecord(ID)
if ID = 1

  ThisGraph5:Parent:1 = MAJ:Number + 1

end