sketchup-api-stubs 0.7.9 → 0.7.11

data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsManager.rb

@@ -1,130 +1,133 @@
-# Copyright:: Copyright 2023 Trimble Inc.
-# License:: The MIT License (MIT)
-
-# The OptionsManager class manages various kinds of OptionsProviders on a
-# Model.
-#
-# @version SketchUp 6.0
-class Sketchup::OptionsManager
-
-  # Includes
-
-  include Enumerable
-
-  # Instance Methods
-
-  # The [] method is used to get an option provider by name or index.
-  #
-  # For example, to get the UnitsOptions on the Model, you could use the
-  # command:
-  #
-  # @example
-  #   Sketchup.active_model.options["UnitsOptions"]
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   manager = model.options
-  #   provider = manager[0]
-  #   if (provider)
-  #     UI.messagebox provider.name
-  #   else
-  #     UI.messagebox "Failure"
-  #   end
-  #
-  # @overload [](index)
-  #
-  #   @param index         The index of the OptionsProvider object.
-  #   @return              optionprovider - an OptionsProvider object if
-  #                        successful, otherwise nil.
-  #
-  # @overload [](name)
-  #
-  #   @param name          The name of the OptionsProvider object.
-  #   @return              optionprovider - an OptionsProvider object if
-  #                        successful, otherwise nil.
-  #
-  # @version SketchUp 6.0
-  def [](arg)
-  end
-
-  #
-  # @example
-  #   optionsmanager = Sketchup.active_model.options
-  #   number = manager.count
-  #
-  # @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}.
-  #
-  # @return integer - number of OptionsProvider objects if
-  #   successful
-  #
-  # @see #length
-  #
-  # @version SketchUp 6.0
-  def count
-  end
-
-  # The {#each} method is used to iterate through options providers.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   manager = model.options
-  #   manager.each { |provider| puts provider.name }
-  #
-  # @return [nil]
-  #
-  # @version SketchUp 6.0
-  #
-  # @yieldparam [Sketchup::OptionsProvider] provider
-  def each
-  end
-
-  # The keys method is used to get a list of keys in the OptionsManager.
-  #
-  # @example
-  #   model = Sketchup.active_model
-  #   manager = model.options
-  #   optionproviderarray = manager.keys
-  #   if (optionproviderarray)
-  #     UI.messagebox optionproviderarray
-  #   else
-  #     UI.messagebox "Failure"
-  #   end
-  #
-  # @return keys - Array of string keys
-  #
-  # @version SketchUp 6.0
-  def keys
-  end
-
-  # The {#length} method is an alias of {#size}.
-  #
-  # @example
-  #   optionsmanager = Sketchup.active_model.options
-  #   number = manager.length
-  #
-  # @return [Integer]
-  #
-  # @see #size
-  #
-  # @version SketchUp 2014
-  def length
-  end
-
-  # The {#size} method returns the number of {OptionsProvider} objects inside
-  # this {OptionsManager}.
-  #
-  # @example
-  #   optionsmanager = Sketchup.active_model.options
-  #   number = manager.size
-  #
-  # @return [Integer]
-  #
-  # @see #length
-  #
-  # @version SketchUp 6.0
-  def size
-  end
-
-end
+# Copyright:: Copyright 2026 Trimble Inc.
+# License:: The MIT License (MIT)
+
+# The OptionsManager class manages various kinds of OptionsProviders on a
+# Model.
+#
+# To get the OptionsProvider key list, run the following code in the ruby console:
+#
+# @example
+#   options_manager = Sketchup.active_model.options
+#   options_manager.keys.each { |provider_name|
+#     options_provider = options_manager[provider_name]
+#     puts provider_name
+#     options_provider.each { |key, value|
+#       puts "  #{key} - #{value}"
+#     }
+#     puts
+#   }
+#
+# @version SketchUp 6.0
+class Sketchup::OptionsManager
+
+  # Includes
+
+  include Enumerable
+
+  # Instance Methods
+
+  # The [] method is used to get an option provider by name or index.
+  #
+  # For example, to get the UnitsOptions on the Model, you could use the
+  # command:
+  #
+  # @example
+  #   Sketchup.active_model.options["UnitsOptions"]
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   manager = model.options
+  #   provider = manager[0]
+  #
+  # @overload [](index)
+  #
+  #   @param index         The index of the OptionsProvider object.
+  #   @return              optionprovider - an OptionsProvider object if
+  #                        successful, otherwise nil.
+  #
+  # @overload [](name)
+  #
+  #   @param name          The name of the OptionsProvider object.
+  #   @return              optionprovider - an OptionsProvider object if
+  #                        successful, otherwise nil.
+  #
+  # @version SketchUp 6.0
+  def [](arg)
+  end
+
+  #
+  # @example
+  #   optionsmanager = Sketchup.active_model.options
+  #   number = manager.count
+  #
+  # @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}.
+  #
+  # @return integer - number of OptionsProvider objects if
+  #   successful
+  #
+  # @see #length
+  #
+  # @version SketchUp 6.0
+  def count
+  end
+
+  # The {#each} method is used to iterate through options providers.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   manager = model.options
+  #   manager.each { |provider| puts provider.name }
+  #
+  # @return [nil]
+  #
+  # @version SketchUp 6.0
+  #
+  # @yieldparam [Sketchup::OptionsProvider] provider
+  def each
+  end
+
+  # The keys method is used to get a list of keys in the OptionsManager.
+  #
+  # @example
+  #   model = Sketchup.active_model
+  #   manager = model.options
+  #   optionproviderarray = manager.keys
+  #
+  # @return keys - Array of string keys
+  #
+  # @version SketchUp 6.0
+  def keys
+  end
+
+  # The {#length} method is an alias of {#size}.
+  #
+  # @example
+  #   optionsmanager = Sketchup.active_model.options
+  #   number = manager.length
+  #
+  # @return [Integer]
+  #
+  # @see #size
+  #
+  # @version SketchUp 2014
+  def length
+  end
+
+  # The {#size} method returns the number of {OptionsProvider} objects inside
+  # this {OptionsManager}.
+  #
+  # @example
+  #   optionsmanager = Sketchup.active_model.options
+  #   number = manager.size
+  #
+  # @return [Integer]
+  #
+  # @see #length
+  #
+  # @version SketchUp 6.0
+  def size
+  end
+
+end