[ParameterAutocomplete(GH_ParameterSide.Input, "{57DA07BD-ECAB-415d-9D86-AF36D7073ABC}")] [ParameterAutocomplete(GH_ParameterSide.Input, "{52a53903-46bf-42c2-818f-c23344fc53c5}")] [ParameterAutocomplete(GH_ParameterSide.Output, "{52a53903-46bf-42c2-818f-c23344fc53c5}")] public sealed class Param_ObjectDraftingLineWidth : GH_PersistentParam<ObjectDraftingLineWidth>

Constructors

Param_ObjectDraftingLineWidth

#
public Param_ObjectDraftingLineWidth()

Fields

m_attributes

protected IGH_Attributes m_attributes
inherited fromGH_DocumentObject

m_data

protected GH_Structure<T> m_data
Contains the runtime data for this parameter, also known as "Volatile" data.
inherited fromGH_Param<T>

Properties

Access

public virtual GH_ParamAccess Access { get; set; }
Gets or sets the Access level for this parameter.
inherited fromGH_Param<T>
Access

Attributes

public IGH_Attributes Attributes { get; set; }
Gets or sets the attributes that are associated with this object. Only set custom attributes if you know what you are doing.
inherited fromGH_DocumentObject
Attributes

Category

public virtual string Category { get; set; }
Gets or sets the Category in which this object belongs. If HasCategory() returns false, this field has no meaning.
inherited fromGH_InstanceDescription
Category

ComponentGuid

#
public override Guid ComponentGuid { get; }

DataMapping

public GH_DataMapping DataMapping { get; set; }
Gets or sets the data mapping of this Parameter.
inherited fromGH_Param<T>
DataMapping

DataType

public sealed override GH_ParamData DataType { get; }
Gets the type of data stored in this parameter.
inherited fromGH_PersistentParam<T>

Description

public virtual string Description { get; set; }
Gets or sets the description of the object. This field typically remains fixed during the lifetime of an object.
inherited fromGH_InstanceDescription
Description

Exposure

#
public override GH_Exposure Exposure { get; }

HasCategory

public bool HasCategory { get; }
Gets whether or not the Category field has been set.
inherited fromGH_InstanceDescription
HasCategory

HasProxySources

public virtual bool HasProxySources { get; }
Gets a value indicating whether or not this parameter maintains proxy 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.
inherited fromGH_Param<T>
True if the parameter has at least one proxy source, false if not.
HasProxySources

HasSubCategory

public bool HasSubCategory { get; }
Gets whether or not the SubCategory field has been set.
inherited fromGH_InstanceDescription
HasSubCategory

Icon

#
protected override Bitmap Icon { get; }

Icon_24x24

public Bitmap Icon_24x24 { get; }
The icon associated with this object.
inherited fromGH_DocumentObject
Icon_24x24

Icon_24x24_Locked

public Bitmap Icon_24x24_Locked { get; }
The greyscale icon of this object.
inherited fromGH_DocumentObject
Icon_24x24_Locked

IconCapableUI

public virtual bool IconCapableUI { get; }
By default the NickName menu item supports the Icon Mode override toggle. If your UI is not capable of displaying icons, then override this property and return False.
inherited fromGH_ActiveObject

IconDisplayMode

public GH_IconDisplayMode IconDisplayMode { get; set; }
Gets the current display mode of the object.
inherited fromGH_DocumentObject
IconDisplayMode

InstanceDescription

public override string InstanceDescription { get; }
Gets the description of this instance. The default description is about the amount and source of the local values.
inherited fromGH_Param<T>

InstanceGuid

public Guid InstanceGuid { get; }
Gets the ID of this runtime instance.
inherited fromGH_InstanceDescription
InstanceGuid

Internal_Icon_24x24

[EditorBrowsable(EditorBrowsableState.Never)] [Browsable(false)] protected virtual Bitmap Internal_Icon_24x24 { get; }
Override this function to supply a custom icon. The result of this property is cached, so don't worry if icon retrieval is not very fast.
inherited fromGH_DocumentObject

IsDataProvider

public sealed override bool IsDataProvider { get; }
inherited fromGH_Param<T>

IsPrincipal

public GH_PrincipalState IsPrincipal { get; }
Gets whether this parameter is a principal parameter. Principal parameters are maintained by components and are not part of the IGH_Param interface.
inherited fromGH_Param<T>

Keywords

public virtual IEnumerable<string> Keywords { get; }
Gets a list of additional keywords that describe the object. Typically this list is empty but you can override this property to aid in object searches.
inherited fromGH_InstanceDescription
Keywords

Kind

public virtual GH_ParamKind Kind { get; }
Gets the parameter kind. The kind is evaluated lazily and cached.
inherited fromGH_Param<T>
Kind

Locked

public virtual bool Locked { get; set; }
Gets or sets the enabled flag of this object. Disabled objects are ignored during solutions.
inherited fromGH_ActiveObject
Locked

MutableNickName

public bool MutableNickName { get; set; }
Gets or sets a value that enables Nick name changes through the menu. The default is TRUE.
inherited fromGH_ActiveObject
MutableNickName

Name

public virtual string Name { get; set; }
Gets or sets the name of the object. This field typically remains fixed during the lifetime of an object.
inherited fromGH_InstanceDescription
Name

NickName

public virtual string NickName { get; set; }
Gets or sets the nickname of the object. This field can be changed by the user.
inherited fromGH_InstanceDescription
NickName

Obsolete

public virtual bool Obsolete { get; }
Gets whether this object is obsolete. Default implementation returns true if the class name contains the string "OBSOLETE" or if this class has been decorated with the ObsoleteAttribute. You are free to override this if you want, but I suggest adding the ObsoleteAttribute instead.
inherited fromGH_DocumentObject
Obsolete

Optional

public bool Optional { get; set; }
Gets or sets whether or not this parameter is considered optional by the owner component. Empty, non-optional parameters prevent the component from being solved.
inherited fromGH_Param<T>
Optional

PersistentData

public GH_Structure<T> PersistentData { get; }
Gets the persistent data stored in this parameter. If you modify the persistent data, be sure to call the: OnObjectChanged(GH_ObjectEventType.PersistentData) event.
inherited fromGH_PersistentParam<T>

PersistentDataCount

public int PersistentDataCount { get; }
Gets the number of persistent data items stored in this parameter.
inherited fromGH_PersistentParam<T>

Phase

public GH_SolutionPhase Phase { get; set; }
Gets or sets the solution phase this object is currenly in.
inherited fromGH_ActiveObject
Phase

ProcessorTime

public override TimeSpan ProcessorTime { get; }
inherited fromGH_Param<T>

ProxySourceCount

public virtual int ProxySourceCount { get; }
Gets the number of proxy sources for this parameter. 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.
inherited fromGH_Param<T>
The number of proxy sources associated with this parameter.
ProxySourceCount

Recipients

public virtual IList<IGH_Param> Recipients { get; }
Gets a list of all the recipients of this parameter. I.e. a recipient has this parameter as one of the sources. The Recipient list is maintained by the parameter, do not modify it yourself.
inherited fromGH_Param<T>
Recipients

Reverse

public bool Reverse { get; set; }
Gets or sets the data reverse modifier of this parameter.
inherited fromGH_Param<T>
Reverse

RuntimeMessageLevel

public virtual GH_RuntimeMessageLevel RuntimeMessageLevel { get; }
Returns the worst case flag for the current object

If the object contains at least 1 error, the result is Error.

If the object contains at least 1 warning, the result is Warning.

If the object contains at least 1 message, the result is Remark.

If the object contains no errors, no warnings and no messages, the result is Blank.

inherited fromGH_ActiveObject

Simplify

public bool Simplify { get; set; }
Gets or sets the simplify modifier for this parameter.
inherited fromGH_Param<T>
Simplify

SourceCount

public virtual int SourceCount { get; }
Gets the number of sources for this parameter.
inherited fromGH_Param<T>
SourceCount

Sources

public virtual IList<IGH_Param> Sources { get; }
Gets a list of source parameters. Do not modify this list, if you wish to add or remove sources, use dedicated functions like AddSource() and RemoveSource() instead.
inherited fromGH_Param<T>
The sources for this parameter.
Sources

StateTags

public virtual GH_StateTagList StateTags { get; }
Gets all the StateTags that are associated with this parameter. A state tag is a visual feedback icon that represents specific internal settings.
inherited fromGH_Param<T>
StateTags

SubCategory

public virtual string SubCategory { get; set; }
Gets or sets the SubCategory in which this object belongs. If HasSubCategory() returns false, this field has no meaning.
inherited fromGH_InstanceDescription
SubCategory

Type

public virtual Type Type { get; }
Gets the Framework Type descriptor for the stored Data.
inherited fromGH_Param<T>
Type

TypeName

public virtual string TypeName { get; }
Calls TypeName() on the first instance of T it can find. This is either an item in the volatile list, or a newly constructed instance.
inherited fromGH_Param<T>
Remarks: Override this for improved performance, but this function is only likely to be called from the GUI.
TypeName

VolatileData

public IGH_Structure VolatileData { get; }
inherited fromGH_Param<T>
VolatileData

VolatileDataCount

public int VolatileDataCount { get; }
inherited fromGH_Param<T>
VolatileDataCount

WireDisplay

public GH_ParamWireDisplay WireDisplay { get; set; }
Gets or sets the wire display style for this parameter. Wire display only affects the wires connected to the parameter input.
inherited fromGH_Param<T>
WireDisplay

Methods

AddedToDocument

public virtual void AddedToDocument(GH_Document document)
This method will be called when an object is added to a document. Override this method if you want to handle such events.
inherited fromGH_DocumentObject
document (GH_Document)Document that now owns this object.
AddedToDocument

AddPersistentData

[EditorBrowsable(EditorBrowsableState.Never)] public bool AddPersistentData(object data)
obsoleteThis method has been superceded by SetPersistenData overloads
Utility function to add a new persistent data item. If the data is null or cannot be converted into T, this method will fail. You should probably use the PersistentData property to add type-safe data if you can.
inherited fromGH_PersistentParam<T>
data (object)Data to add.
True on success, false on failure.

AddPersistentData

[EditorBrowsable(EditorBrowsableState.Never)] public bool AddPersistentData(T data)
obsoleteThis method has been superceded by SetPersistenData overloads
Utility function to add a new persistent data item. If the data is null or cannot be converted into T, this method will fail. You should probably use the PersistentData property to add type-safe data if you can.
inherited fromGH_PersistentParam<T>
data (T)Data to add.
True on success, false on failure.

AddRuntimeMessage

public virtual void AddRuntimeMessage(GH_RuntimeMessageLevel level, string text)
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.
inherited fromGH_ActiveObject
level (GH_RuntimeMessageLevel)Type of message. Only Warnings and Errors are recorded.
text (string)Content of message.
AddRuntimeMessage

AddSource

public virtual void AddSource(IGH_Param source, int index)
Insert a new Source parameter into the Sources list. Sources provide this parameter with data at runtime.
inherited fromGH_Param<T>
source (IGH_Param)Source to append.
index (int)Insertion index of source.
AddSource

AddSource

public virtual void AddSource(IGH_Param source)
Append a new Source parameter to the end of the Sources list. Sources provide this parameter with data at runtime.
inherited fromGH_Param<T>
source (IGH_Param)Source to append.
AddSource

AddVolatileData

public bool AddVolatileData(GH_Path path, int index, object data)
Inserts an item of volatile data into the data structure.
inherited fromGH_Param<T>
path (GH_Path)The branch path of the data. If the path doesn't exist yet, it will be created.
index (int)The item index of the data. If the path doesn't contain the index yet, it will be enlarged to encompass the index.
data (object)The data to store.
True on success, False on failure. If the data cannot be converted, the topology will remain unmolested.
AddVolatileData

AddVolatileData

public bool AddVolatileData(GH_Path path, int index, T data)
inherited fromGH_Param<T>
path (GH_Path)
index (int)
data (T)

AddVolatileDataList

public bool AddVolatileDataList(GH_Path path, IEnumerable list)
inherited fromGH_Param<T>
path (GH_Path)
list (IEnumerable)

AddVolatileDataList

public bool AddVolatileDataList(GH_Path path, List<T> list)
inherited fromGH_Param<T>
path (GH_Path)
list (List<T>)

AddVolatileDataTree

public bool AddVolatileDataTree(GH_Structure<T> tree)
inherited fromGH_Param<T>
tree (GH_Structure<T>)

AddVolatileDataTree

public bool AddVolatileDataTree(IGH_Structure tree)
inherited fromGH_Param<T>
tree (IGH_Structure)

AppendAdditionalMenuItems

public override void AppendAdditionalMenuItems(ToolStripDropDown menu)
inherited fromGH_PersistentParam<T>

AppendMenuItems

public override bool AppendMenuItems(ToolStripDropDown menu)
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.
inherited fromGH_ActiveObject
menu (ToolStripDropDown)Menu object to populate.
If true, the menu will be displayed, if false the menu will be supressed.

Cast_Object

protected T Cast_Object(object data)
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.
inherited fromGH_Param<T>
data (object)
The cast value or Nothing on failure.

ClearData

public override void ClearData()
inherited fromGH_Param<T>

ClearProxySources

public virtual void ClearProxySources()
Remove all proxy sources without attempting to relink them.
inherited fromGH_Param<T>
ClearProxySources

ClearRuntimeMessages

public virtual void ClearRuntimeMessages()
Destroy all warning and error lists
inherited fromGH_ActiveObject

CollectData

public sealed override void CollectData()
inherited fromGH_Param<T>

CollectVolatileData_Custom

protected sealed override void CollectVolatileData_Custom()
inherited fromGH_PersistentParam<T>

CollectVolatileData_FromSources

protected virtual void CollectVolatileData_FromSources()
This method collects volatile data from all the source parameters.
inherited fromGH_Param<T>

ComputeData

public sealed override void ComputeData()
inherited fromGH_Param<T>

ConnectNewObject

protected internal bool ConnectNewObject(IGH_DocumentObject obj)
inherited fromGH_Param<T>
obj (IGH_DocumentObject)

ConversionCallback

protected virtual void ConversionCallback(object source, T target)
This method is called whenever a successful conversion takes place from some source data into local target data. Override it if you wish to keep tabs on conversions.
inherited fromGH_Param<T>
source (object)Source data (never null).
target (T)Target data (never null).

CopyFrom

public void CopyFrom(IGH_InstanceDescription other)
Copy all fields (except the instance ID) from another instance description.
inherited fromGH_InstanceDescription
other (IGH_InstanceDescription)Object to mimic.

CreateAttributes

public override void CreateAttributes()
inherited fromGH_Param<T>

CreateProxySources

public virtual void CreateProxySources()
Convert all proper source parameters into proxy sources.
inherited fromGH_Param<T>
CreateProxySources

DependsOn

public override bool DependsOn(IGH_ActiveObject potential_source)
inherited fromGH_Param<T>
potential_source (IGH_ActiveObject)

DestroyIconCache

protected void DestroyIconCache()
Call this method to erase the existing icon cache. You must call this if you want to change the display icon of an object.
inherited fromGH_DocumentObject

DocumentContextChanged

public virtual void DocumentContextChanged(GH_Document document, GH_DocumentContext context)
This method will be called when the document that owns this object moves into a different context.
inherited fromGH_DocumentObject
document (GH_Document)Document that owns this object.
context (GH_DocumentContext)The reason for this event.

ExpireDownStreamObjects

protected override void ExpireDownStreamObjects()
inherited fromGH_Param<T>

ExpireOwner

[EditorBrowsable(EditorBrowsableState.Never)] public void ExpireOwner()
Utility method for expiring the owner component (if it exists).
inherited fromGH_Param<T>

ExpirePreview

public virtual void ExpirePreview(bool redraw)
Call this function when you suspect that the preview has expired for this object. This will cause the display cache to be eradicated.
inherited fromGH_DocumentObject
redraw (bool)
ExpirePreview

ExpireSolution

public override void ExpireSolution(bool recompute)
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.
inherited fromGH_ActiveObject
recompute (bool)If True, the document will be instructed to solve the new state.

ExpireSolutionTopLevel

public void ExpireSolutionTopLevel(bool recompute)
Invoke the Expiresolution(bool) method on the toplevel object.
inherited fromGH_Param<T>
recompute (bool)If true, a new computation will start right away.

Format

protected virtual string Format(T Data)
Returns "Null" if the data is a null reference, otherwise calls ToString() on the Data instance.
inherited fromGH_Param<T>
Data (T)

GetValue

protected bool GetValue(string valueName, bool default)
Get a boolean value from the component value table.
inherited fromGH_DocumentObject
valueName (string)Name of boolean to retrieve.
default (bool)Default value to return in case of missing named value.
The boolean value with the given name of the default value.

GetValue

protected Color GetValue(string valueName, Color default)
Get a color value from the component value table.
inherited fromGH_DocumentObject
valueName (string)Name of color to retrieve.
default (Color)Default value to return in case of missing named value.
The color value with the given name of the default value.

GetValue

protected double GetValue(string valueName, double default)
Get a double value from the component value table.
inherited fromGH_DocumentObject
valueName (string)Name of double to retrieve.
default (double)Default value to return in case of missing named value.
The double value with the given name of the default value.

GetValue

protected int GetValue(string valueName, int default)
Get an integer value from the component value table.
inherited fromGH_DocumentObject
valueName (string)Name of integer to retrieve.
default (int)Default value to return in case of missing named value.
The integer value with the given name of the default value.

GetValue

protected string GetValue(string valueName, string default)
Get a string value from the component value table.
inherited fromGH_DocumentObject
valueName (string)Name of string to retrieve.
default (string)Default value to return in case of missing named value.
The string value with the given name of the default value.

HtmlHelp_Source

protected internal virtual string HtmlHelp_Source()
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
inherited fromGH_DocumentObject
Remarks: You can use the GUI.GH_HtmlFormatter class to generate an HTML page which conforms to Grasshopper Help standards

InstantiateT

protected virtual T InstantiateT()
Attempts to instantiate a new instance of T.
inherited fromGH_Param<T>
Remarks: If T is an abstract class or if T has no default (empty) constructor, this function will ASSERT. In order to avoid a Try...Catch block performance impact, override this function and call the type constructor for T directly.
This function should return a newly constructed instance of T.

IsolateObject

public override void IsolateObject()
inherited fromGH_Param<T>

MovedBetweenDocuments

public virtual void MovedBetweenDocuments(GH_Document oldDocument, GH_Document newDocument)
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.
inherited fromGH_DocumentObject
oldDocument (GH_Document)Document that used to own this object.
newDocument (GH_Document)Document that now owns ths object.

NewInstanceGuid

public void NewInstanceGuid()
Generate a new random instance GUID
inherited fromGH_InstanceDescription
NewInstanceGuid

NewInstanceGuid

public void NewInstanceGuid(Guid UUID)
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.
inherited fromGH_InstanceDescription
UUID (Guid)
NewInstanceGuid

OnAttributesChanged

public void OnAttributesChanged()
Raises the AttributesChanged event on the toplevel object.
inherited fromGH_DocumentObject

OnDisplayExpired

public void OnDisplayExpired(bool redraw)
Raises the DisplayExpired event on the toplevel object.
inherited fromGH_DocumentObject
redraw (bool)If True, the canvas will be immediately redrawn.
OnDisplayExpired

OnObjectChanged

public void OnObjectChanged(GH_ObjectChangedEventArgs e)
inherited fromGH_DocumentObject
OnObjectChanged

OnObjectChanged

public void OnObjectChanged(GH_ObjectEventType eventType, object tag)
inherited fromGH_DocumentObject
eventType (GH_ObjectEventType)
tag (object)
OnObjectChanged

OnObjectChanged

public void OnObjectChanged(GH_ObjectEventType eventType)
inherited fromGH_DocumentObject
eventType (GH_ObjectEventType)
OnObjectChanged

OnObjectChanged

public void OnObjectChanged(string customEvent, object tag)
inherited fromGH_DocumentObject
customEvent (string)
tag (object)
OnObjectChanged

OnObjectChanged

public void OnObjectChanged(string customEvent)
inherited fromGH_DocumentObject
customEvent (string)
OnObjectChanged

OnPingDocument

public GH_Document OnPingDocument()
Raise the PingDocument Event on the toplevel object and try to find the document which owns this object.
inherited fromGH_DocumentObject
The document which owns this object if successful, or nothing if no document owns this object.
OnPingDocument

OnPreviewExpired

public void OnPreviewExpired(bool redraw)
Raises the PreviewExpired event on the toplevel object.
inherited fromGH_DocumentObject
redraw (bool)If True, the viewports will be immediately redrawn.
OnPreviewExpired

OnSolutionExpired

public void OnSolutionExpired(bool recompute)
Raises the SolutionExpired event on the toplevel object. You probably want to call ExpireSolution() instead of this method directly.
inherited fromGH_DocumentObject
recompute (bool)If True, the solution will be immediately recalculated.
OnSolutionExpired

OnVolatileDataCollected

protected virtual void OnVolatileDataCollected()
Once volatile data has been collected this method will be calles. The basic implementation does nothing, but you can add code here to post-process or analyze the volatile data.
inherited fromGH_Param<T>

PostProcessData

[EditorBrowsable(EditorBrowsableState.Never)] public virtual void PostProcessData()
Apply data post-processes (simplify, reverse, graft, flatten etc. as well as overridden processes).
inherited fromGH_Param<T>
PostProcessData

PreferredCast

#
protected override ObjectDraftingLineWidth PreferredCast(object data)
data (object)

PrepareForPrompt

protected virtual void PrepareForPrompt()
inherited fromGH_PersistentParam<T>

Preview_ComputeClippingBox

protected BoundingBox Preview_ComputeClippingBox()
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.
inherited fromGH_Param<T>
The clipping box for all valid items.

Preview_DrawMeshes

protected void Preview_DrawMeshes(IGH_PreviewArgs args)
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.
inherited fromGH_Param<T>
args (IGH_PreviewArgs)

Preview_DrawWires

protected void Preview_DrawWires(IGH_PreviewArgs args)
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.
inherited fromGH_Param<T>
args (IGH_PreviewArgs)

Prompt_ManageCollection

protected virtual bool Prompt_ManageCollection(GH_Structure<T> values)
inherited fromGH_PersistentParam<T>
values (GH_Structure<T>)

Prompt_Plural

#
protected override GH_GetterResult Prompt_Plural(ref List<ObjectDraftingLineWidth> values)

Prompt_Singular

#
protected override GH_GetterResult Prompt_Singular(ref ObjectDraftingLineWidth value)

Read

public override bool Read(GH_IReader reader)
inherited fromGH_PersistentParam<T>
reader (GH_IReader)
GH_Param<T>.Read

ReadFull

public virtual bool ReadFull(GH_IReader reader)
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.
inherited fromGH_InstanceDescription
reader (GH_IReader)Writer for deserialization.
True on success, false on failure.

RecordPersistentDataEvent

protected void RecordPersistentDataEvent(string name)
Add an undo record that stores changes to persistent data.
inherited fromGH_PersistentParam<T>
name (string)Name of undo record.

RecordUndoEvent

public Guid RecordUndoEvent(string undoName, IGH_UndoAction action)
Record a specific object change undo event.
inherited fromGH_DocumentObject
undoName (string)Name of undo record.
action (IGH_UndoAction)Undo action to record.
The ID of the newly added record or Guid.Empty on failure.
RecordUndoEvent

RecordUndoEvent

public Guid RecordUndoEvent(string undoName)
Record a generic object change undo event.
inherited fromGH_DocumentObject
undoName (string)Name of undo record.
The ID of the newly added record or Guid.Empty on failure.
RecordUndoEvent

RecordUndoEvent

public void RecordUndoEvent(GH_UndoRecord record)
Record an entire undo record.
inherited fromGH_DocumentObject
record (GH_UndoRecord)Record to push.
RecordUndoEvent

RecoverFromPrompt

protected virtual void RecoverFromPrompt()
inherited fromGH_PersistentParam<T>

RegisterRemoteIDs

public virtual void RegisterRemoteIDs(GH_GuidTable id_list)
Override this function if you want object changes in the Rhino document to trigger a new solution.
inherited fromGH_ActiveObject
id_list (GH_GuidTable)The object ID database Grasshopper is responsive to.
RegisterRemoteIDs

RegisterRemoteIDsUtil

protected void RegisterRemoteIDsUtil(GH_GuidTable table)
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.
inherited fromGH_Param<T>
table (GH_GuidTable)

RelinkProxySources

public virtual bool RelinkProxySources(GH_Document document)
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.
inherited fromGH_Param<T>
document (GH_Document)The document from which to harvest the real source parameters.
True on success, false on failure.
RelinkProxySources

RemoveAllSources

public virtual void RemoveAllSources()
Remove all sources from this parameter.
inherited fromGH_Param<T>
RemoveAllSources

RemovedFromDocument

public virtual void RemovedFromDocument(GH_Document document)
This method will be called when an object is removed from a document. Override this method if you want to handle such events.
inherited fromGH_DocumentObject
document (GH_Document)Document that now no longer owns this object.

RemoveEffects

public virtual void RemoveEffects()
Remove all post-process effects. Note to implementors, you must call the base method if you override this function.
inherited fromGH_Param<T>
RemoveEffects

RemoveSource

public virtual void RemoveSource(Guid source_id)
Remove the specified source from this parameter.
inherited fromGH_Param<T>
source_id (Guid)InstanceID of source to remove.
RemoveSource

RemoveSource

public virtual void RemoveSource(IGH_Param source)
Remove the specified source from this parameter.
inherited fromGH_Param<T>
source (IGH_Param)Source to remove.
RemoveSource

Render_AppendGeometry

protected void Render_AppendGeometry(GH_RenderArgs args)
This function has been emptied because it is Obsolete.
inherited fromGH_Param<T>
args (GH_RenderArgs)

ReplaceSource

public virtual void ReplaceSource(Guid old_source_id, IGH_Param new_source)
Replace an existing source with a new one. If the old_source does not exist in this parameter, nothing happens.
inherited fromGH_Param<T>
old_source_id (Guid)Source to replace.
new_source (IGH_Param)Source to replace with.
ReplaceSource

ReplaceSource

public virtual void ReplaceSource(IGH_Param old_source, IGH_Param new_source)
Replace an existing source with a new one. If the old_source does not exist in this parameter, nothing happens.
inherited fromGH_Param<T>
old_source (IGH_Param)Source to replace.
new_source (IGH_Param)Source to replace with.
ReplaceSource

RuntimeMessages

public virtual IList<string> RuntimeMessages(GH_RuntimeMessageLevel level)
Gets the list of cached runtime messages that were recorded during solver-time processes.
inherited fromGH_ActiveObject
level (GH_RuntimeMessageLevel)Runtime message type to retrieve.
A list of runtime message strings.
RuntimeMessages

Script_AddPersistentData

[EditorBrowsable(EditorBrowsableState.Never)] public void Script_AddPersistentData(List<object> data)
Method used primarily for COM_Access code.
inherited fromGH_PersistentParam<T>
data (List<object>)

Script_ClearPersistentData

[EditorBrowsable(EditorBrowsableState.Never)] public void Script_ClearPersistentData()
Method used primarily for COM_Access code.
inherited fromGH_PersistentParam<T>

SDKCompliancy

public virtual bool SDKCompliancy(int exeVersion, int exeServiceRelease)
Test whether this object is compliant with a given Rhino version.
inherited fromGH_ActiveObject
exeVersion (int)Rhino major release (4, 5, ...).
exeServiceRelease (int)Rhino minor (service) release.
True if this object is compliant with the given Rhino release.
SDKCompliancy

SetIconOverride

public void SetIconOverride(Bitmap customIcon)
Set a new custom icon override for this object.
inherited fromGH_DocumentObject
customIcon (Bitmap)Icon override. Should be a 24x24 image.

SetPersistentData

public void SetPersistentData(GH_Structure<T> items)
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.
inherited fromGH_PersistentParam<T>
items (GH_Structure<T>)Items to add.

SetPersistentData

public void SetPersistentData(IEnumerable<T> items)
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.
inherited fromGH_PersistentParam<T>
items (IEnumerable<T>)Items to add.

SetPersistentData

public void SetPersistentData(params object[] values)
Add a collection of values to the persistent data.
inherited fromGH_PersistentParam<T>
values (params object[])Values to add.

SetPersistentData

public void SetPersistentData(T item)
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.
inherited fromGH_PersistentParam<T>
item (T)Item to add.

SetPrincipal

public bool SetPrincipal(bool set, bool recordUndo, bool recompute)
Set the principal parameter state.
inherited fromGH_Param<T>
set (bool)
recordUndo (bool)
recompute (bool)

SetValue

protected void SetValue(string valueName, bool value)
Set a named value. This value will be serialized with the component.
inherited fromGH_DocumentObject
valueName (string)Name of value.
value (bool)Value itself.

SetValue

protected void SetValue(string valueName, Color value)
Set a named value. This value will be serialized with the component.
inherited fromGH_DocumentObject
valueName (string)Name of value.
value (Color)Value itself.

SetValue

protected void SetValue(string valueName, double value)
Set a named value. This value will be serialized with the component.
inherited fromGH_DocumentObject
valueName (string)Name of value.
value (double)Value itself.

SetValue

protected void SetValue(string valueName, int value)
Set a named value. This value will be serialized with the component.
inherited fromGH_DocumentObject
valueName (string)Name of value.
value (int)Value itself.

SetValue

protected void SetValue(string valueName, string value)
Set a named value. This value will be serialized with the component.
inherited fromGH_DocumentObject
valueName (string)Name of value.
value (string)Value itself.

TriggerAutoSave

public void TriggerAutoSave()
Triggers the AutoSave function on the owner document with the object_changed flag.
inherited fromGH_DocumentObject
TriggerAutoSave

TriggerAutoSave

public void TriggerAutoSave(GH_AutoSaveTrigger trigger, Guid id)
Triggers the AutoSave function on the owner document with a custom flag.
inherited fromGH_DocumentObject
trigger (GH_AutoSaveTrigger)Reason for the autosave operation. It is possible that a user has decided to avoid autosave events for specific types, so if you can, try and provide a correct trigger flag.
id (Guid)ID of autosave event. Consecutive autosave requests with the same ID will be ignored.
TriggerAutoSave

TriggerAutoSave

public void TriggerAutoSave(GH_AutoSaveTrigger trigger)
Triggers the AutoSave function on the owner document with a custom flag.
inherited fromGH_DocumentObject
trigger (GH_AutoSaveTrigger)Reason for the autosave operation. It is possible that a user has decided to avoid autosave events for specific types, so if you can, try and provide a correct trigger flag.
TriggerAutoSave

TriggerAutoSave

public void TriggerAutoSave(Guid id)
Triggers the AutoSave function on the owner document with the object_changed flag.
inherited fromGH_DocumentObject
id (Guid)ID of autosave event. Consecutive autosave requests with the same ID will be ignored.
TriggerAutoSave

ValuesChanged

protected virtual void ValuesChanged()
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.
inherited fromGH_DocumentObject

VolatileDataDescription

protected virtual string VolatileDataDescription()
This method is called to populate the Tooltip data description field.
inherited fromGH_Param<T>

Write

public override bool Write(GH_IWriter writer)
inherited fromGH_PersistentParam<T>
writer (GH_IWriter)

WriteFull

public virtual bool WriteFull(GH_IWriter writer)
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.
inherited fromGH_InstanceDescription
writer (GH_IWriter)Writer for serialization.
True on success, false on failure.

Events

AttributesChanged

public event IGH_DocumentObject.AttributesChangedEventHandler AttributesChanged
Raised whenever the number or kind of attributes changes. This event is handled by GH_Documents who subsequently wipe their attribute caches.
inherited fromGH_DocumentObject
AttributesChanged

DisplayExpired

Raised whenever the display (on the Canvas) of a certain object becomes invalid.
inherited fromGH_DocumentObject
DisplayExpired

PingDocument

Raised whenever an object needs to know which GH_Document it belongs to.
inherited fromGH_DocumentObject
PingDocument

PreviewExpired

Raised whenever the display (in the Rhino viewports) of a certain object becomes invalid.
inherited fromGH_DocumentObject
PreviewExpired

SolutionExpired

public event IGH_DocumentObject.SolutionExpiredEventHandler SolutionExpired
Raised whenever the solution of a certain object becomes invalid.
inherited fromGH_DocumentObject
SolutionExpired