Class: Ruber::SettingsDialog

Dialog used to change the options contained in an SettingsContainer. It is a specialized KDE::PageDialog.

The widgets added to the option container are displayed in pages corresponding to the captions included in the widgets’ description. If more than one widget has the same caption, they’re displayed in the same page, one below the other (using a Qt::VBoxLayout). The icon used for each page is the first one found among the widgets in that page.

The process of keeping the options in sync between the widgets and the option container can be automatized using the functionality provided by the internal SettingsDialogManager. If this automatic management can’t be achieved for a particular option (for example, because the value should be obtained combining the data of more than one widget), you can still automatically manage the other widgets and integrate the manual management of the widgets which need it with the automatic management. To do so, you’ll need to define a read_settings, a store_settings and a read_default_settings method in your widget. In this case, you can access the dialog using the @settings_dialog instance variable, which is created by this class when the widget is created.

===Manual option management example Suppose you have an option called :default_path in the :general group which stores a path. In your widget, however, the path is split in two parts: the directory and the filename, which are shown in two line edit widgets, called respectively default_dir_widget and default_file_widget. Since the automatic option management system assumes that each option corresponds to a single widget, you can’t use it. So, you define a read_settings, a store_settings and a read_default_settings method in your widget class like this:

class MyWidget < Qt::Widget</code>

<code>  def initialize parent = nil
    super
    @default_dir_widget = KDE::LineEdit.new self
    @default_file_widget = KDE::LineEdit.new self
  end</code>

<code>  def read_settings
    path = @settings_dialog.settings_container[:general, :default_path]
    @default_dir_widget.text = File.dirname(path)
    @default_file_widget.text = File.basename(path)
  end</code>
  
<code>  def store_settings
    path = File.join @default_dir_widget.text, @default_file_widget.text
    @settings_dialog.settings_container[:general, :default_path] = path
  end</code>
  
<code>  def read_default_settings
    path = @settings_dialog.settings_container.default(:general, :default_path)
    @default_dir_widget.text = File.dirname(path)
    @default_file_widget.text = File.basename(path)
  end</code>

<code>end

Note that the @settings_dialog instance variable has been automatically created by the dialog when the widget has been created and contains a reference to the dialog itself.