AddGroup

<< Click to Display Table of Contents >>

Manual > Control Reference > Data > Plot graph control > Method >

AddGroup

 

Add a group.

 

syntax

AddGroup(

         [groupTitle]

         [,startupXSpan = 0]

         [,low = 0]

         [,high = 0]

         )

 

Parameters

 

groupTitle

Type:

character

For details, please refer to "Obtaining and setting group information".

 

startupXSpan

Type:

Number

For details, please refer to "Obtaining and setting group information".

 

low

Type:

Number

For details, please refer to "Obtaining and setting group information".

 

high

Type:

Number

For details, please refer to "Obtaining and setting group information".

 

Return Value

Type:

Boolean

FALSE - Failure. TRUE - Success.

 

hmtoggle_plus1Explanation

There is no limit to the number of groups you can add. Groups are numbered sequentially, starting from 1. The graph control has a group number 1 added to it by default.

This is to allow you to use AddGroup without being aware of it, even if group management is not required.

If you want to define your own groups starting from group number 1, call the ClearAll method before adding groups.

 

 

hmtoggle_plus1Example

 

 

 

this.ClearAll();
this.AddGroup("GroupTitle01")
this.AddGroup("GroupTitle02")
this.SelectGroup(1); // Select group 1
this.AddPen(...)
...
this.SelectGroup(2); // Select group 2
this.AddPen(...)
...

 

 

reference

 

AddGroup

InsertGroup

DelGroup

ClearAll

SelectGroup

GetSelectedGroup

GetGroupCount

GetGroupProperty

SetGroupProperty