Class: Sketchup::OptionsProvider

Inherits:
Object
  • Object
show all
Includes:
Enumerable
Defined in:
lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb

Overview

An OptionsProvider class provides various kinds of options on a Model. You get an OptionsProvider from the OptionsManager. The options are given as name/value pairs.

List of keys added in different SketchUp versions:

UnitsOptions

  • AreaUnit (SketchUp 2019.2)

  • VolumeUnit (SketchUp 2019.2)

  • AreaPrecision (SketchUp 2020.0)

  • VolumePrecision (SketchUp 2020.0)

The AreaUnit and VolumeUnit options in UnitsOptions only applies if the UnitFormat is Length::Decimal.

Version:

  • SketchUp 6.0

Instance Method Summary collapse

Instance Method Details

#[](index) ⇒ Object #[](name) ⇒ Object

The [] method is used to get a value by name or index of the key.

Examples:

model = Sketchup.active_model
manager = model.options
provider = manager[0]
# Retrieves the provider at index 1
option = provider[1]

Overloads:

  • #[](index) ⇒ Object

    Returns value - the value if successful.

    Parameters:

    • index —

      The index for a specific key.

    Returns:

    • value - the value if successful

  • #[](name) ⇒ Object

    Returns value - the value if successful.

    Parameters:

    • name —

      The name of the specific key.

    Returns:

    • value - the value if successful

Version:

  • SketchUp 6.0



47
48
 
# File 'lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb', line 47

def [](arg)
end

#[]=(key, value) ⇒ Object

The []= method is used to set the value of a specific key.

Creates a new attribute for the given key if needed.

Examples:

option = provider[1]=10

Parameters:

  • key —

    The valid key.

  • value —

    The value to be set.

Returns:

  • value - the value that was set if successful, or false if unsuccessful.

Version:

  • SketchUp 6.0



67
68
 
# File 'lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb', line 67

def []=(key, value)
end

#add_observer(observer) ⇒ Object

The add_observer method is used to add an observer to the current object.

Examples:

status = object.add_observer observer

Parameters:

  • observer —

    An observer.

Returns:

  • true if successful, false if unsuccessful.

Version:

  • SketchUp 6.0



81
82
 
# File 'lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb', line 81

def add_observer(observer)
end

#count ⇒ Integer

Note:

Since SketchUp 2014 the count method is inherited from Ruby’s Enumerable mix-in module. Prior to that the #count method is an alias for #length.

Examples:

optionsprovider = Sketchup.active_model.options['UnitsOptions']
number = optionsprovider.count

Returns:

  • (Integer)

See Also:

Version:

  • SketchUp 6.0



98
99
 
# File 'lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb', line 98

def count
end

#each {|key, value| ... } ⇒ nil

The #each method is used to iterate through all of the options.

Examples:

model = Sketchup.active_model
provider = model.options['UnitsOptions']
provider.each { |key, value| puts "#{key} = #{value}" }

Yield Parameters:

Returns:

  • (nil)

See Also:

Version:

  • SketchUp 6.0



117
118
 
# File 'lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb', line 117

def each
end

#each_key {|key| ... } ⇒ nil

The #each_key method is used to iterate through all of the attribute keys.

Examples:

provider.each_key { |key| puts key }

Yield Parameters:

Returns:

  • (nil)

Version:

  • SketchUp 6.0



130
131
 
# File 'lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb', line 130

def each_key
end

#each_pair {|key, value| ... } ⇒ nil

The #each method is used to iterate through all of the options.

Examples:

model = Sketchup.active_model
provider = model.options['UnitsOptions']
provider.each { |key, value| puts "#{key} = #{value}" }

Yield Parameters:

Returns:

  • (nil)

See Also:

Version:

  • SketchUp 6.0



149
150
 
# File 'lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb', line 149

def each_pair
end

#each_value {|value| ... } ⇒ nil

The #each_value method is used to iterate through all of the attribute values.

Examples:

provider.each_value { |value| puts value }

Yield Parameters:

  • value (Object)

Returns:

  • (nil)

Version:

  • SketchUp 6.0



163
164
 
# File 'lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb', line 163

def each_value
end

#has_key?(name) ⇒ Boolean

The #has_key? method is an alias for #key?.

Examples:

model = Sketchup.active_model
provider = model.options['UnitsOptions']
p provider.has_key?("LengthFormat")

Parameters:

  • name (String) —

    The name of the key you are looking for.

Returns:

  • (Boolean)

See Also:

Version:

  • SketchUp 6.0



181
182
 
# File 'lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb', line 181

def has_key?(name)
end

#key?(name) ⇒ Boolean

The #key? method is used to determine if the options provider has a specific key.

Examples:

model = Sketchup.active_model
provider = model.options['UnitsOptions']
p provider.key?("LengthFormat")

Parameters:

  • name (String) —

    The name of the key you are looking for.

Returns:

  • (Boolean)

See Also:

Version:

  • SketchUp 6.0



200
201
 
# File 'lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb', line 200

def key?(name)
end

#keys ⇒ Object

The #keys method is used to retrieve an array with all of the attribute keys.

Examples:

keys = provider.keys
key = keys[0]

Returns:

  • keys - an array of keys within the options provider if successful

Version:

  • SketchUp 6.0



213
214
 
# File 'lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb', line 213

def keys
end

#length ⇒ Integer

The #length method is an alias of #size.

Examples:

optionsprovider = Sketchup.active_model.options['UnitsOptions']
number = optionsprovider.length

Returns:

  • (Integer)

See Also:

Version:

  • SketchUp 2014



227
228
 
# File 'lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb', line 227

def length
end

#name ⇒ Object

The name method is used to retrieve the name of an options provider.

Examples:

name = provider.name

Returns:

  • name - the name of the options provider if successful

Version:

  • SketchUp 6.0



238
239
 
# File 'lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb', line 238

def name
end

#remove_observer(observer) ⇒ Object

The remove_observer method is used to remove an observer from the current object.

Examples:

status = object.remove_observer observer

Parameters:

  • observer —

    An observer.

Returns:

  • true if successful, false if unsuccessful.

Version:

  • SketchUp 6.0



253
254
 
# File 'lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb', line 253

def remove_observer(observer)
end

#size ⇒ Integer

The #size method is used to retrieve the size (number of elements) of an options provider.

Examples:

optionsprovider = Sketchup.active_model.options['UnitsOptions']
number = optionsprovider.size

Returns:

  • (Integer)

See Also:

Version:

  • SketchUp 6.0



268
269
 
# File 'lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb', line 268

def size
end