Extension

class Extension

Parent: Object | Class Index
Methods: new, copyright, copyright= creator, creator=, description, description=, load, name, name=, version, version= |
Sample Code: utilities.rb |

The Extension class contains methods allowing you to create and manipulate SketchUp extensions. Extensions are Ruby scripts that can be loaded and unloaded using the Extension manager (Extensions panel of the Preferences dialog box). Generally you should register your ruby scripts as an extension to give SketchUp users the ability to disable it through the user interface.

Class Methods

new
The new method is used to create a new SketchupExtension class.
Syntax:
sketchupextension = SketchupExtension.new "Title" "path"
Arguments:
"Title" - the title for the new extension that will appear in the Extensions portion of the Preferences dialog box. "path" - the relative path to the extension.
Return Value:
sketchupextennsion - the new SketchupExtension object
Comments:
Example:
extension = SketchupExtension.new "Stair Tools" "utilities/stairTools.rb"

Instance Methods

creator
The creator method is used to get the value for the creator of an extension.
Syntax:
creator = sketchupextension.creator
Arguments:
Return Value:
creator - a string representing the creator of the extension.
Comments:
The default creator string is "@Last Software." Change the creator using the creator= method if the creator of the extension is other than @Last Software.
Example:
creator = se.creator

creator=
The creator= method is used to set the value for the creator of an extension.
Syntax:
creator = sketchupextension.creator= "CreatorName"
Arguments:
"CreatorName" - a string representing the name of the extension's creator
Return Value:
creator - a string representing the creator of the extension.
Comments:
The default creator string is "@Last Software." Change the creator using the creator= method if the creator of the extension is other than @Last Software.
Example:
utilitiesExtension.creator=$uStrings.GetString("Fred Smith")

copyright
The copyright method is used to get the value for the copyright of an extension.
Syntax:
copyright = sketchupextension.copyright
Arguments:
Return Value:
copyright - a string representing the copyright of the extension.
Comments:
The default copyright string is "2005, @Last Software." Change the copyright using the copyright= method if the copyright of the extension is other than 2005, @Last Software.
Example:
copyright = se.copyright

copyright=
The copyright= method is used to set the value for the copyright of an extension.
Syntax:
copyright = sketchupextension.copyright = "Copyright"
Arguments:
Copyright - a string representing the copyright of the extension.
Return Value:
copyright - a string representing the copyright of the extension.
Comments:
Example:
utilitiesExtension.copyright=$uStrings.GetString("2004-2005 Joe Software")

description
The description method is used to get the value for the description of an extension.
Syntax:
description = sketchupextension.description
Arguments:
Return Value:
description - a string representing the description of the extension.
Comments:
Example:
description = se.description

description=
The description= method is used to set the value for the description of an extension.
Syntax:
description = sketchupextension.description = "Description"
Arguments:
Description - a string representing the description of the extension.
Return Value:
description - a string representing the description of the extension.
Comments:
Example:
utilitiesExtension.description=$uStrings.GetString("Adds Tools->Utilities to the SketchUp inteface. The Utilities submenu contains two tools: Create Face and Query Tool.")

load
The load method is used to
Syntax:
Arguments:
Return Value:
Comments:
Example:

name
The name method is used to get the value for the name of an extension.
Syntax:
name= sketchupextension.name
Arguments:
Return Value:
name - a string representing the name of the extension.
Comments:
Example:
name = se.name

name=
The name= method is used to set the value for the name of an extension.
Syntax:
name= sketchupextension.name= "Name"
Arguments:
Name - a string representing the name of the extension.
Return Value:
name - a string representing the name of the extension.
Comments:
Example:
utilitiesExtension.name=$uStrings.GetString("Stair Tool")

version
The version method is used to get the value for the name of an version.
Syntax:
version= sketchupextension.version
Arguments:
Return Value:
version - a string representing the name of the version
Comments:
The default version string is "1.0" Change the creator using the version= method if the version of the extension is other than 1.0.
Example:
version = se.version

version=
The version= method is used to set the value for the version of an extension.
Syntax:
version = sketchupextension.version= "Version"
Arguments:
Version - a string representing the version of the extension.
Return Value:
version - a string representing the version of the extension.
Comments:
Example:
utilitiesExtension.version=$uStrings.GetString("1.0")