AddSymbol

Example

Purpose: Add a symbol to a task rowA horizontal row on the schedule, usually containing the name of a project step and important milestone dates for that step..

Return Value: Optional, the number (relative to other symbols on the row) of the newly added symbol.

Argument	Type	Required	Purpose
1	Integer	Yes	Task Row (1 based)
2	String	Yes	Symbol Date (in short date form based on regional settings) e.g. m/d/y
3	Integer	No,use 0 for default	1-64, identifying the symbol in the toolbox. About symbol numbering.
4	Integer	No,use 0 for default	Horizontal connector type from toolbox (1-32). About horizontal connector numbering.
5	Integer	No,use 0 for default	Horizontal connector index (symbol that this symbol connects to (1 based)
6	Integer	No,use 0 for default	Vertical connector type from this symbol (1-8) About vertical connector numbering.
7	Integer	No,use 0 for default	Vertical connection task row of symbol that this symbol connects to (1 based)
8	Integer	No,use 0 for default	Vertical connection symbol index of symbol that this symbol connects to (1 based)
9	Integer	No, use 12 for default	Symbol hour (0-23)
10	Integer	No,use 0 for default	Symbol minute (0-59)
11	String	No, use "" for default	Symbol text line 1 (58 chars max)
12	String	No, use "" for default	Symbol text line 2 (58 chars max)
13	String	No, use "" for default	Symbol text line 3 (58 chars max)
14	String	No, use "" for default	Symbol tag (39 chars max)

Notes:

A symbol is the primary entity of a task bar. Bars can not exist without symbols. So, to create a bar, add a symbol that is connected to a later symbol in the row, and then add the connected symbol.
Task Rows are allocated as needed.
Symbols are initially ordered based upon the order in which they are added so it is important that the vertical indexes of connected symbols reflect the final correct date order after sorting is done. The SortSymbols call sorts the symbols on a line. Normally, symbols are added to a row before using the SortSymbols call. Out of order symbols can cause the SmartColumnA type of column which will automatically fill according to schedule data or entered data. For example, the Symbol Count SmartColumn automatically totals the number of symbols on a task row, and the Duration SmartColumn calculates the length of time between the first symbol and last symbol for each task row. calculations to be incorrect.
Horizontal connections are only displayed if the connected symbol has a date later than the originating symbol.