GH_ActiveObject Methods

This method will be called when an object is added to a document. Override this method if you want to handle such events.

Add a new message to this object. Valid message type flags are Warning and Error. If the Message string is empty or zero-length no message is added.

Override this function if you want to add additional items to the object context menu. Default items already included in the menu toolstrip are:

1. Name

2. Preview

3. Warnings

4. Errors

5. [additional items will be inserted here]

6. Help

This function is called when a context menu is about to be displayed. Override it to set custom items. GH_ActiveObject will already populate the menu with default items, if you merely wish to insert object-specific menu item, consider overriding AppendAdditionalMenuItems instead.

This function is called whenever the object needs to clear all solution data. Override this function if you need to perform custom clensing.

Destroy all warning and error lists

This function is called whenever the object is required to collect all data. Either from Persistent records, from source params or whatever.

This function is called whenever the object is required to generate new data.

Copy all fields (except the instance ID) from another instance description.

This function creates the stand-alone attributes for this object. If you wish to supply your own Attributes, you must override this function.

Returns a boolean indicating whether or not the current object somehow inherits from the PotenialSource object

Call this method to erase the existing icon cache. You must call this if you want to change the display icon of an object.

This method will be called when the document that owns this object moves into a different context.

This function is called whenever the solution for this object expires. Override this function if objects depend on you.

Call this function when you suspect that the preview has expired for this object. This will cause the display cache to be eradicated.

Informs the document that owns this object that the solution has expired. The current object will be set to BLANK as a result. This method is recursive, it will also expire any and all objects which depend on this object. If you want a less destructive expiration, consider using ClearData(). If this object is already Blank, you should consider not expiring it.

Get a boolean value from the component value table.

Get a double value from the component value table.

Get a color value from the component value table.

Get an integer value from the component value table.

Get a string value from the component value table.

Return a String which contains HTML formatted source for the help topic. If you want to pass a URL that points to a remote page, then prefix the URL with a GOTO: tag, like so: GOTO:http://www.YourWebAddressHere.com

Destroy all connections to other objects.

Append the default Bake menu item.

Append the default Enable/Disable menu item.

Appends the default object Help menu item.

Appends the old-fashioned object name menu item. If you also want the Display mode toggle then use Menu_AppendObjectNameEx()

Appends the default object name + display mode menu item.

Append the default Show/Hide preview menu item.

Appends the default item for publishing to RCP. This menu will only appear if the current class implement IRcpAwareObject

Append the default warnings and errors menu items.

This method will be called when an object is moved from one document to another. Override this method if you want to handle such events.

Generate a new random instance GUID

Set the instance ID to be a specific GUID. This is very dangerous, only use this function if you're 6"4' and your first name is David.

Raises the AttributesChanged event on the toplevel object.

Raises the DisplayExpired event on the toplevel object.

Raise the PingDocument Event on the toplevel object and try to find the document which owns this object.

Raises the PreviewExpired event on the toplevel object.

Raises the SolutionExpired event on the toplevel object. You probably want to call ExpireSolution() instead of this method directly.

GH_InstanceDescription does not by default serialize all fields. Use this function to read all fields from the archive. This method is compatible with the default Write()/Read() operations.

Record an entire undo record.

Record a generic object change undo event.

Record a specific object change undo event.

Override this function if you want object changes in the Rhino document to trigger a new solution.

This method will be called when an object is removed from a document. Override this method if you want to handle such events.

Gets the list of cached runtime messages that were recorded during solver-time processes.

Test whether this object is compliant with a given Rhino version.

Set a new custom icon override for this object.

Set a named value. This value will be serialized with the component.

Set a named value. This value will be serialized with the component.

Set a named value. This value will be serialized with the component.

Set a named value. This value will be serialized with the component.

Set a named value. This value will be serialized with the component.

Triggers the AutoSave function on the owner document with the object_changed flag.

Triggers the AutoSave function on the owner document with a custom flag.

Triggers the AutoSave function on the owner document with the object_changed flag.

Triggers the AutoSave function on the owner document with a custom flag.

Override this method if you want to respond to changes to the value table. The base implementation is empty, so you don't have to call it.

GH_InstanceDescription does not by default serialize all fields. Use this function to write all fields to the archive. This method is compatible with the default Write()/Read() operations.