CIP Visual Basic.NET documentation for interface "IpfcDetailSymbolDefItem"

Interface IpfcDetailSymbolDefItem

Description

This interface represents a symbol definition in a Creo Parametric model.

See Also:: IpfcDetailItemOwner.GetDetailItem(), IpfcDetailItemOwner.ListDetailItems(), IpfcDetailItemOwner.CreateDetailItem(), IpfcDetailItemOwner.RetrieveSymbolDefinition()

Direct Parent Classes:: IpfcDetailItem

Method Summary


`Function`	`CreateDetailItem (Instructions as IpfcDetailCreateInstructions) as IpfcDetailItem`
	Creates a detail item in the symbol definition.

`Function`	`CreateFreeNote (TextLines as IpfcDetailTextLines, Attach as IpfcFreeAttachment) as IpfcDetailNoteItem`


`Function`	`CreateSubgroup (Instructions as IpfcDetailSymbolGroupInstructions, ParentGroup as IpfcDetailSymbolGroup [optional]) as IpfcDetailSymbolGroup`
	Create a subgroup in the specified symbol group.

`Function`	`GetDetailItem (Type as IpfcDetailType, Id as Long) as IpfcDetailItem [optional]`
	Returns a detail item in a symbol definition, given its id and type.

`Function`	`GetInstructions () as IpfcDetailSymbolDefInstructions`
	Returns an instructions data object describing how a symbol definition is constructed.

`Function`	`IsSubgroupLevelExclusive (ParentGroup as IpfcDetailSymbolGroup [optional]) as Boolean`
	Determine if the subgroups stored in the symbol definition on the indicated level are exclusive.

`Function`	`ListDetailItems (Type as IpfcDetailType [optional]) as IpfcDetailItems [optional]`
	Lists the detail items in the symbol definition.

`Function`	`ListSubgroups () as IpfcDetailSymbolGroups [optional]`
	List the subgroups in the symbol definition.

`Sub`	`Modify (Instructions as IpfcDetailSymbolDefInstructions)`
	Modifies a symbol definition.

`Sub`	`SetSubgroupLevelExclusive (ParentGroup as IpfcDetailSymbolGroup [optional])`
	Set the symbol groups exclusive at specified level.

`Sub`	`SetSubgroupLevelIndependent (ParentGroup as IpfcDetailSymbolGroup [optional])`
	Set the symbol groups independent at specified level.

Method Detail

Function CreateDetailItem (Instructions as IpfcDetailCreateInstructions) as IpfcDetailItem

Creates a detail item in the symbol definition.

Parameters:

Instructions: The data item instructions. This should be a IpfcDetailEntityInstructions or IpfcDetailNoteInstructions object.

Returns:: The detail item created in the symbol definition.

Function CreateFreeNote (TextLines as IpfcDetailTextLines, Attach as IpfcFreeAttachment) as IpfcDetailNoteItem

Parameters:

TextLines
Attach

Returns:

Function CreateSubgroup (Instructions as IpfcDetailSymbolGroupInstructions, ParentGroup as IpfcDetailSymbolGroup [optional]) as IpfcDetailSymbolGroup

Create a subgroup in the specified symbol group.

If no symbol group is specificed, the subgroup is created under the top level symbol group.

Exceptions thrown (but not limited to):

IpfcXToolkitInvalidName - A group with the provided name already exists at this level.

Parameters:

Instructions: The characteristics for creating the subgroup.
ParentGroup: The symbol group under which the subgroup is to be made.

Returns:: The symbol group.

Function GetDetailItem (Type as IpfcDetailType, Id as Long) as IpfcDetailItem [optional]

Returns a detail item in a symbol definition, given its id and type.

Exceptions thrown (but not limited to):

IpfcXToolkitNotFound - This means either:

No entities were found, OR
No notes were found.

IpfcXToolkitOutOfMemory - Found too many (either/all of) entities, notes to be contained in the output array. Use Visit instead.

Parameters:

Type: The detail type.
Id: The integer identifier.

Returns:: The detail item, or null, if the item was not found.

Function GetInstructions () as IpfcDetailSymbolDefInstructions

Returns an instructions data object describing how a symbol definition is constructed.

Returns:: The instructions data object.

Function IsSubgroupLevelExclusive (ParentGroup as IpfcDetailSymbolGroup [optional]) as Boolean

Determine if the subgroups stored in the symbol definition on the indicated level are exclusive.

Parameters:

ParentGroup: The exclusiveness is determined at the level of this symbol group. If not specifed, the top level is assumed.

Returns:: true if the subgroups are exclusive and false if independent.

Function ListDetailItems (Type as IpfcDetailType [optional]) as IpfcDetailItems [optional]

Lists the detail items in the symbol definition.

Exceptions thrown (but not limited to):

IpfcXToolkitNotFound - This means either:

No items were found, OR
No entities were found, OR
No groups were found, OR
No notes were found, OR
No symbol definitions were found, OR
No symbol instances were found.

IpfcXToolkitOutOfMemory - Found too many (either/all of) entities, groups, notes, symbol definitions, symbol instances to be contained in the output array. Use Visit instead.

Parameters:

Type: The type of detail items to list.

Returns:: The items found, or null, if no items were found.

Function ListSubgroups () as IpfcDetailSymbolGroups [optional]

List the subgroups in the symbol definition.

Exceptions thrown (but not limited to):

IpfcXToolkitNotFound - No groups are stored in the symbol definition at this level.

Returns:: The list of sub symbol groups.

Sub Modify (Instructions as IpfcDetailSymbolDefInstructions)

Modifies a symbol definition.

Parameters:

Instructions: Data object containing modifications to the symbol definition.

Sub SetSubgroupLevelExclusive (ParentGroup as IpfcDetailSymbolGroup [optional])

Set the symbol groups exclusive at specified level.

Once set exclusive, only one of the groups at this level may be active in the model at any time.

Exceptions thrown (but not limited to):

IpfcXToolkitNoChange - The status was already set to the designated value.

Parameters:

ParentGroup: The symbol groups at the level of this symbol group are set exclusive. If not specified, the top level is assumed.

Sub SetSubgroupLevelIndependent (ParentGroup as IpfcDetailSymbolGroup [optional])

Set the symbol groups independent at specified level.

Once set independent, any number of groups at this level may be active in the model at any time.

Exceptions thrown (but not limited to):

IpfcXToolkitNoChange - The status was already set to the designated value.

Parameters:

ParentGroup: The symbol groups at the level of this symbol group are set independent. If not specified, the top level is assumed.