AddBatchOats Method (Component Object)

Scope: Schematic editor

Object: Component Object

Prerequisites: None

Adds multiple instance values (formerly known as OATs) to the component as an encoded string.

Usage

Component.AddBatchOats(ByVal AttributeListSting As String) As Boolean

Arguments

AttributeListSting

Encoded string containing oats to be added. The AttributeListString is specially formatted as shown below.

<visibility> <duplicate> Name=Value<CR>
(repeated for each attribute)

<visibility> should be one of the following integers:

  • 0 = Invisible

  • 1 = Name and Value Visible

  • 2 = Name Only Visible

  • 3 = Value Only Visible

<duplicate> should be one of the following integers:

  • 0 = add - add new attribute regardless of duplicates.

  • 1 = replace - if attribute with this name exists, replace it.

The <CR> represents a carriage return character (ASCII 13).

Return Values

As Boolean. True - the instance values (OATs) were successfully added. False - the instance values (OATs) could not be added.

Examples

This example adds instance values to a component.

char* string="0 0 FOO=BAR\r1 1 TEST=BATCH" 
pDisp->AddBatchOats(string);