TraceRoutine object

The TraceRoutine object provides information about a node in a trace file identified as an occurrence of a routine. To access the extra properties of the TraceRoutine object, you assign a TraceActivityNode object whose activity type is ActRoutine! to the TraceRoutine object. The TraceRoutine object has no events.

Properties

TraceRoutine property

Datatype

Description

ActivityType

TraceActivity (enumerated)

The value ActRoutine! which identifies the activity represented by the node as an occurrence of a routine entry or exit.

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 contains the routine. The value is " " for system functions. Nested classes (like controls in windows) have a name of the form class name`embedded class name.

IsEvent

Boolean

True if the routine is an event and false if the routine is a function.

LibraryName

String

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

Name

String

The name of the routine including the parameter datatypes and return value.

ObjectID

UnsignedLong

The object ID for the object on which the routine is executing. The ID is 0 if the routine executing is a global or system routine.

TimerValue

Decimal

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


Functions

TraceRoutine 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