wxruby3 0.9.0-x64-mingw-ucrt → 0.9.2-x64-mingw-ucrt

data/lib/wx/doc/gen/evt_handler.rb

@@ -9,7 +9,6 @@ module Wx
   # A class that can handle events from the windowing system.
   # {Wx::Window} is (and therefore all window classes are) derived from this class.
   # When events are received, {Wx::EvtHandler} invokes the method listed in the event table using itself as the object. When using multiple inheritance <b>it is imperative that the {Wx::EvtHandler}(-derived) class is the first class inherited</b> such that the this pointer for the overall object will be identical to the this pointer of the {Wx::EvtHandler} portion.
-  # === 
   # 
   # Category:  {Wx::Events}
   # @see How Events are Processed
@@ -94,7 +93,11 @@ module Wx
     alias_method :previous_handler, :get_previous_handler
     
     # Enables or disables the event handler.
-    # You can use this function to avoid having to remove the event handler from the chain, for example when implementing a dialog editor and changing from edit to test mode.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>You can use this function to avoid having to remove the event handler from the chain, for example when implementing a dialog editor and changing from edit to test mode.
+    # </p>
+    # </div>>
     # @see Wx::EvtHandler#get_evt_handler_enabled 
     # @param enabled [Boolean]  true if the event handler is to be enabled, false if it is to be disabled.
     # @return [void]
@@ -102,11 +105,16 @@ module Wx
     alias_method :evt_handler_enabled=, :set_evt_handler_enabled
     
     # Sets the pointer to the next handler.
-    # See {Wx::EvtHandler#process_event} for more info about how the chains of event handlers are internally used. Also remember that {Wx::EvtHandler} uses double-linked lists and thus if you use this function, you should also call {Wx::EvtHandler#set_previous_handler} on the argument passed to this function: 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>See {Wx::EvtHandler#process_event} for more info about how the chains of event handlers are internally used. Also remember that {Wx::EvtHandler} uses double-linked lists and thus if you use this function, you should also call {Wx::EvtHandler#set_previous_handler} on the argument passed to this function: 
     # ```ruby
     #   handlerA.set_next_handler(handlerB)
     #   handlerB.set_previous_handler(handlerA)
     # ```
+    # 
+    # </p>
+    # </div>>
     # @see How Events are Processed 
     # @param handler [Wx::EvtHandler]  The event handler to be set as the next handler. Cannot be NULL.
     # @return [void]

data/lib/wx/doc/gen/ext_help_controller.rb

@@ -11,12 +11,12 @@ module Wx
   # The map file contains two or three fields per line: numeric_id relative_URL [; comment/documentation]
   # The numeric_id is the id used to look up the entry in {Wx::ExtHelpController#display_section}/DisplayBlock(). The relative_URL is a filename of an html file, relative to the help directory. The optional comment/documentation field (after a ';') is used for keyword searches, so some meaningful text here does not hurt. If the documentation itself contains a ';', only the part before that will be displayed in the listbox, but all of it used for search.
   # Lines starting with ';' will be ignored.
-  # === 
   # 
   # Category:  {Wx::HELP}
   # @see Wx::HelpController 
   # 
   # 
+  # @wxrb_require USE_HELP
   class ExtHelpController < Object
   
     # @param parentWindow [Wx::Window] 

data/lib/wx/doc/gen/file_ctrl.rb

@@ -0,0 +1,209 @@
+# :stopdoc:
+# This file is automatically generated by the WXRuby3 documentation 
+# generator. Do not alter this file.
+# :startdoc:
+
+
+module Wx
+
+  # 
+  FC_DEFAULT_STYLE = 1
+  
+  # 
+  # 
+  FC_OPEN = 1
+  
+  # 
+  # 
+  FC_SAVE = 2
+  
+  # 
+  # 
+  FC_MULTIPLE = 4
+  
+  # 
+  # 
+  FC_NOSHOWHIDDEN = 8
+  
+  # 
+  # 
+  EVT_FILECTRL_SELECTIONCHANGED = 10173
+  
+  # 
+  # 
+  EVT_FILECTRL_FILEACTIVATED = 10174
+  
+  # 
+  # 
+  EVT_FILECTRL_FOLDERCHANGED = 10175
+  
+  # 
+  # 
+  EVT_FILECTRL_FILTERCHANGED = 10176
+  
+  # This control allows the user to select a file.
+  # Two implementations of this class exist, one for Gtk and another generic one for all the other ports.
+  # This class is only available if {Wx::Setup::USE_FILECTRL} is set to 1.
+  # ### Styles
+  # 
+  # This class supports the following styles:
+  # 
+  # - {Wx::FC_DEFAULT_STYLE}: The default style: {Wx::FC_OPEN} 
+  # 
+  # - {Wx::FC_OPEN}: Creates an file control suitable for opening files. Cannot be combined with {Wx::FC_SAVE}. 
+  # 
+  # - {Wx::FC_SAVE}: Creates an file control suitable for saving files. Cannot be combined with {Wx::FC_OPEN}. 
+  # 
+  # - {Wx::FC_MULTIPLE}: For open control only, Allows selecting multiple files. Cannot be combined with {Wx::FC_SAVE} 
+  # 
+  # - {Wx::FC_NOSHOWHIDDEN}: Hides the "Show Hidden Files" checkbox (Generic only) 
+  # 
+  # ### Events emitted by this class
+  # 
+  # The following event-handler methods redirect the events to member method or handler blocks for {Wx::FileCtrlEvent} events.
+  # Event handler methods for events emitted by this class:
+  # 
+  # - {Wx::EvtHandler#evt_filectrl_fileactivated}(id, meth = nil, &block): The user activated a file(by double-clicking or pressing Enter) 
+  # 
+  # - {Wx::EvtHandler#evt_filectrl_selectionchanged}(id, meth = nil, &block): The user changed the current selection(by selecting or deselecting a file) 
+  # 
+  # - {Wx::EvtHandler#evt_filectrl_folderchanged}(id, meth = nil, &block): The current folder of the file control has been changed 
+  # 
+  # - {Wx::EvtHandler#evt_filectrl_filterchanged}(id, meth = nil, &block): The current file filter of the file control has been changed. 
+  # 
+  # Category:  {Wx::Controls}  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> WXMSW Appearance
+  #   </td><td> WXGTK Appearance
+  #   </td><td> WXOSX Appearance
+  #   </td></tr></table></div>
+  # Implementations:  native under WXGTK port; a generic implementation is used elsewhere.
+  # @see Wx::GenericDirCtrl 
+  # 
+  # 
+  # @wxrb_require USE_FILECTRL
+  class FileCtrl < Control
+  
+    # @overload initialize()
+    #   @return [Wx::FileCtrl]
+    # @overload initialize(parent, id, defaultDirectory=(''), defaultFilename=(''), wildCard=Wx::FILE_SELECTOR_DEFAULT_WILDCARD_STR, style=Wx::FC_DEFAULT_STYLE, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, name=Wx::FILE_CTRL_NAME_STR)
+    #   Constructs the window.
+    #   @param parent [Wx::Window]  Parent window, must not be non-NULL.
+    #   @param id [Integer]  The identifier for the control.
+    #   @param defaultDirectory [String]  The initial directory shown in the control. Must be a valid path to a directory or the empty string. In case it is the empty string, the current working directory is used.
+    #   @param defaultFilename [String]  The default filename, or the empty string.
+    #   @param wildCard [String]  A wildcard specifying which files can be selected, such as "*.*" or "BMP files (*.bmp)|*.bmp|GIF files (*.gif)|*.gif".
+    #   @param style [Integer]  The window style, see {Wx::FC_}* flags.
+    #   @param pos [Array(Integer, Integer), Wx::Point]  Initial position.
+    #   @param size [Array(Integer, Integer), Wx::Size]  Initial size.
+    #   @param name [String]  Control name.
+    #   @return [Wx::FileCtrl]
+    def initialize(*args) end
+    
+    # Create function for two-step construction.
+    # See {Wx::FileCtrl#initialize} for details.
+    # true if the control was successfully created or false if creation failed.
+    # @param parent [Wx::Window] 
+    # @param id [Integer] 
+    # @param defaultDirectory [String] 
+    # @param defaultFilename [String] 
+    # @param wildCard [String] 
+    # @param style [Integer] 
+    # @param pos [Array(Integer, Integer), Wx::Point] 
+    # @param size [Array(Integer, Integer), Wx::Size] 
+    # @param name [String] 
+    # @return [Boolean]
+    def create(parent, id, defaultDirectory=(''), defaultFilename=(''), wildCard=Wx::FILE_SELECTOR_DEFAULT_WILDCARD_STR, style=Wx::FC_DEFAULT_STYLE, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, name=Wx::FILE_CTRL_NAME_STR) end
+    
+    # Returns the current directory of the file control (i.e. the directory shown by it).
+    # @return [String]
+    def get_directory; end
+    alias_method :directory, :get_directory
+    
+    # Returns the currently selected filename.
+    # For the controls having the {Wx::FC_MULTIPLE} style, use {Wx::FileCtrl#get_filenames} instead.
+    # @return [String]
+    def get_filename; end
+    alias_method :filename, :get_filename
+    
+    # Fills the array filenames with the filenames only of selected items.
+    # This function should only be used with the controls having the {Wx::FC_MULTIPLE} style, use {Wx::FileCtrl#get_filename} for the others.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>filenames is emptied first. 
+    # </p>
+    # </div>>
+    # @return [Array<String>]
+    def get_filenames; end
+    alias_method :filenames, :get_filenames
+    
+    # Returns the zero-based index of the currently selected filter.
+    # @return [Integer]
+    def get_filter_index; end
+    alias_method :filter_index, :get_filter_index
+    
+    # Returns the full path (directory and filename) of the currently selected file.
+    # For the controls having the {Wx::FC_MULTIPLE} style, use {Wx::FileCtrl#get_paths} instead.
+    # @return [String]
+    def get_path; end
+    alias_method :path, :get_path
+    
+    # Fills the array paths with the full paths of the files chosen.
+    # This function should be used with the controls having the {Wx::FC_MULTIPLE} style, use {Wx::FileCtrl#get_path} otherwise.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>paths is emptied first. 
+    # </p>
+    # </div>>
+    # @return [Array<String>]
+    def get_paths; end
+    alias_method :paths, :get_paths
+    
+    # Returns the current wildcard.
+    # @return [String]
+    def get_wildcard; end
+    alias_method :wildcard, :get_wildcard
+    
+    # Sets(changes) the current directory displayed in the control.
+    # Returns true on success, false otherwise.
+    # @param directory [String] 
+    # @return [Boolean]
+    def set_directory(directory) end
+    alias_method :directory=, :set_directory
+    
+    # Selects a certain file.
+    # Returns true on success, false otherwise
+    # @param filename [String] 
+    # @return [Boolean]
+    def set_filename(filename) end
+    alias_method :filename=, :set_filename
+    
+    # Changes to a certain directory and selects a certain file.
+    # If path includes the directory part, it must exist, otherwise false is returned and nothing else is done.
+    # Returns true on success, false otherwise
+    # @param path [String] 
+    # @return [Boolean]
+    def set_path(path) end
+    alias_method :path=, :set_path
+    
+    # Sets the current filter index, starting from zero.
+    # @param filterIndex [Integer] 
+    # @return [void]
+    def set_filter_index(filterIndex) end
+    alias_method :filter_index=, :set_filter_index
+    
+    # Sets the wildcard, which can contain multiple file types, for example: "BMP files (*.bmp)|*.bmp|GIF files (*.gif)|*.gif".
+    # @param wildCard [String] 
+    # @return [void]
+    def set_wildcard(wildCard) end
+    alias_method :wildcard=, :set_wildcard
+    
+    # Sets whether hidden files and folders are shown or not.
+    # @param show [Boolean] 
+    # @return [void]
+    def show_hidden(show) end
+    
+  end # FileCtrl
+  
+
+end

data/lib/wx/doc/gen/file_ctrl_event.rb

@@ -0,0 +1,79 @@
+# :stopdoc:
+# This file is automatically generated by the WXRuby3 documentation 
+# generator. Do not alter this file.
+# :startdoc:
+
+
+module Wx
+
+  # A file control event holds information about events associated with {Wx::FileCtrl} objects.
+  # ### Events using this class
+  # 
+  # The following event-handler methods redirect the events to member method or handler blocks for {Wx::FileCtrlEvent} events.
+  # Event handler methods:
+  # 
+  # - {Wx::EvtHandler#evt_filectrl_fileactivated}(id, meth = nil, &block): The user activated a file(by double-clicking or pressing Enter) 
+  # 
+  # - {Wx::EvtHandler#evt_filectrl_selectionchanged}(id, meth = nil, &block): The user changed the current selection(by selecting or deselecting a file) 
+  # 
+  # - {Wx::EvtHandler#evt_filectrl_folderchanged}(id, meth = nil, &block): The current folder of the file control has been changed 
+  # 
+  # - {Wx::EvtHandler#evt_filectrl_filterchanged}(id, meth = nil, &block): The current file filter of the file control has been changed 
+  # 
+  # Category:  {Wx::Events}
+  # 
+  # @wxrb_require USE_FILECTRL
+  class FileCtrlEvent < CommandEvent
+  
+    # Constructor.
+    # @param type [Wx::Slider::EventType] 
+    # @param evtObject [Wx::Object] 
+    # @param id [Integer] 
+    # @return [Wx::FileCtrlEvent]
+    def initialize(type, evtObject, id) end
+    
+    # Returns the current directory.
+    # In case of a <b>EVT_FILECTRL_FOLDERCHANGED</b>, this method returns the new directory.
+    # @return [String]
+    def get_directory; end
+    alias_method :directory, :get_directory
+    
+    # Returns the file selected (assuming it is only one file).
+    # @return [String]
+    def get_file; end
+    alias_method :file, :get_file
+    
+    # Returns the files selected.
+    # In case of a <b>EVT_FILECTRL_SELECTIONCHANGED</b>, this method returns the files selected after the event.
+    # @return [Array<String>]
+    def get_files; end
+    alias_method :files, :get_files
+    
+    # Returns the current file filter index.
+    # For a <b>EVT_FILECTRL_FILTERCHANGED</b> event, this method returns the new file filter index.
+    # @return [Integer]
+    def get_filter_index; end
+    alias_method :filter_index, :get_filter_index
+    
+    # Sets the files changed by this event.
+    # @param files [Array<String>] 
+    # @return [void]
+    def set_files(files) end
+    alias_method :files=, :set_files
+    
+    # Sets the directory of this event.
+    # @param directory [String] 
+    # @return [void]
+    def set_directory(directory) end
+    alias_method :directory=, :set_directory
+    
+    # Sets the filter index changed by this event.
+    # @param index [Integer] 
+    # @return [void]
+    def set_filter_index(index) end
+    alias_method :filter_index=, :set_filter_index
+    
+  end # FileCtrlEvent
+  
+
+end

data/lib/wx/doc/gen/file_dialog.rb

@@ -106,7 +106,7 @@ module Wx
   # end
   # ```
   # 
-  # == Wildcard Filters
+  # ## Wildcard Filters
   # 
   # All implementations of the {Wx::FileDialog} provide a wildcard filter. Typing a filename containing wildcards (*, ?) in the filename text item, and clicking on Ok, will result in only those files matching the pattern being displayed. The wildcard may be a specification for multiple types of file with a description for each, such as: 
   # ```
@@ -119,14 +119,19 @@ module Wx
   # ```
   #  But in contrast to Windows and Unix, where the file type choice filters only the selected files, on Mac macOS even in this case the dialog shows all files matching all file types. The files which does not match the currently selected file type are greyed out and are not selectable.
   # 
-  # == Dialog Customization
+  # ## Dialog Customization
   # 
   # Uniquely among the other standard dialogs, {Wx::FileDialog} can be customized by adding extra controls to it. Moreover, there are two ways to do it: the first one is to define a callback function and use {Wx::FileDialog#set_extra_control_creator} to tell the dialog to call it, while the second one requires defining a class inheriting from {Wx::FileDialogCustomizeHook} and implementing its virtual functions, notably {Wx::FileDialogCustomizeHook#add_custom_controls} where the extra controls have to be created, and finally calling {Wx::FileDialog#set_customize_hook} with this custom hook object.
-  # The first approach is somewhat simpler and more flexible, as it allows to create any kind of custom controls, but is not supported by the "new style" (where "new" means used since Windows Vista, i.e. circa 2007) file dialogs under MSW. Because of this, calling {Wx::FileDialog#set_extra_control_creator} in wxMSW forces the use of old style (Windows XP) dialogs, that may look out of place. The second approach is implemented by the MSW dialogs natively and doesn't suffer from this limitation, so its use is recommended, especially if the few simple control types supported by it (see {Wx::FileDialogCustomize} for more information about the supported controls) are sufficient for your needs.
+  # The first approach is somewhat simpler and more flexible, as it allows to create any kind of custom controls, but is not supported by the "new style" (where "new" means used since Windows Vista, i.e. circa 2007) file dialogs under MSW. Because of this, calling {Wx::FileDialog#set_extra_control_creator} in WXMSW forces the use of old style (Windows XP) dialogs, that may look out of place. The second approach is implemented by the MSW dialogs natively and doesn't suffer from this limitation, so its use is recommended, especially if the few simple control types supported by it (see {Wx::FileDialogCustomize} for more information about the supported controls) are sufficient for your needs.
   # Both of the approaches to the dialog customization are demonstrated in the Dialogs Sample, please check it for more details.
-  # New style file dialogs can only be used in wxMSW when the apartment, COM threading model is used. This is the case by default, but if the application initializes COM on its own using multi-threaded model, old style dialogs are used, at least when they must have a parent, as the new style dialog doesn't support this threading model.
   # 
-  # === Styles
+  # <div class="wxrb-note">
+  # <b>Note:</b>
+  # <p>New style file dialogs can only be used in WXMSW when the apartment, COM threading model is used. This is the case by default, but if the application initializes COM on its own using multi-threaded model, old style dialogs are used, at least when they must have a parent, as the new style dialog doesn't support this threading model.
+  # </p>
+  # </div>
+  # 
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -136,9 +141,9 @@ module Wx
   # 
   # - {Wx::FD_SAVE}: This is a save dialog; usually this means that the default button's label of the dialog is "Save". Cannot be combined with {Wx::FD_OPEN}. 
   # 
-  # - {Wx::FD_OVERWRITE_PROMPT}: For save dialog only: prompt for a confirmation if a file will be overwritten. This style is always enabled on wxOSX and cannot be disabled. 
+  # - {Wx::FD_OVERWRITE_PROMPT}: For save dialog only: prompt for a confirmation if a file will be overwritten. This style is always enabled on WXOSX and cannot be disabled. 
   # 
-  # - {Wx::FD_NO_FOLLOW}: Directs the dialog to return the path and file name of the selected shortcut file, not its target as it does by default. Currently this flag is only implemented in wxMSW and wxOSX (where it prevents aliases from being resolved). The non-dereferenced link path is always returned, even without this flag, under Unix and so using it there doesn't do anything. This flag was added in wxWidgets 3.1.0. 
+  # - {Wx::FD_NO_FOLLOW}: Directs the dialog to return the path and file name of the selected shortcut file, not its target as it does by default. Currently this flag is only implemented in WXMSW and WXOSX (where it prevents aliases from being resolved). The non-dereferenced link path is always returned, even without this flag, under Unix and so using it there doesn't do anything. This flag was added in wxWidgets 3.1.0. 
   # 
   # - {Wx::FD_FILE_MUST_EXIST}: For open dialog only: the user may only select files that actually exist. Notice that under macOS the file dialog with {Wx::FD_OPEN} style always behaves as if this style was specified, because it is impossible to choose a file that doesn't exist from a standard macOS file dialog. 
   # 
@@ -146,17 +151,16 @@ module Wx
   # 
   # - {Wx::FD_CHANGE_DIR}: Change the current working directory (when the dialog is dismissed) to the directory where the file(s) chosen by the user are. 
   # 
-  # - {Wx::FD_PREVIEW}: Show the preview of the selected files (currently only supported by wxGTK). 
+  # - {Wx::FD_PREVIEW}: Show the preview of the selected files (currently only supported by WXGTK). 
   # 
   # - {Wx::FD_SHOW_HIDDEN}: Show hidden files. This flag was added in wxWidgets 3.1.3 
   # 
-  # === 
-  # 
   # Category:  Common Dialogs
   # @see wxFileDialog Overview
   # @see  file_selector 
   # 
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialog < Dialog
   
     # Constructor.
@@ -171,7 +175,7 @@ module Wx
     # @param size [Array(Integer, Integer), Wx::Size]  Dialog size. Not implemented.
     # @param name [String]  Dialog name. Not implemented.
     # @return [Wx::FileDialog]
-    def initialize(parent, message=Wx::FileSelectorPromptStr, defaultDir=(''), defaultFile=(''), wildcard=Wx::FILE_SELECTOR_DEFAULT_WILDCARD_STR, style=Wx::FD_DEFAULT_STYLE, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, name=Wx::FileDialogNameStr) end
+    def initialize(parent, message=Wx::FILE_SELECTOR_PROMPT_STR, defaultDir=(''), defaultFile=(''), wildcard=Wx::FILE_SELECTOR_DEFAULT_WILDCARD_STR, style=Wx::FD_DEFAULT_STYLE, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, name=Wx::FILE_DIALOG_NAME_STR) end
     
     # Returns the path of the file currently selected in dialog.
     # Notice that this file is not necessarily going to be accepted by the user, so calling this function mostly makes sense from an update UI event handler of a custom file dialog extra control to update its state depending on the currently selected file.
@@ -209,7 +213,11 @@ module Wx
     alias_method :extra_control, :get_extra_control
     
     # Returns the default filename.
-    # This function can't be used with dialogs which have the {Wx::FD_MULTIPLE} style, use {Wx::FileDialog#get_filenames} instead.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>This function can't be used with dialogs which have the {Wx::FD_MULTIPLE} style, use {Wx::FileDialog#get_filenames} instead. 
+    # </p>
+    # </div>
     # @return [String]
     def get_filename; end
     alias_method :filename, :get_filename
@@ -234,7 +242,11 @@ module Wx
     alias_method :message, :get_message
     
     # Returns the full path (directory and filename) of the selected file.
-    # This function can't be used with dialogs which have the {Wx::FD_MULTIPLE} style, use {Wx::FileDialog#get_paths} instead.
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>This function can't be used with dialogs which have the {Wx::FD_MULTIPLE} style, use {Wx::FileDialog#get_paths} instead. 
+    # </p>
+    # </div>
     # @return [String]
     def get_path; end
     alias_method :path, :get_path
@@ -252,7 +264,12 @@ module Wx
     
     # Set the hook to be used for customizing the dialog contents.
     # This function can be called before calling {Wx::FileDialog#show_modal} to specify that the dialog contents should be customized using the provided hook. See {Wx::FileDialogCustomizeHook} documentation and Dialogs Sample for the examples of using it.
-    # In order to define a custom hook object, <code>Wx::/filedlgcustomize.h</code> must be included in addition to the usual <code>Wx::/filedlg.h</code> header.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>In order to define a custom hook object, <code>Wx::/filedlgcustomize.h</code> must be included in addition to the usual <code>Wx::/filedlg.h</code> header.
+    # </p>
+    # </div>
     # 
     # true if the hook was successfully set or false if customizing the file dialog is not supported by the current platform.
     # @param customizeHook [Wx::FileDialogCustomizeHook]  The hook object that will be used by the dialog. This object must remain valid at least until {Wx::FileDialog#show_modal} returns.
@@ -267,7 +284,7 @@ module Wx
     alias_method :directory=, :set_directory
     
     # Sets the default filename.
-    # In wxGTK this will have little effect unless a default directory has previously been set.
+    # In WXGTK this will have little effect unless a default directory has previously been set.
     # @param setfilename [String] 
     # @return [void]
     def set_filename(setfilename) end

data/lib/wx/doc/gen/file_dialog_custom_control.rb

@@ -11,6 +11,7 @@ module Wx
   # Also, similarly to the normal windows, objects of this and derived classes belong to wxWidgets and must not be deleted by the application code.
   # Unlike windows, custom controls cannot be created directly, but can only be returned from {Wx::FileDialogCustomize} functions that are specifically provided for creating them.
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialogCustomControl < EvtHandler
   
     # Show or hide this control.
@@ -40,6 +41,7 @@ module Wx
   # It is possible to bind to {Wx::EVT_BUTTON} events on this object, which will be generated when the button is clicked.
   # See {Wx::FileDialogCustomControl} for more information.
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialogButton < FileDialogCustomControl
   
   end # FileDialogButton
@@ -49,6 +51,7 @@ module Wx
   # It is possible to bind to {Wx::EVT_CHECKBOX} events on this object, which will be generated when the checkbox is clicked.
   # See {Wx::FileDialogCustomControl} for more information.
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialogCheckBox < FileDialogCustomControl
   
     # Return true if the checkbox is checked.
@@ -69,6 +72,7 @@ module Wx
   # It is possible to bind to {Wx::EVT_RADIOBUTTON} events on this object, which will be generated when the radio button is selected.
   # See {Wx::FileDialogCustomControl} for more information.
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialogRadioButton < FileDialogCustomControl
   
     # Return true if the radio button is selected.
@@ -90,6 +94,7 @@ module Wx
   # It is possible to bind to {Wx::EVT_CHOICE} events on this object, which will be generated when the selection in the combobox changes.
   # See {Wx::FileDialogCustomControl} for more information.
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialogChoice < FileDialogCustomControl
   
     # Return the index of the selected item, possibly {Wx::NOT_FOUND}.
@@ -111,6 +116,7 @@ module Wx
   # Objects of this class don't generate any events currently.
   # See {Wx::FileDialogCustomControl} for more information.
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialogTextCtrl < FileDialogCustomControl
   
     # Get the current value entered into the control.
@@ -131,6 +137,7 @@ module Wx
   # Objects of this class don't generate any events.
   # See {Wx::FileDialogCustomControl} for more information.
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialogStaticText < FileDialogCustomControl
   
     # Set the text shown in the label.

data/lib/wx/doc/gen/file_dialog_customize_hook.rb

@@ -72,14 +72,13 @@ module Wx
   #   }
   # ```
   # 
-  # === 
-  # 
   # Category:  Common Dialogs
   # @see Wx::FileDialog
   # 
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_FILEDLG
   class FileDialogCustomizeHook < ::Object
   
     # Must be overridden to add custom controls to the dialog using the provided customizer object.
@@ -108,12 +107,12 @@ module Wx
   # Used with {Wx::FileDialogCustomizeHook} to add custom controls to {Wx::FileDialog}.
   # An object of this class is passed to {Wx::FileDialogCustomizeHook#add_custom_controls} to allow it to actually add controls to the dialog.
   # The pointers returned by the functions of this class belong to wxWidgets and should not be deleted by the application, just as {Wx::Window}-derived objects (even if these controls do not inherit from {Wx::Window}). These pointers become invalid when {Wx::FileDialog#show_modal} returns, and the dialog containing them is destroyed, and the latest point at which they can be still used is when {Wx::FileDialogCustomizeHook#transfer_data_from_custom_controls} is called.
-  # === 
   # 
   # Category:  Common Dialogs
   # @see Wx::FileDialog
   # 
   # 
+  # @wxrb_require USE_FILEDLG
   class FileDialogCustomize < ::Object
   
     # Add a button with the specified label.

data/lib/wx/doc/gen/file_dir_picker_event.rb

@@ -54,7 +54,7 @@ module Wx
   EVT_DIRPICKER_CHANGED = 10172
   
   # This event class is used for the events generated by {Wx::FilePickerCtrl} and by {Wx::DirPickerCtrl}.
-  # === Events using this class
+  # ### Events using this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::FileDirPickerEvent} events.
   # Event handler methods:
@@ -63,20 +63,19 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_dirpicker_changed}(id, meth = nil, &block): Generated whenever the selected directory changes. 
   # 
-  # === 
-  # 
   # Category:  {Wx::Events}
   # @see Wx::FilePickerCtrl
   # @see  Wx::DirPickerCtrl 
   # 
   # 
+  # @wxrb_require USE_DIRDLG&USE_DIRPICKERCTRL|USE_FILEDLG&USE_FILEPICKERCTRL
   class FileDirPickerEvent < CommandEvent
   
     # @overload initialize()
     #   @return [Wx::FileDirPickerEvent]
     # @overload initialize(type, generator, id, path)
     #   The constructor is not normally used by the user code.
-    #   @param type [Wx::CommandLinkButton::EventType] 
+    #   @param type [Wx::Slider::EventType] 
     #   @param generator [Wx::Object] 
     #   @param id [Integer] 
     #   @param path [String] 

data/lib/wx/doc/gen/file_picker_ctrl.rb

@@ -8,11 +8,11 @@ module Wx
 
   # This control allows the user to select a file.
   # The generic implementation is a button which brings up a {Wx::FileDialog} when clicked. Native implementation may differ but this is usually a (small) widget which give access to the file-chooser dialog. It is only available if {Wx::Setup::USE_FILEPICKERCTRL} is set to 1 (the default).
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
-  # - {Wx::FLP_DEFAULT_STYLE}: The default style: includes {Wx::FLP_OPEN} | {Wx::FLP_FILE_MUST_EXIST} and, under wxMSW and wxOSX, {Wx::FLP_USE_TEXTCTRL}. 
+  # - {Wx::FLP_DEFAULT_STYLE}: The default style: includes {Wx::FLP_OPEN} | {Wx::FLP_FILE_MUST_EXIST} and, under WXMSW and WXOSX, {Wx::FLP_USE_TEXTCTRL}. 
   # 
   # - {Wx::FLP_USE_TEXTCTRL}: Creates a text control to the left of the picker button which is completely managed by the {Wx::FilePickerCtrl} and which can be used by the user to specify a path (see SetPath). The text control is automatically synchronized with button's value. Use functions defined in {Wx::PickerBase} to modify the text control. 
   # 
@@ -28,28 +28,27 @@ module Wx
   # 
   # - {Wx::FLP_SMALL}: Use smaller version of the control with a small "..." button instead of the normal "Browse" one. This flag is new since wxWidgets 2.9.3. 
   # 
-  # === Events emitted by this class
+  # ### Events emitted by this class
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::FileDirPickerEvent} events.
   # Event handler methods for events emitted by this class:
   # 
   # - {Wx::EvtHandler#evt_filepicker_changed}(id, meth = nil, &block): The user changed the file selected in the control either using the button or using text control (see {Wx::FLP_USE_TEXTCTRL}; note that in this case the event is fired only if the user's input is valid, e.g. an existing file path if {Wx::FLP_FILE_MUST_EXIST} was given). 
   # 
-  # === 
-  # 
-  # Category:  Picker Controls  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> wxMSW Appearance
-  #   </td><td> wxGTK Appearance
-  #   </td><td> wxOSX Appearance
+  # Category:  Picker Controls  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> WXMSW Appearance
+  #   </td><td> WXGTK Appearance
+  #   </td><td> WXOSX Appearance
   #   </td></tr></table></div>
   # @see Wx::FileDialog
   # @see  Wx::FileDirPickerEvent 
   # 
   # 
+  # @wxrb_require USE_FILEDLG,USE_FILEPICKERCTRL
   class FilePickerCtrl < PickerBase
   
     # @overload initialize()
     #   @return [Wx::FilePickerCtrl]
-    # @overload initialize(parent, id, path=(''), message=Wx::FileSelectorPromptStr, wildcard=Wx::FILE_SELECTOR_DEFAULT_WILDCARD_STR, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::FLP_DEFAULT_STYLE, validator=Wx::DEFAULT_VALIDATOR, name=Wx::FilePickerCtrlNameStr)
+    # @overload initialize(parent, id, path=(''), message=Wx::FILE_SELECTOR_PROMPT_STR, wildcard=Wx::FILE_SELECTOR_DEFAULT_WILDCARD_STR, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::FLP_DEFAULT_STYLE, validator=Wx::DEFAULT_VALIDATOR, name=Wx::FILE_PICKER_CTRL_NAME_STR)
     #   Initializes the object and calls {Wx::FilePickerCtrl#create} with all the parameters.
     #   @param parent [Wx::Window] 
     #   @param id [Integer] 
@@ -77,7 +76,7 @@ module Wx
     # @param validator [Wx::Validator]  Validator which can be used for additional data checks.
     # @param name [String]  Control name.
     # @return [Boolean]
-    def create(parent, id, path=(''), message=Wx::FileSelectorPromptStr, wildcard=Wx::FILE_SELECTOR_DEFAULT_WILDCARD_STR, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::FLP_DEFAULT_STYLE, validator=Wx::DEFAULT_VALIDATOR, name=Wx::FilePickerCtrlNameStr) end
+    def create(parent, id, path=(''), message=Wx::FILE_SELECTOR_PROMPT_STR, wildcard=Wx::FILE_SELECTOR_DEFAULT_WILDCARD_STR, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::FLP_DEFAULT_STYLE, validator=Wx::DEFAULT_VALIDATOR, name=Wx::FILE_PICKER_CTRL_NAME_STR) end
     
     # Similar to {Wx::FilePickerCtrl#get_path} but returns the path of the currently selected file as a {Wx::FileName} object.
     # @return [String]
@@ -103,7 +102,7 @@ module Wx
     alias_method :initial_directory=, :set_initial_directory
     
     # Sets the absolute path of the currently selected file.
-    # If the control uses {Wx::FLP_FILE_MUST_EXIST} and does not use {Wx::FLP_USE_TEXTCTRL} style, the filename must be a name of an existing file and will be simply ignored by the native wxGTK implementation if this is not the case (the generic implementation used under the other platforms accepts even invalid file names currently, but this is subject to change in the future, don't rely on being able to use non-existent paths with it).
+    # If the control uses {Wx::FLP_FILE_MUST_EXIST} and does not use {Wx::FLP_USE_TEXTCTRL} style, the filename must be a name of an existing file and will be simply ignored by the native WXGTK implementation if this is not the case (the generic implementation used under the other platforms accepts even invalid file names currently, but this is subject to change in the future, don't rely on being able to use non-existent paths with it).
     # @param filename [String] 
     # @return [void]
     def set_path(filename) end