class HPS.Object : public IDisposable

The Object class is the common base class of most Visualize classes.

Subclassed by HPS.ConditionalExpression, HPS.Control, HPS.Definition, HPS.DriverEventHandler, HPS.EventDispatcher, HPS.EventHandler, HPS.EventNotifier, HPS.FontInfoState, HPS.FontSearchResults, HPS.FontSearchResultsIterator, HPS.GlyphElement, HPS.HighlightSearchResults, HPS.HighlightSearchResultsIterator, HPS.HighlightState, HPS.IONotifier, HPS.Key, HPS.KeyPath, HPS.KeyboardState, HPS.Kit, HPS.LinePatternElement, HPS.MouseState, HPS.OptimizeMappingResults, HPS.OptimizeMappingResultsIterator, HPS.SearchResults, HPS.SearchResultsIterator, HPS.SelectionItem, HPS.SelectionResults, HPS.SelectionResultsIterator, HPS.ShapeElement, HPS.Sprocket, HPS.Stream.Toolkit, HPS.TouchState, HPS.TreeContext, HPS.TrimElement, HPS.UpdateNotifier, HPS.World

Public Functions

void Dispose ()
bool Empty ()

Indicates whether this object has any values set on it.




An empty object is not necessarily invalid. For example, all fresh new Kits, or Objects that have been reset, are both valid and empty.


true if no values are set on this object, false otherwise.

IntPtr GetClassID ()
IntPtr GetInstanceID ()

Returns the object’s database handle, which can be used to determine which instance of a class the object is. For example, controls are simply aliases for segment keys that group related functions. Therefore, a SegmentKey and all of its controls would return the same instance id. Different keys and controls will return the same value if they are backed by the same database resource.


A value unique to an instance of an object and all objects that are backed by the same database resource. This means it would be 4 bytes on a 32-bit system and 8 bytes on a 64-bit system.

bool HasType (HPS.Type in_mask)

This function indicates whether this Object has the given Type mask.


This function must synchronize the database (by waiting for all pending database operations to complete) in order to know the type status of this object with certainty. Therefore this function can negatively impact performance. You should vigorously avoid using this function in high-traffic or peformance-critical areas of your code.

Param in_mask

The Type mask to check against this Object.


true if this Object has the given Type mask, false otherwise.

Object ()
Object (HPS.Object that)
HPS.Type ObjectType ()

This function returns the type the object, as declared (if the object is derived, this does not give the true type of the derived object).


The declared type of the object in question, which may differ from the true, underlying type.

void Reset ()

Resets this object to its initial, uninitialized state.

Public Static Functions

IntPtr ClassID<T> ()