wxruby3 0.9.1-x64-mingw-ucrt → 0.9.3-x64-mingw-ucrt

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

@@ -45,12 +45,13 @@ module Wx
   end # DialogLayoutAdaptationMode
   
   # A dialog box is a window with a title bar and sometimes a system menu, which can be moved around the screen.
+  # 
   # It can contain controls and other windows and is often used to allow the user to make some choice or to answer a question.
   # Dialogs can be made scrollable, automatically, for computers with low resolution screens: please see Automatic Scrolled Dialogs for further details.
   # Dialogs usually contain either a single button allowing to close the dialog or two buttons, one accepting the changes and the other one discarding them (such button, if present, is automatically activated if the user presses the "Esc" key). By default, buttons with the standard {Wx::StandardID::ID_OK} and {Wx::StandardID::ID_CANCEL} identifiers behave as expected. Starting with wxWidgets 2.7 it is also possible to use a button with a different identifier instead, see {Wx::Dialog#set_affirmative_id} and {Wx::Dialog#set_escape_id}.
   # Also notice that the {Wx::Dialog#create_button_sizer} should be used to create the buttons appropriate for the current platform and positioned correctly (including their order which is platform-dependent).
   # 
-  # == Modal and Modeless
+  # ## Modal and Modeless
   # 
   # There are two kinds of dialog, modal and modeless. A modal dialog blocks program flow and user input on other windows until it is dismissed, whereas a modeless dialog behaves more like a frame in that program flow continues, and input in other windows is still possible. To show a modal dialog you should use the {Wx::Dialog#show_modal} method while to show a dialog modelessly you simply use {Wx::Dialog#show}, just as with frames.
   # Note that dialogs need to be explicitly destroyed when closed and not used anymore. The traditional code for this would be like:
@@ -81,7 +82,7 @@ module Wx
   # ```
   # 
   # An application can define a {Wx::CloseEvent} handler for the dialog to respond to system close events.
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -112,7 +113,7 @@ module Wx
   # - {Wx::DIALOG_EX_METAL}: On macOS, frames with this style will be shown with a metallic look. This is an extra style. 
   # 
   # Under Unix or Linux, MWM (the Motif Window Manager) or other window managers recognizing the MHM hints should be running for any of these styles to have an effect.
-  # === 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::CloseEvent} events.
   # Event handler methods for events emitted by this class:
@@ -121,8 +122,6 @@ module Wx
   # 
   # - {Wx::EvtHandler#evt_init_dialog}(meth = nil, &block): Process a {Wx::EVT_INIT_DIALOG} event. See {Wx::InitDialogEvent}. 
   # 
-  # === 
-  # 
   # Category:  Common Dialogs
   # @see wxDialog Overview
   # @see  Wx::Frame
@@ -137,6 +136,7 @@ module Wx
     # @overload initialize(parent, id, title, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::DEFAULT_DIALOG_STYLE, name=Wx::DIALOG_NAME_STR)
     #   Constructor.
     #   
+    #   
     #   @see Wx::Dialog#create 
     #   @param parent [Wx::Window]  Can be NULL, a frame or another dialog box.
     #   @param id [Integer]  An identifier for the dialog. A value of -1 is taken to mean a default.
@@ -150,6 +150,7 @@ module Wx
     
     # Adds an identifier to be regarded as a main button for the non-scrolling area of a dialog.
     # 
+    # 
     # @see Automatic Scrolled Dialogs (for more on layout adaptation) 
     # @param id [Integer] 
     # @return [void]
@@ -157,6 +158,7 @@ module Wx
     
     # Returns true if this dialog can and should perform layout adaptation using {Wx::Dialog#do_layout_adaptation}, usually if the dialog is too large to fit on the display.
     # 
+    # 
     # @see Automatic Scrolled Dialogs (for more on layout adaptation) 
     # @return [Boolean]
     def can_do_layout_adaptation; end
@@ -169,6 +171,7 @@ module Wx
     
     # Used for two-step dialog box construction.
     # 
+    # 
     # @see Wx::Dialog#initialize 
     # @param parent [Wx::Window] 
     # @param id [Integer] 
@@ -181,6 +184,7 @@ module Wx
     def create(parent, id, title, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::DEFAULT_DIALOG_STYLE, name=Wx::DIALOG_NAME_STR) end
     
     # Creates a sizer with standard buttons.
+    # 
     # flags is a bit list of the following flags: {Wx::OK}, {Wx::CANCEL}, {Wx::YES}, {Wx::NO}, {Wx::APPLY}, {Wx::CLOSE}, {Wx::HELP}, {Wx::NO_DEFAULT}.
     # The sizer lays out the buttons in a manner appropriate to the platform.
     # This function uses {Wx::Dialog#create_std_dialog_button_sizer} internally for most platforms but doesn't create the sizer at all for the platforms with hardware buttons (such as smartphones) for which it sets up the hardware buttons appropriately and returns NULL, so don't forget to test that the return value is valid before using it.
@@ -189,7 +193,12 @@ module Wx
     def create_button_sizer(flags) end
     
     # Creates a sizer with standard buttons using {Wx::Dialog#create_button_sizer} separated from the rest of the dialog contents by a horizontal {Wx::StaticLine}.
-    # Just like {Wx::Dialog#create_button_sizer}, this function may return NULL if no buttons were created.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>Just like {Wx::Dialog#create_button_sizer}, this function may return NULL if no buttons were created.
+    # </p>
+    # </div>
     # 
     # This is a combination of {Wx::Dialog#create_button_sizer} and {Wx::Dialog#create_separated_sizer}.
     # @param flags [Integer] 
@@ -197,6 +206,7 @@ module Wx
     def create_separated_button_sizer(flags) end
     
     # Returns the sizer containing the given one with a separating {Wx::StaticLine} if necessarily.
+    # 
     # This function is useful for creating the sizer containing footer-like contents in dialog boxes. It will add a separating static line only if it conforms to the current platform convention (currently it is not added under Mac where the use of static lines for grouping is discouraged and is added elsewhere).
     # 
     # The sizer wrapping the input one or possibly the input sizer itself if no wrapping is necessary.
@@ -205,6 +215,7 @@ module Wx
     def create_separated_sizer(sizer) end
     
     # Creates a {Wx::StdDialogButtonSizer} with standard buttons.
+    # 
     # flags is a bit list of the following flags: {Wx::OK}, {Wx::CANCEL}, {Wx::YES}, {Wx::NO}, {Wx::APPLY}, {Wx::CLOSE}, {Wx::HELP}, {Wx::NO_DEFAULT}.
     # The sizer lays out the buttons in a manner appropriate to the platform.
     # @param flags [Integer] 
@@ -212,6 +223,7 @@ module Wx
     def create_std_dialog_button_sizer(flags) end
     
     # Splits text up at newlines and places the lines into {Wx::StaticText} objects with the specified maximum width in a vertical {Wx::BoxSizer}.
+    # 
     # If widthMax has its default value of -1, only explicit new line characters in message are taken into account. Otherwise, lines are broken either after a new line or wrapped, at word boundary, if their width would become bigger than the specified maximal width.
     # @see wxStaticText::Wrap(int width) 
     # @param message [String]  The text to be displayed.
@@ -221,12 +233,14 @@ module Wx
     
     # Performs layout adaptation, usually if the dialog is too large to fit on the display.
     # 
+    # 
     # @see Automatic Scrolled Dialogs (for more on layout adaptation) 
     # @return [Boolean]
     def do_layout_adaptation; end
     
     # Ends a modal dialog, passing a value to be returned from the {Wx::Dialog#show_modal} invocation.
     # 
+    # 
     # @see Wx::Dialog#show_modal
     # @see  Wx::Dialog#get_return_code
     # @see  Wx::Dialog#set_return_code 
@@ -236,6 +250,7 @@ module Wx
     
     # Gets the identifier of the button which works like standard OK button in this dialog.
     # 
+    # 
     # @see Wx::Dialog#set_affirmative_id 
     # @return [Integer]
     def get_affirmative_id; end
@@ -243,6 +258,7 @@ module Wx
     
     # Gets the identifier of the button to map presses of ESC button to.
     # 
+    # 
     # @see Wx::Dialog#set_escape_id 
     # @return [Integer]
     def get_escape_id; end
@@ -250,12 +266,14 @@ module Wx
     
     # Returns true if the dialog has been adapted, usually by making it scrollable to work with a small display.
     # 
+    # 
     # @see Automatic Scrolled Dialogs (for more on layout adaptation) 
     # @return [Boolean]
     def get_layout_adaptation_done; end
     alias_method :layout_adaptation_done, :get_layout_adaptation_done
     
     # Gets a value representing the aggressiveness of search for buttons and sizers to be in the non-scrolling part of a layout-adapted dialog.
+    # 
     # Zero switches off adaptation, and 3 allows search for standard buttons anywhere in the dialog.
     # @see Automatic Scrolled Dialogs (for more on layout adaptation) 
     # @return [Integer]
@@ -264,6 +282,7 @@ module Wx
     
     # Gets the adaptation mode, overriding the global adaptation flag.
     # 
+    # 
     # @see Automatic Scrolled Dialogs (for more on layout adaptation) 
     # @return [Wx::DialogLayoutAdaptationMode]
     def get_layout_adaptation_mode; end
@@ -271,13 +290,19 @@ module Wx
     
     # Returns an array of identifiers to be regarded as the main buttons for the non-scrolling area of a dialog.
     # 
+    # 
     # @see Automatic Scrolled Dialogs (for more on layout adaptation) 
     # @return [Array<Integer>]
     def get_main_button_ids; end
     alias_method :main_button_ids, :get_main_button_ids
     
     # Gets the return code for this window.
-    # A return code is normally associated with a modal dialog, where {Wx::Dialog#show_modal} returns a code to the application.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>A return code is normally associated with a modal dialog, where {Wx::Dialog#show_modal} returns a code to the application.
+    # </p>
+    # </div>
     # @see Wx::Dialog#set_return_code
     # @see  Wx::Dialog#show_modal
     # @see  Wx::Dialog#end_modal 
@@ -286,25 +311,38 @@ module Wx
     alias_method :return_code, :get_return_code
     
     # Iconizes or restores the dialog.
+    # 
     # Windows only.
     # 
-    # Note that in Windows, iconization has no effect since dialog boxes cannot be iconized. However, applications may need to explicitly restore dialog boxes under Motif which have user-iconizable frames, and under Windows calling Iconize(false) will bring the window to the front, as does Show(true).
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Note that in Windows, iconization has no effect since dialog boxes cannot be iconized. However, applications may need to explicitly restore dialog boxes under Motif which have user-iconizable frames, and under Windows calling Iconize(false) will bring the window to the front, as does Show(true). 
+    # </p>
+    # </div>
     # @param iconize [Boolean]  If true, iconizes the dialog box; if false, shows and restores it.
     # @return [void]
     def iconize(iconize=true) end
     
     # Returns true if the dialog box is iconized.
+    # 
     # Windows only.
-    # Always returns false under Windows since dialogs cannot be iconized.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Always returns false under Windows since dialogs cannot be iconized. 
+    # </p>
+    # </div>
     # @return [Boolean]
     def is_iconized; end
     alias_method :iconized?, :is_iconized
     
     # Returns true if id is in the array of identifiers to be regarded as the main buttons for the non-scrolling area of a dialog.
-    # Availability:  only available for the wxMSW port.  {Wx::msw}
+    # 
+    # Availability:  only available for the WXMSW port.
     # @see Automatic Scrolled Dialogs (for more on layout adaptation) 
     # @param id [Integer] 
     # @return [Boolean]
+    # @wxrb_require WXMSW
     def is_main_button_id(id) end
     alias_method :main_button_id?, :is_main_button_id
     
@@ -314,6 +352,7 @@ module Wx
     alias_method :modal?, :is_modal
     
     # Sets the identifier to be used as OK button.
+    # 
     # When the button with this identifier is pressed, the dialog calls {Wx::Window#validate} and {Wx::Window#transfer_data_from_window} and, if they both return true, closes the dialog with the affirmative id return code.
     # Also, when the user presses a hardware OK button on the devices having one or the special OK button in the PocketPC title bar, an event with this id is generated.
     # By default, the affirmative id is {Wx::StandardID::ID_OK}.
@@ -325,9 +364,15 @@ module Wx
     alias_method :affirmative_id=, :set_affirmative_id
     
     # Sets the identifier of the button which should work like the standard "Cancel" button in this dialog.
+    # 
     # When the button with this id is clicked, the dialog is closed. Also, when the user presses ESC key in the dialog or closes the dialog using the close button in the title bar, this is mapped to the click of the button with the specified id.
     # By default, the escape id is the special value {Wx::StandardID::ID_ANY} meaning that {Wx::StandardID::ID_CANCEL} button is used if it's present in the dialog and otherwise the button with {Wx::Dialog#get_affirmative_id} is used. Another special value for id is {Wx::StandardID::ID_NONE} meaning that ESC presses should be ignored. If any other value is given, it is interpreted as the id of the button to map the escape key to.
-    # This method should be used for custom modal dialog implemented in wxWidgets itself, native dialogs such as {Wx::MessageDialog} or {Wx::FileDialog}, handle ESC presses in their own way which cannot be customized.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>This method should be used for custom modal dialog implemented in wxWidgets itself, native dialogs such as {Wx::MessageDialog} or {Wx::FileDialog}, handle ESC presses in their own way which cannot be customized. 
+    # </p>
+    # </div>
     # @param id [Integer] 
     # @return [void]
     def set_escape_id(id) end
@@ -335,6 +380,7 @@ module Wx
     
     # Sets the icon for this dialog.
     # 
+    # 
     # @see Wx::Icon 
     # @param icon [Wx::Icon]  The icon to associate with this dialog.
     # @return [void]
@@ -343,6 +389,7 @@ module Wx
     
     # Sets the icons for this dialog.
     # 
+    # 
     # @see Wx::IconBundle 
     # @param icons [Wx::IconBundle]  The icons to associate with this dialog.
     # @return [void]
@@ -351,6 +398,7 @@ module Wx
     
     # Marks the dialog as having been adapted, usually by making it scrollable to work with a small display.
     # 
+    # 
     # @see Automatic Scrolled Dialogs (for more on layout adaptation) 
     # @param done [Boolean] 
     # @return [void]
@@ -358,6 +406,7 @@ module Wx
     alias_method :layout_adaptation_done=, :set_layout_adaptation_done
     
     # Sets the aggressiveness of search for buttons and sizers to be in the non-scrolling part of a layout-adapted dialog.
+    # 
     # Zero switches off adaptation, and 3 allows search for standard buttons anywhere in the dialog.
     # @see Automatic Scrolled Dialogs (for more on layout adaptation) 
     # @param level [Integer] 
@@ -367,6 +416,7 @@ module Wx
     
     # Sets the adaptation mode, overriding the global adaptation flag.
     # 
+    # 
     # @see Wx::DialogLayoutAdaptationMode
     # @see  Automatic Scrolled Dialogs (for more on layout adaptation) 
     # @param mode [Wx::DialogLayoutAdaptationMode] 
@@ -375,6 +425,7 @@ module Wx
     alias_method :layout_adaptation_mode=, :set_layout_adaptation_mode
     
     # Sets the return code for this window.
+    # 
     # A return code is normally associated with a modal dialog, where {Wx::Dialog#show_modal} returns a code to the application. The function {Wx::Dialog#end_modal} calls {Wx::Dialog#set_return_code}.
     # @see Wx::Dialog#get_return_code
     # @see  Wx::Dialog#show_modal
@@ -385,12 +436,14 @@ module Wx
     alias_method :return_code=, :set_return_code
     
     # Hides or shows the dialog.
+    # 
     # The preferred way of dismissing a modal dialog is to use {Wx::Dialog#end_modal}.
     # @param show [Boolean]  If true, the dialog box is shown and brought to the front, otherwise the box is hidden. If false and the dialog is modal, control is returned to the calling program.
     # @return [Boolean]
     def show(show=true) end
     
     # Shows an application-modal dialog.
+    # 
     # Program flow does not return until the dialog has been dismissed with {Wx::Dialog#end_modal}.
     # Notice that it is possible to call {Wx::Dialog#show_modal} for a dialog which had been previously shown with {Wx::Dialog#show}, this allows making an existing modeless dialog modal. However {Wx::Dialog#show_modal} can't be called twice without intervening {Wx::Dialog#end_modal} calls.
     # Note that this function creates a temporary event loop which takes precedence over the application's main event loop (see {Wx::EventLoopBase}) and which is destroyed when the dialog is dismissed. This also results in a call to {Wx::App#process_pending_events}.
@@ -404,8 +457,9 @@ module Wx
     def show_modal; end
     
     # Shows a dialog modal to the parent top level window only.
+    # 
     # Unlike {Wx::Dialog#show_modal}, dialogs shown with this function only prevent the user from interacting with their parent frame only but not with the rest of the application. They also don't block the program execution but instead return immediately, as {Wx::Dialog#show}, and generate a {Wx::EVT_WINDOW_MODAL_DIALOG_CLOSED} event ({Wx::WindowModalDialogEvent}) later when the dialog is closed.
-    # Currently this function is only fully implemented in wxOSX ports, under the other platforms it behaves like {Wx::Dialog#show_modal} (but also sends the above mentioned event).
+    # Currently this function is only fully implemented in WXOSX ports, under the other platforms it behaves like {Wx::Dialog#show_modal} (but also sends the above mentioned event).
     # @see Wx::WindowModalDialogEvent
     # @see  Wx::Dialog#show_window_modal_then_do
     # @return [void]
@@ -413,6 +467,7 @@ module Wx
     
     # A static function enabling or disabling layout adaptation for all dialogs.
     # 
+    # 
     # @see Automatic Scrolled Dialogs (for more on layout adaptation) 
     # @param enable [Boolean] 
     # @return [void]
@@ -420,17 +475,20 @@ module Wx
     
     # A static function getting the current layout adapter object.
     # 
+    # 
     # @see Automatic Scrolled Dialogs (for more on layout adaptation) 
     # @return [Wx::DialogLayoutAdapter]
     def self.get_layout_adapter; end
     
     # A static function returning true if layout adaptation is enabled for all dialogs.
     # 
+    # 
     # @see Automatic Scrolled Dialogs (for more on layout adaptation) 
     # @return [Boolean]
     def self.is_layout_adaptation_enabled; end
     
     # A static function for setting the current layout adapter object, returning the old adapter.
+    # 
     # If you call this, you should delete the old adapter object.
     # @see Wx::DialogLayoutAdapter
     # @see  Automatic Scrolled Dialogs 
@@ -441,9 +499,9 @@ module Wx
   end # Dialog
   
   # This abstract class is the base for classes that help wxWidgets perform run-time layout adaptation of dialogs.
+  # 
   # Principally, this is to cater for small displays by making part of the dialog scroll, but the application developer may find other uses for layout adaption.
   # By default, there is one instance of {Wx::StandardDialogLayoutAdapter} which can perform adaptation for most custom dialogs and dialogs with book controls such as {Wx::PropertySheetDialog}.
-  # === 
   # 
   # Category:  Window Layout
   # @see Automatic Scrolled Dialogs 
@@ -462,6 +520,7 @@ module Wx
     alias_method :can_do_layout_adaptation?, :can_do_layout_adaptation
     
     # Override this to perform layout adaptation, such as making parts of the dialog scroll and resizing the dialog to fit the display.
+    # 
     # Normally this function will be called just before the dialog is shown.
     # @param dialog [Wx::Dialog] 
     # @return [Boolean]

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

@@ -37,6 +37,7 @@ module Wx
   DIR_DIALOG_NAME_STR = "wxDirCtrl"
   
   # Pops up a directory selector dialog.
+  # 
   # The arguments have the same meaning as those of {Wx::DirDialog#initialize}. The message is displayed at the top, and the default_path, if specified, is set as the initial selection.
   # The application must check for an empty return value (if the user pressed Cancel). For example:
   # 
@@ -55,7 +56,8 @@ module Wx
   def self.dir_selector(message=Wx::DIR_SELECTOR_PROMPT_STR, default_path=(''), style=0, pos=Wx::DEFAULT_POSITION, parent=nil) end
   
   # This class represents the directory chooser dialog.
-  # === Styles
+  # 
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
@@ -75,18 +77,23 @@ module Wx
   #                 Wx::DD_DEFAULT_STYLE | Wx::DD_DIR_MUST_EXIST)  
   # ```
   #  instead of just using {Wx::DD_DIR_MUST_EXIST} style alone.
-  # MacOS 10.11+ does not display a title bar on the dialog. Use {Wx::DirDialog#set_message} to change the string displayed to the user at the top of the dialog after creation. The {Wx::DirDialog#set_title} method is provided for compatibility with pre-10.11 MacOS versions that do still support displaying the title bar.
   # 
-  # === 
+  # <div class="wxrb-remark">
+  # <b>Remark:</b>
+  # <p>MacOS 10.11+ does not display a title bar on the dialog. Use {Wx::DirDialog#set_message} to change the string displayed to the user at the top of the dialog after creation. The {Wx::DirDialog#set_title} method is provided for compatibility with pre-10.11 MacOS versions that do still support displaying the title bar.
+  # </p>
+  # </div>
   # 
   # Category:  Common Dialogs
   # @see wxDirDialog Overview
   # @see  Wx::FileDialog 
   # 
   # 
+  # @wxrb_require USE_DIRDLG
   class DirDialog < Dialog
   
     # Constructor.
+    # 
     # Use {Wx::DirDialog#show_modal} to show the dialog.
     # @param parent [Wx::Window]  Parent window.
     # @param message [String]  Message to show on the dialog.
@@ -104,13 +111,23 @@ module Wx
     alias_method :message, :get_message
     
     # Returns the default or user-selected path.
-    # This function can't be used with dialogs which have the {Wx::DD_MULTIPLE} style, use {Wx::DirDialog#get_paths} instead.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>This function can't be used with dialogs which have the {Wx::DD_MULTIPLE} style, use {Wx::DirDialog#get_paths} instead. 
+    # </p>
+    # </div>
     # @return [String]
     def get_path; end
     alias_method :path, :get_path
     
     # Fills the array paths with the full paths of the chosen directories.
-    # This function should only be used with the dialogs which have {Wx::DD_MULTIPLE} style, use {Wx::DirDialog#get_path} for the others.
+    # 
+    # <div class="wxrb-note">
+    # <b>Note:</b>
+    # <p>This function should only be used with the dialogs which have {Wx::DD_MULTIPLE} style, use {Wx::DirDialog#get_path} for the others.
+    # </p>
+    # </div>
     # @param paths [Array<String>] 
     # @return [void]
     def get_paths(paths) end

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

@@ -45,6 +45,8 @@ module Wx
   # 
   # 
   # 
+  # 
+  # @wxrb_require USE_DIRDLG|USE_FILEDLG
   class DirFilterListCtrl < Choice
   
     # @overload initialize()

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

@@ -7,38 +7,38 @@
 module Wx
 
   # This control allows the user to select a directory.
+  # 
   # The generic implementation is a button which brings up a {Wx::DirDialog} when clicked. Native implementation may differ but this is usually a (small) widget which give access to the dir-chooser dialog. It is only available if {Wx::Setup::USE_DIRPICKERCTRL} is set to 1 (the default).
-  # === Styles
+  # ### Styles
   # 
   # This class supports the following styles:
   # 
-  # - {Wx::DIRP_DEFAULT_STYLE}: The default style: includes {Wx::DIRP_DIR_MUST_EXIST} and, under wxMSW only, {Wx::DIRP_USE_TEXTCTRL}. 
+  # - {Wx::DIRP_DEFAULT_STYLE}: The default style: includes {Wx::DIRP_DIR_MUST_EXIST} and, under WXMSW only, {Wx::DIRP_USE_TEXTCTRL}. 
   # 
   # - {Wx::DIRP_USE_TEXTCTRL}: Creates a text control to the left of the picker button which is completely managed by the {Wx::DirPickerCtrl} 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. 
   # 
-  # - {Wx::DIRP_DIR_MUST_EXIST}: Creates a picker which allows selecting only existing directories in the popup {Wx::DirDialog}. Notice that, as with {Wx::FLP_FILE_MUST_EXIST}, it is still possible to enter a non-existent directory even when this file is specified if {Wx::DIRP_USE_TEXTCTRL} style is also used. Also note that if {Wx::DIRP_USE_TEXTCTRL} is not used, the native wxGTK implementation always uses this style as it doesn't support selecting non-existent directories. 
+  # - {Wx::DIRP_DIR_MUST_EXIST}: Creates a picker which allows selecting only existing directories in the popup {Wx::DirDialog}. Notice that, as with {Wx::FLP_FILE_MUST_EXIST}, it is still possible to enter a non-existent directory even when this file is specified if {Wx::DIRP_USE_TEXTCTRL} style is also used. Also note that if {Wx::DIRP_USE_TEXTCTRL} is not used, the native WXGTK implementation always uses this style as it doesn't support selecting non-existent directories. 
   # 
   # - {Wx::DIRP_CHANGE_DIR}: Change current working directory on each user directory selection change. 
   # 
   # - {Wx::DIRP_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_dirpicker_changed}(id, meth = nil, &block): The user changed the directory selected in the control either using the button or using text control (see {Wx::DIRP_USE_TEXTCTRL}; note that in this case the event is fired only if the user's input is valid, e.g. an existing directory path). 
   # 
-  # === 
-  # 
-  # 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::DirDialog
   # @see  Wx::FileDirPickerEvent 
   # 
   # 
+  # @wxrb_require USE_DIRDLG,USE_DIRPICKERCTRL
   class DirPickerCtrl < PickerBase
   
     # @overload initialize()
@@ -58,6 +58,7 @@ module Wx
     def initialize(*args) end
     
     # Creates the widgets with the given parameters.
+    # 
     # true if the control was successfully created or false if creation failed.
     # @param parent [Wx::Window]  Parent window, must not be non-NULL.
     # @param id [Integer]  The identifier for the control.
@@ -72,6 +73,7 @@ module Wx
     def create(parent, id, path=(''), message=Wx::DIR_SELECTOR_PROMPT_STR, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=Wx::DIRP_DEFAULT_STYLE, validator=Wx::DEFAULT_VALIDATOR, name=Wx::DIR_PICKER_CTRL_NAME_STR) end
     
     # Returns the absolute path of the currently selected directory as a {Wx::FileName} object.
+    # 
     # This function is equivalent to {Wx::DirPickerCtrl#get_path}.
     # @return [String]
     def get_dir_name; end
@@ -89,6 +91,7 @@ module Wx
     alias_method :dir_name=, :set_dir_name
     
     # Set the directory to show when starting to browse for directories.
+    # 
     # This function is mostly useful for the directory picker controls which have no selection initially to configure the directory that should be shown if the user starts browsing for directories as otherwise the initially selected directory is used, which is usually the desired behaviour and so the directory specified by this function is ignored in this case.
     # @param dir [String] 
     # @return [void]
@@ -96,7 +99,8 @@ module Wx
     alias_method :initial_directory=, :set_initial_directory
     
     # Sets the absolute path of the currently selected directory.
-    # If the control uses {Wx::DIRP_DIR_MUST_EXIST} and does not use {Wx::DIRP_USE_TEXTCTRL} style, the dirname must be a name of an existing directory and will be simply ignored by the native wxGTK implementation if this is not the case.
+    # 
+    # If the control uses {Wx::DIRP_DIR_MUST_EXIST} and does not use {Wx::DIRP_USE_TEXTCTRL} style, the dirname must be a name of an existing directory and will be simply ignored by the native WXGTK implementation if this is not the case.
     # @param dirname [String] 
     # @return [void]
     def set_path(dirname) end