Param_InstanceReference 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.

Append a new Source parameter to the end of the Sources list. Sources provide this parameter with data at runtime.

Insert a new Source parameter into the Sources list. Sources provide this parameter with data at runtime.

Inserts an item of volatile data into the data structure.

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.

Attempts to convert the Object reference into an instance of T. This method will perform a direct cast if possible or it will call Casting functions on T or Data if they exist. Data will not be duplicated unless a type conversion is required.

Remove all proxy sources without attempting to relink them.

Destroy all warning and error lists

This method collects volatile data from all the source parameters.

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

Convert all proper source parameters into proxy sources.

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.

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

Invoke the Expiresolution(bool) method on the toplevel object.

Returns "Null" if the data is a null reference, otherwise calls ToString() on the Data instance.

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.

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 function returns a ToolstripMenuItem that embeds a multi-line textbox for editing persistent data. Only call this method if you know that your parameter type supports proxies.

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.

This override removes all instances that fail to load their geometry.

This function can be used to iterate over all items in the Volatile data tree and collect the union clipping box of all non-null items that implement Preview.IGH_PreviewData. This function requires a lot of TypeOf and DirectCasting, so if you're worried about performance you should consider doing this yourself.

This function can be used to iterate over all items in the Volatile data tree and call DrawViewportWires on each item that implements Preview.IGH_PreviewData. This function requires a lot of TypeOf and DirectCasting, so if you're worried about performance you should consider doing this yourself.

This function can be used to iterate over all items in the Volatile data tree and call DrawViewportWires on each item that implements Preview.IGH_PreviewData. This function requires a lot of TypeOf and DirectCasting, so if you're worried about performance you should consider doing this yourself.

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.

Add an undo record that stores changes to persistent data.

Record an entire undo record.

Record a generic object change undo event.

Record a specific object change undo event.

Call this method if you wish to register remote ids in the volatile data despite having one or more sources. You should only need to do this if you converted non-referenced data into volatile referenced data.

Utility function which treats all data in the Volatile cache as IGH_GeometricGoo and registers all referenced objects. Call this function from within RegisterRemoteIDs() if you are absolutely sure that all the items in volatiledata implement IGH_GeometricGoo.

Attempt to replace all proxy sources with real sources. Proxy sources are used during file IO, when actual sources might not be available yet. Once an IO operation has been completed there should be no more proxy sources.

Remove all sources from this parameter.

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

Remove all post-process effects. Note to implementors, you must call the base method if you override this function.

Remove the specified source from this parameter.

Remove the specified source from this parameter.

This function has been emptied because it is Obsolete.

Replace an existing source with a new one. If the old_source does not exist in this parameter, nothing happens.

Replace an existing source with a new one. If the old_source does not exist in this parameter, nothing happens.

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.

Add a single item to the persistent data. This method will record an undo event, raise the OnObjectChanged event for PersistentData flags and place a call to ExpireSolution(False). If you want to add more than one piece of data, you should use the appropriate overload for this method.

Assign a tree of items to the persistent data. This method will erase any existing data, record an undo event, raise the OnObjectChanged event for PersistentData flags and place a call to ExpireSolution(False). If you want to add a tree of data, you should use the appropriate overload for this method.

Assign a list of items to the persistent data. This method will erase any existing data, record an undo event, raise the OnObjectChanged event for PersistentData flags and place a call to ExpireSolution(False). If you want to add a tree of data, you should use the appropriate overload for this method.

Add a collection of values to the persistent data.

Set the principal parameter state.

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.

This method is called to populate the Tooltip data description field.

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.