TraceObject object

The TraceObject object provides information about a node in a trace file identified as the creation or destruction of an object. To access the extra properties of the TraceObject object, you assign a TraceActivityNode object whose activity type is ActObjectCreate! or ActObjectDestroy! to the TraceObject object. The TraceObject object has no events.

Properties

TraceObject property

Datatype

Description

ActivityType

TraceActivity (enumerated)

The value ActObjectCreate! or ActObjectDestroy! which identifies the activity represented by the node as the creation or destruction of an object.

Category

TraceCategory (enumerated)

The category of the activity represented by the node. Values are:

TraceIn! -- The node is the beginning of an activity that spans several statements.

TraceOut! -- The node is the end of an activity that spanned several statements.

ClassDefinition

PowerObject

An object of type PowerObject containing information about the class definition of the object or control.

ClassName

String

The name of the class that is the type of the object. Nested classes (like controls in windows) have a name of the form class name`embedded class name.

IsCreate

Boolean

True if the node represents the creation of an object and false if the node represents the destruction of an object.

LibraryName

String

The name of the library that contains the class of the object. The value is " " for system classes.

ObjectID

UnsignedLong

A unique identifier for the object.

TimerValue

Decimal

The timer value (in seconds) when the activity occurred.


Functions

TraceObject function

Datatype returned

Description

ClassName in PowerScript Reference

String

Returns the name assigned to the object.

GetContextService in PowerScript Reference

Integer

Creates a reference to a context-specific instance of the specified service.

GetParent in PowerScript Reference

PowerObject

Returns a reference to the name of the parent object.

TypeOf in PowerScript Reference

Object (enumerated)

Returns the type of the object.