wxruby3 0.9.0.pre.rc.2-x64-mingw-ucrt → 0.9.0-x64-mingw-ucrt

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

@@ -14,7 +14,7 @@ module Wx
   # 
   DP_SPIN = 1
   
-  # a combobox-like date picker (not supported in mac version)
+  # a combobox-like date picker (not supported on macOS <10.15.4)
   # 
   DP_DROPDOWN = 2
   
@@ -32,11 +32,15 @@ module Wx
   # === Styles
   # 
   # This class supports the following styles:
-  #  
+  # 
   # - {Wx::DP_SPIN}: Creates a control without a month calendar drop down but with spin-control-like arrows to change individual date components. This style is not supported by the generic version. 
-  # - {Wx::DP_DROPDOWN}: Creates a control with a month calendar drop-down part from which the user can select a date. This style is not supported in OSX/Cocoa native version. 
+  # 
+  # - {Wx::DP_DROPDOWN}: Creates a control with a month calendar drop-down part from which the user can select a date. In OSX/Cocoa native version this style is supported on macOS 10.15.4 and later. 
+  # 
   # - {Wx::DP_DEFAULT}: Creates a control with the style that is best supported for the current platform (currently {Wx::DP_SPIN} under Windows and OSX/Cocoa and {Wx::DP_DROPDOWN} elsewhere). 
+  # 
   # - {Wx::DP_ALLOWNONE}: With this style, the control allows the user to not enter any valid date at all. Without it - the default - the control always has some valid date. This style is not supported in OSX/Cocoa native version. 
+  # 
   # - {Wx::DP_SHOWCENTURY}: Forces display of the century in the default date format. Without this style the century could be displayed, or not, depending on the default date representation in the system. This style is not supported in OSX/Cocoa native version currently. 
   # 
   # As can be seen from the remarks above, most of the control style are only supported in the native MSW implementation. In portable code it's recommended to use {Wx::DP_DEFAULT} style only, possibly combined with {Wx::DP_SHOWCENTURY} (this is also the style used by default if none is specified).
@@ -44,13 +48,14 @@ module Wx
   # 
   # The following event-handler methods redirect the events to member method or handler blocks for {Wx::DateEvent} events.
   # Event handler methods for events emitted by this class:
+  # 
   # - {Wx::EvtHandler#evt_date_changed}(id, meth = nil, &block): Process a {Wx::EVT_DATE_CHANGED} event, which fires when the user changes the current selection in the control. 
   # 
   # === 
   # 
-  # Category:  Picker Controls  <div class='appearance'><span class='appearance'>Appearance:</span><table><tr><td> {Wx::MSW} Appearance
-  #   </td><td> {Wx::GTK} Appearance
-  #   </td><td> {Wx::OSX} 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::TimePickerCtrl
   # @see  Wx::CalendarCtrl
@@ -61,8 +66,8 @@ module Wx
   
     # @overload initialize()
     #   Default constructor.
-    #   @return [DatePickerCtrl]
-    # @overload initialize(parent, id, dt=Wx::DefaultDateTime, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::DP_DEFAULT|Wx::DP_SHOWCENTURY), validator=Wx::DEFAULT_VALIDATOR, name=("datectrl"))
+    #   @return [Wx::DatePickerCtrl]
+    # @overload initialize(parent, id, dt=Wx::DEFAULT_DATE_TIME, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::DP_DEFAULT|Wx::DP_SHOWCENTURY), validator=Wx::DEFAULT_VALIDATOR, name=("datectrl"))
     #   Initializes the object and calls {Wx::DatePickerCtrl#create} with all the parameters.
     #   @param parent [Wx::Window] 
     #   @param id [Integer] 
@@ -72,7 +77,7 @@ module Wx
     #   @param style [Integer] 
     #   @param validator [Wx::Validator] 
     #   @param name [String] 
-    #   @return [DatePickerCtrl]
+    #   @return [Wx::DatePickerCtrl]
     def initialize(*args) end
     
     # Create the control window.
@@ -87,8 +92,8 @@ module Wx
     # @param style [Integer]  The window style, see the description of the styles in the class documentation.
     # @param validator [Wx::Validator]  Validator which can be used for additional data checks.
     # @param name [String]  Control name.
-    # @return [true,false]
-    def create(parent, id, dt=Wx::DefaultDateTime, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::DP_DEFAULT|Wx::DP_SHOWCENTURY), validator=Wx::DEFAULT_VALIDATOR, name=("datectrl")) end
+    # @return [Boolean]
+    def create(parent, id, dt=Wx::DEFAULT_DATE_TIME, pos=Wx::DEFAULT_POSITION, size=Wx::DEFAULT_SIZE, style=(Wx::DP_DEFAULT|Wx::DP_SHOWCENTURY), validator=Wx::DEFAULT_VALIDATOR, name=("datectrl")) end
     
     # Returns the currently entered date.
     # For a control with {Wx::DP_ALLOWNONE} style the returned value may be invalid if no date is entered, otherwise it is always valid.

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

@@ -10,8 +10,13 @@ module Wx
   # 
   # {Wx::DC#blit} and {Wx::DC#stretch_blit}).
   # The description of the values below refer to how a generic src source pixel and the corresponding dst destination pixel gets combined together to produce the final pixel. E.g. {Wx::RasterOperationMode::CLEAR} and {Wx::RasterOperationMode::SET} completely ignore the source and the destination pixel and always put zeroes or ones in the final surface.
-  # Note that not all modes are supported under all platforms. Notably {Wx::GTK3} and {Wx::Mac} only support the following modes:
-  # - {Wx::RasterOperationMode::COPY}- {Wx::RasterOperationMode::OR}- {Wx::RasterOperationMode::NO_OP}- {Wx::RasterOperationMode::CLEAR}- {Wx::RasterOperationMode::XOR} and only support the commonly used {Wx::RasterOperationMode::INVERT} when the source colour is white (as it is implemented using {Wx::CompositionMode::COMPOSITION_DIFF} composition mode).
+  # Note that not all modes are supported under all platforms. Notably wxGTK3 and {Wx::Mac} only support the following modes:
+  # 
+  # - {Wx::RasterOperationMode::COPY}
+  # - {Wx::RasterOperationMode::OR}
+  # - {Wx::RasterOperationMode::NO_OP}
+  # - {Wx::RasterOperationMode::CLEAR}
+  # - {Wx::RasterOperationMode::XOR} and only support the commonly used {Wx::RasterOperationMode::INVERT} when the source colour is white (as it is implemented using {Wx::CompositionMode::COMPOSITION_DIFF} composition mode).
   # 
   class RasterOperationMode < Wx::Enum
   
@@ -302,13 +307,13 @@ module Wx
     #   @param bitmap [Wx::Bitmap] 
     #   @param x [Integer] 
     #   @param y [Integer] 
-    #   @param useMask [true,false] 
+    #   @param useMask [Boolean] 
     #   @return [void]
     # @overload draw_bitmap(bmp, pt, useMask=false)
     #   This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
     #   @param bmp [Wx::Bitmap] 
     #   @param pt [Array(Integer, Integer), Wx::Point] 
-    #   @param useMask [true,false] 
+    #   @param useMask [Boolean] 
     #   @return [void]
     def draw_bitmap(*args) end
     
@@ -458,7 +463,7 @@ module Wx
     # @param points [Array<Wx::Point>,Array<Array<Integer>>] 
     # @param xoffset [Integer] 
     # @param yoffset [Integer] 
-    # @param fill_style [PolygonFillMode] 
+    # @param fill_style [Wx::PolygonFillMode] 
     # @return [void]
     def draw_polygon(points, xoffset=0, yoffset=0, fill_style=Wx::PolygonFillMode::ODDEVEN_RULE) end
     
@@ -471,7 +476,7 @@ module Wx
     # @param points [Array<Array<Wx::Point>>,Array<Array<Array<Integer>>>] 
     # @param xoffset [Integer] 
     # @param yoffset [Integer] 
-    # @param fill_style [PolygonFillMode] 
+    # @param fill_style [Wx::PolygonFillMode] 
     # @return [void]
     def draw_poly_polygon(points, xoffset=0, yoffset=0, fill_style=Wx::PolygonFillMode::ODDEVEN_RULE) end
     
@@ -593,31 +598,32 @@ module Wx
     # @param rect [Wx::Rect] 
     # @param initialColour [Wx::Colour,String,Symbol] 
     # @param destColour [Wx::Colour,String,Symbol] 
-    # @param nDirection [Direction] 
+    # @param nDirection [Wx::Direction] 
     # @return [void]
     def gradient_fill_linear(rect, initialColour, destColour, nDirection=Wx::Direction::RIGHT) end
     
     # @overload flood_fill(x, y, colour, style=Wx::FloodFillStyle::FLOOD_SURFACE)
     #   Flood fills the device context starting from the given point, using the current brush colour, and using a style:
-    #   - {Wx::FloodFillStyle::FLOOD_SURFACE}: The flooding occurs until a colour other than the given colour is encountered.- {Wx::FloodFillStyle::FLOOD_BORDER}: The area to be flooded is bounded by the given colour.
+    #   - {Wx::FloodFillStyle::FLOOD_SURFACE}: The flooding occurs until a colour other than the given colour is encountered.
+    #   - {Wx::FloodFillStyle::FLOOD_BORDER}: The area to be flooded is bounded by the given colour.
     #   
-    #   Currently this method is not implemented in {Wx::OSX} and does nothing there.
+    #   Currently this method is not implemented in wxOSX and does nothing there.
     #   false if the operation failed.
     #   
     #   The present implementation for non-Windows platforms may fail to find colour borders if the pixels do not match the colour exactly. However the function will still return true.
     #   
-    #   This method shouldn't be used with {Wx::PaintDC} under non-Windows platforms as it uses {Wx::DC#get_pixel} internally and this may give wrong results, notably in {Wx::GTK}. If you need to flood fill {Wx::PaintDC}, create a temporary {Wx::MemoryDC}, flood fill it and then blit it to, or draw as a bitmap on, {Wx::PaintDC}. See the example of doing this in the drawing sample and {Wx::BufferedPaintDC} class.
+    #   This method shouldn't be used with {Wx::PaintDC} under non-Windows platforms as it uses {Wx::DC#get_pixel} internally and this may give wrong results, notably in wxGTK. If you need to flood fill {Wx::PaintDC}, create a temporary {Wx::MemoryDC}, flood fill it and then blit it to, or draw as a bitmap on, {Wx::PaintDC}. See the example of doing this in the drawing sample and {Wx::BufferedPaintDC} class.
     #   @param x [Integer] 
     #   @param y [Integer] 
     #   @param colour [Wx::Colour,String,Symbol] 
-    #   @param style [FloodFillStyle] 
-    #   @return [true,false]
+    #   @param style [Wx::FloodFillStyle] 
+    #   @return [Boolean]
     # @overload flood_fill(pt, col, style=Wx::FloodFillStyle::FLOOD_SURFACE)
     #   This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
     #   @param pt [Array(Integer, Integer), Wx::Point] 
     #   @param col [Wx::Colour,String,Symbol] 
-    #   @param style [FloodFillStyle] 
-    #   @return [true,false]
+    #   @param style [Wx::FloodFillStyle] 
+    #   @return [Boolean]
     def flood_fill(*args) end
     
     # @overload cross_hair(x, y)
@@ -646,11 +652,11 @@ module Wx
     #   true if there is a clipping region or false if there is no active clipping region (note that this return value is available only since wxWidgets 3.1.2, this function didn't return anything in the previous versions).
     #   @param x [Integer]  If non-NULL, filled in with the logical horizontal coordinate of the top left corner of the clipping region if the function returns true or 0 otherwise.
     #   @param y [Integer]  If non-NULL, filled in with the logical vertical coordinate of the top left corner of the clipping region if the function returns true or 0 otherwise.
-    #   @return [Array(true,false,Integer,Integer)]
+    #   @return [Array(Boolean,Integer,Integer)]
     # @overload get_clipping_box(rect)
     #   This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
     #   @param rect [Wx::Rect] 
-    #   @return [true,false]
+    #   @return [Boolean]
     def get_clipping_box(*args) end
     alias_method :clipping_box, :get_clipping_box
     
@@ -658,7 +664,10 @@ module Wx
     #   Sets the clipping region for this device context to the intersection of the given region described by the parameters of this method and the previously set clipping region.
     #   The clipping region is an area to which drawing is restricted. Possible uses for the clipping region are for clipping text or for speeding up window redraws when only a known area of the screen is damaged.
     #   
-    #   - Clipping region should be given in logical coordinates.- Calling this function can only make the clipping region smaller, never larger.- You need to call {Wx::DC#destroy_clipping_region} first if you want to set the clipping region exactly to the region specified.- If resulting clipping region is empty, then all drawing on the DC is clipped out (all changes made by drawing operations are masked out).
+    #   - Clipping region should be given in logical coordinates.
+    #   - Calling this function can only make the clipping region smaller, never larger.
+    #   - You need to call {Wx::DC#destroy_clipping_region} first if you want to set the clipping region exactly to the region specified.
+    #   - If resulting clipping region is empty, then all drawing on the DC is clipped out (all changes made by drawing operations are masked out).
     #   @see Wx::DC#destroy_clipping_region
     #   @see  Wx::Region 
     #   @param x [Integer] 
@@ -697,7 +706,7 @@ module Wx
     
     # Returns the various font characteristics.
     # This method allows retrieving some of the font characteristics not returned by {Wx::DC#get_text_extent}, notably internal leading and average character width.
-    # Currently this method returns correct results only under {Wx::MSW}, in the other ports the internal leading will always be 0 and the average character width will be computed as the width of the character 'x'.
+    # Currently this method returns correct results only under wxMSW, in the other ports the internal leading will always be 0 and the average character width will be computed as the width of the character 'x'.
     # @return [Wx::FontMetrics]
     def get_font_metrics; end
     alias_method :font_metrics, :get_font_metrics
@@ -770,7 +779,7 @@ module Wx
     # Gets the current layout direction of the device context.
     # On platforms where RTL layout is supported, the return value will either be {Wx::LayoutDirection::Layout_LeftToRight} or {Wx::LayoutDirection::Layout_RightToLeft}. If RTL layout is not supported, the return value will be {Wx::LayoutDirection::Layout_Default}.
     # @see Wx::DC#set_layout_direction 
-    # @return [LayoutDirection]
+    # @return [Wx::LayoutDirection]
     def get_layout_direction; end
     alias_method :layout_direction, :get_layout_direction
     
@@ -797,7 +806,7 @@ module Wx
     alias_method :background_mode=, :set_background_mode
     
     # Sets the current font for the DC.
-    # The font parameter should be valid, although in {Wx::MSW} port (only) the argument {Wx::NULL_FONT} is also accepted and resets the device context font to the default value used by the system (which is not generally useful).
+    # The font parameter should be valid, although in wxMSW port (only) the argument {Wx::NULL_FONT} is also accepted and resets the device context font to the default value used by the system (which is not generally useful).
     # @see Wx::Font 
     # @param font [Wx::Font,Wx::FontInfo] 
     # @return [void]
@@ -821,7 +830,7 @@ module Wx
     # Sets the current layout direction for the device context.
     # 
     # @see Wx::DC#get_layout_direction 
-    # @param dir [LayoutDirection]  May be either {Wx::LayoutDirection::Layout_Default}, {Wx::LayoutDirection::Layout_LeftToRight} or {Wx::LayoutDirection::Layout_RightToLeft}.
+    # @param dir [Wx::LayoutDirection]  May be either {Wx::LayoutDirection::Layout_Default}, {Wx::LayoutDirection::Layout_LeftToRight} or {Wx::LayoutDirection::Layout_RightToLeft}.
     # @return [void]
     def set_layout_direction(dir) end
     alias_method :layout_direction=, :set_layout_direction
@@ -859,7 +868,7 @@ module Wx
     # Starts a document (only relevant when outputting to a printer).
     # message is a message to show while printing.
     # @param message [String] 
-    # @return [true,false]
+    # @return [Boolean]
     def start_doc(message) end
     
     # Starts a document page (only relevant when outputting to a printer).
@@ -890,18 +899,24 @@ module Wx
     # @param source [Wx::DC]  Source device context.
     # @param xsrc [Integer]  Source device context x position.
     # @param ysrc [Integer]  Source device context y position.
-    # @param logicalFunc [RasterOperationMode]  Logical function to use, see {Wx::DC#set_logical_function}.
-    # @param useMask [true,false]  If true, Blit does a transparent blit using the mask that is associated with the bitmap selected into the source device context. The Windows implementation does the following if MaskBlt cannot be used: 
+    # @param logicalFunc [Wx::RasterOperationMode]  Logical function to use, see {Wx::DC#set_logical_function}.
+    # @param useMask [Boolean]  If true, Blit does a transparent blit using the mask that is associated with the bitmap selected into the source device context. The Windows implementation does the following if MaskBlt cannot be used: 
+    #   
     #   - 
     #   Creates a temporary bitmap and copies the destination area into it. 
+    #   
     #   - 
     #   Copies the source area into the temporary bitmap using the specified logical function. 
+    #   
     #   - 
     #   Sets the masked area in the temporary bitmap to BLACK by ANDing the mask bitmap with the temp bitmap with the foreground colour set to WHITE and the bg colour set to BLACK. 
+    #   
     #   - 
     #   Sets the unmasked area in the destination area to BLACK by ANDing the mask bitmap with the destination area with the foreground colour set to BLACK and the background colour set to WHITE. 
+    #   
     #   - 
     #   ORs the temporary bitmap with the destination area. 
+    #   
     #   - 
     #   Deletes the temporary bitmap. 
     #   
@@ -910,7 +925,7 @@ module Wx
     #    <b>Note:</b> on Windows, blitting with masks can be speeded up considerably by compiling wxWidgets with the {Wx::Setup::USE_DC_CACHEING} option enabled. You can also influence whether MaskBlt or the explicit mask blitting code above is used, by using {Wx::SystemOptions} and setting the <code>no-maskblt</code> option to 1.
     # @param xsrcMask [Integer]  Source x position on the mask. If both xsrcMask and ysrcMask are <code>-1</code>, xsrc and ysrc will be assumed for the mask source position. Currently only implemented on Windows.
     # @param ysrcMask [Integer]  Source y position on the mask. If both xsrcMask and ysrcMask are <code>-1</code>, xsrc and ysrc will be assumed for the mask source position. Currently only implemented on Windows.
-    # @return [true,false]
+    # @return [Boolean]
     def blit(xdest, ydest, width, height, source, xsrc, ysrc, logicalFunc=Wx::RasterOperationMode::COPY, useMask=false, xsrcMask=Wx::DEFAULT_COORD, ysrcMask=Wx::DEFAULT_COORD) end
     
     # Copy from a source DC to this DC possibly changing the scale.
@@ -932,18 +947,24 @@ module Wx
     # @param ysrc [Integer]  Source device context y position.
     # @param srcWidth [Integer]  Width of source area to be copied.
     # @param srcHeight [Integer]  Height of source area to be copied.
-    # @param logicalFunc [RasterOperationMode]  Logical function to use, see {Wx::DC#set_logical_function}.
-    # @param useMask [true,false]  If true, Blit does a transparent blit using the mask that is associated with the bitmap selected into the source device context. The Windows implementation does the following if MaskBlt cannot be used: 
+    # @param logicalFunc [Wx::RasterOperationMode]  Logical function to use, see {Wx::DC#set_logical_function}.
+    # @param useMask [Boolean]  If true, Blit does a transparent blit using the mask that is associated with the bitmap selected into the source device context. The Windows implementation does the following if MaskBlt cannot be used: 
+    #   
     #   - 
     #   Creates a temporary bitmap and copies the destination area into it. 
+    #   
     #   - 
     #   Copies the source area into the temporary bitmap using the specified logical function. 
+    #   
     #   - 
     #   Sets the masked area in the temporary bitmap to BLACK by ANDing the mask bitmap with the temp bitmap with the foreground colour set to WHITE and the bg colour set to BLACK. 
+    #   
     #   - 
     #   Sets the unmasked area in the destination area to BLACK by ANDing the mask bitmap with the destination area with the foreground colour set to BLACK and the background colour set to WHITE. 
+    #   
     #   - 
     #   ORs the temporary bitmap with the destination area. 
+    #   
     #   - 
     #   Deletes the temporary bitmap. 
     #   
@@ -952,7 +973,7 @@ module Wx
     #    <b>Note:</b> on Windows, blitting with masks can be speeded up considerably by compiling wxWidgets with the {Wx::Setup::USE_DC_CACHEING} option enabled. You can also influence whether MaskBlt or the explicit mask blitting code above is used, by using {Wx::SystemOptions} and setting the <code>no-maskblt</code> option to 1.
     # @param xsrcMask [Integer]  Source x position on the mask. If both xsrcMask and ysrcMask are {Wx::DEFAULT_COORD}, xsrc and ysrc will be assumed for the mask source position. Currently only implemented on Windows.
     # @param ysrcMask [Integer]  Source y position on the mask. If both xsrcMask and ysrcMask are {Wx::DEFAULT_COORD}, xsrc and ysrc will be assumed for the mask source position. Currently only implemented on Windows.
-    # @return [true,false]
+    # @return [Boolean]
     def stretch_blit(xdest, ydest, dstWidth, dstHeight, source, xsrc, ysrc, srcWidth, srcHeight, logicalFunc=Wx::RasterOperationMode::COPY, useMask=false, xsrcMask=Wx::DEFAULT_COORD, ysrcMask=Wx::DEFAULT_COORD) end
     
     # Gets the brush used for painting the background.
@@ -999,36 +1020,13 @@ module Wx
     def set_pen(pen) end
     alias_method :pen=, :set_pen
     
-    # Check if the use of transformation matrix is supported by the current system.
-    # This function returns true for MSW and GTK+ 3 platforms and since 3.1.1 also for {Wx::GCDC} in all ports.
-    # @return [true,false]
-    def can_use_transform_matrix; end
-    alias_method :can_use_transform_matrix?, :can_use_transform_matrix
-    
-    # Set the transformation matrix.
-    # If transformation matrix is supported on the current system, the specified matrix will be used to transform between {Wx::DC} and physical coordinates. Otherwise the function returns false and doesn't change the coordinate mapping.
-    # @param matrix [Wx::AffineMatrix2D] 
-    # @return [true,false]
-    def set_transform_matrix(matrix) end
-    alias_method :transform_matrix=, :set_transform_matrix
-    
-    # Return the transformation matrix used by this device context.
-    # By default the transformation matrix is the identity matrix.
-    # @return [Wx::AffineMatrix2D]
-    def get_transform_matrix; end
-    alias_method :transform_matrix, :get_transform_matrix
-    
-    # Revert the transformation matrix to identity matrix.
-    # @return [void]
-    def reset_transform_matrix; end
-    
     # Does the DC support drawing bitmaps?
-    # @return [true,false]
+    # @return [Boolean]
     def can_draw_bitmap; end
     alias_method :can_draw_bitmap?, :can_draw_bitmap
     
     # Does the DC support calculating the size required to draw text?
-    # @return [true,false]
+    # @return [Boolean]
     def can_get_text_extent; end
     alias_method :can_get_text_extent?, :can_get_text_extent
     
@@ -1041,7 +1039,11 @@ module Wx
     
     # Copy attributes from another DC.
     # The copied attributes currently are:
-    # - Font- Text foreground and background colours- Background brush- Layout direction
+    # 
+    # - Font
+    # - Text foreground and background colours
+    # - Background brush
+    # - Layout direction
     # 
     # Note that the scaling factor is not considered to be an attribute of {Wx::DC} and is not copied by this function.
     # @param dc [Wx::DC]  A valid (i.e. its {Wx::DC#is_ok} must return true) source device context.
@@ -1049,7 +1051,8 @@ module Wx
     def copy_attributes(dc) end
     
     # Returns the factor used for converting logical pixels to physical ones.
-    # Returns the same value as {Wx::Window#get_content_scale_factor} for the device contexts associated with a window and the same value as {Wx::Bitmap#get_scale_factor} for the associated bitmap for {Wx::MemoryDC}.
+    # Returns the same value as {Wx::Window#get_dpi_scale_factor} for the device contexts associated with a window and the same value as {Wx::Bitmap#get_scale_factor} for the associated bitmap for {Wx::MemoryDC}.
+    # Beware that since wxWidgets 3.1.6, this function does not return the same value as {Wx::Window#get_content_scale_factor} for the device contexts associated with the window. Unlike {Wx::Window} method, it always returns the effective scale factor instead of always returning 1 on platforms where logical pixels are the same as physical ones, such as MSW.
     # @return [Float]
     def get_content_scale_factor; end
     alias_method :content_scale_factor, :get_content_scale_factor
@@ -1071,26 +1074,26 @@ module Wx
     # Gets the current logical function.
     # 
     # @see Wx::DC#set_logical_function 
-    # @return [RasterOperationMode]
+    # @return [Wx::RasterOperationMode]
     def get_logical_function; end
     alias_method :logical_function, :get_logical_function
     
     # Gets the current mapping mode for the device context.
     # 
     # @see Wx::DC#set_map_mode 
-    # @return [MappingMode]
+    # @return [Wx::MappingMode]
     def get_map_mode; end
     alias_method :map_mode, :get_map_mode
     
     # Gets in colour the colour at the specified location.
-    # This method isn't available for {Wx::PRT::PostScriptDC} or {Wx::MetafileDC} nor for any DC in {Wx::OSX} port and simply returns false there.
+    # This method isn't available for {Wx::PRT::PostScriptDC} or {Wx::MetafileDC} nor for any DC in wxOSX port and simply returns false there.
     # Setting a pixel can be done using {Wx::DC#draw_point}.
     # 
-    # This method shouldn't be used with {Wx::PaintDC} as accessing the DC while drawing can result in unexpected results, notably in {Wx::GTK}.
+    # This method shouldn't be used with {Wx::PaintDC} as accessing the DC while drawing can result in unexpected results, notably in wxGTK.
     # @param x [Integer] 
     # @param y [Integer] 
     # @param colour [Wx::Colour] 
-    # @return [true,false]
+    # @return [Boolean]
     def get_pixel(x, y, colour) end
     alias_method :pixel, :get_pixel
     
@@ -1163,21 +1166,19 @@ module Wx
     # Gets the current user scale factor.
     # 
     # @see Wx::DC#set_user_scale 
-    # @param x [double] 
-    # @param y [double] 
-    # @return [void]
-    def get_user_scale(x, y) end
+    # @return [Array(Float,Float)]
+    def get_user_scale; end
     alias_method :user_scale, :get_user_scale
     
     # Returns true if the DC is ok to use.
-    # @return [true,false]
+    # @return [Boolean]
     def is_ok; end
     alias_method :ok?, :is_ok
     
     # Sets the x and y axis orientation (i.e. the direction from lowest to highest values on the axis).
     # The default orientation is x axis from left to right and y axis from top down.
-    # @param xLeftRight [true,false]  True to set the x axis orientation to the natural left to right orientation, false to invert it.
-    # @param yBottomUp [true,false]  True to set the y axis orientation to the natural bottom up orientation, false to invert it.
+    # @param xLeftRight [Boolean]  True to set the x axis orientation to the natural left to right orientation, false to invert it.
+    # @param yBottomUp [Boolean]  True to set the y axis orientation to the natural bottom up orientation, false to invert it.
     # @return [void]
     def set_axis_orientation(xLeftRight, yBottomUp) end
     
@@ -1189,12 +1190,12 @@ module Wx
     def set_device_origin(x, y) end
     
     # Sets the current logical function for the device context.
-    # This function is not fully supported in all ports, due to the limitations of the underlying drawing model. Notably, {Wx::RasterOperationMode::INVERT} which was commonly used for drawing rubber bands or other moving outlines in the past, is not, and will not, be supported by {Wx::GTK3} and {Wx::Mac}. The suggested alternative is to draw temporarily objects normally and refresh the (affected part of the) window to remove them later.
+    # This function is not fully supported in all ports, due to the limitations of the underlying drawing model. Notably, {Wx::RasterOperationMode::INVERT} which was commonly used for drawing rubber bands or other moving outlines in the past, is not, and will not, be supported by wxGTK3 and {Wx::Mac}. The suggested alternative is to draw temporarily objects normally and refresh the (affected part of the) window to remove them later.
     # 
     # It determines how a source pixel (from a pen or brush colour, or source device context if using {Wx::DC#blit}) combines with a destination pixel in the current device context. Text drawing is not affected by this function.
     # See {Wx::RasterOperationMode} enumeration values for more info.
     # The default is {Wx::RasterOperationMode::COPY}, which simply draws with the current colour. The others combine the current colour and the background using a logical operation.
-    # @param function [RasterOperationMode] 
+    # @param function [Wx::RasterOperationMode] 
     # @return [void]
     def set_logical_function(function) end
     alias_method :logical_function=, :set_logical_function
@@ -1203,7 +1204,7 @@ module Wx
     # Note that in X, text drawing isn't handled consistently with the mapping mode; a font is always specified in point size. However, setting the user scale (see {Wx::DC#set_user_scale}) scales the text appropriately. In Windows, scalable TrueType fonts are always used; in X, results depend on availability of fonts, but usually a reasonable match is found.
     # The coordinate origin is always at the top left of the screen/printer.
     # Drawing to a Windows printer device context uses the current mapping mode, but mapping mode is currently ignored for PostScript output.
-    # @param mode [MappingMode] 
+    # @param mode [Wx::MappingMode] 
     # @return [void]
     def set_map_mode(mode) end
     alias_method :map_mode=, :set_map_mode
@@ -1236,10 +1237,8 @@ module Wx
     def set_logical_scale(x, y) end
     
     # Return the scale set by the last call to {Wx::DC#set_logical_scale}.
-    # @param x [double] 
-    # @param y [double] 
-    # @return [void]
-    def get_logical_scale(x, y) end
+    # @return [Array(Float,Float)]
+    def get_logical_scale; end
     alias_method :logical_scale, :get_logical_scale
     
     # Change the offset used for translating {Wx::DC} coordinates.
@@ -1266,5 +1265,94 @@ module Wx
     
   end # DC
   
+  # Simple collection of various font metrics.
+  # This object is returned by {Wx::DC#get_font_metrics}.
+  # 
+  # === 
+  # 
+  # Category:  Device Contexts, Graphics Device Interface (GDI)
+  # 
+  # 
+  # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  class FontMetrics < ::Object
+  
+    # Total character height.
+    # 
+    # 
+    # @return [Integer]
+    def height; end
+    # Total character height.
+    # 
+    # 
+    # @param val [Integer]
+    # @return [void]
+    def height=(val); end
+    
+    # Part of the height above the baseline.
+    # 
+    # 
+    # @return [Integer]
+    def ascent; end
+    # Part of the height above the baseline.
+    # 
+    # 
+    # @param val [Integer]
+    # @return [void]
+    def ascent=(val); end
+    
+    # Part of the height below the baseline.
+    # 
+    # 
+    # @return [Integer]
+    def descent; end
+    # Part of the height below the baseline.
+    # 
+    # 
+    # @param val [Integer]
+    # @return [void]
+    def descent=(val); end
+    
+    # Intra-line spacing.
+    # 
+    # 
+    # @return [Integer]
+    def internal_leading; end
+    # Intra-line spacing.
+    # 
+    # 
+    # @param val [Integer]
+    # @return [void]
+    def internal_leading=(val); end
+    
+    # Inter-line spacing.
+    # 
+    # 
+    # @return [Integer]
+    def external_leading; end
+    # Inter-line spacing.
+    # 
+    # 
+    # @param val [Integer]
+    # @return [void]
+    def external_leading=(val); end
+    
+    # Average font width, a.k.a. "x-width".
+    # 
+    # 
+    # @return [Integer]
+    def average_width; end
+    # Average font width, a.k.a. "x-width".
+    # 
+    # 
+    # @param val [Integer]
+    # @return [void]
+    def average_width=(val); end
+    
+    # Constructor initializes all fields to 0.
+    # @return [Wx::FontMetrics]
+    def initialize; end
+    
+  end # FontMetrics
+  
 
 end

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

@@ -2106,67 +2106,67 @@ module Wx
     # 
     K_LAUNCH_APP2 = Wx::KeyCode.new(443)
     
-    # Available since wxWidgets 3.1.6 and only generated by {Wx::GTK}.
+    # Available since wxWidgets 3.1.6 and only generated by wxGTK.
     # 
     K_LAUNCH_0 = Wx::KeyCode.new(432)
     
-    # Available since wxWidgets 3.1.6 and only generated by {Wx::GTK}.
+    # Available since wxWidgets 3.1.6 and only generated by wxGTK.
     # 
     K_LAUNCH_1 = Wx::KeyCode.new(433)
     
-    # Available since wxWidgets 3.1.6 and only generated by {Wx::GTK}.
+    # Available since wxWidgets 3.1.6 and only generated by wxGTK.
     # 
     K_LAUNCH_2 = Wx::KeyCode.new(434)
     
-    # Available since wxWidgets 3.1.6 and only generated by {Wx::GTK}.
+    # Available since wxWidgets 3.1.6 and only generated by wxGTK.
     # 
     K_LAUNCH_3 = Wx::KeyCode.new(435)
     
-    # Available since wxWidgets 3.1.6 and only generated by {Wx::GTK}.
+    # Available since wxWidgets 3.1.6 and only generated by wxGTK.
     # 
     K_LAUNCH_4 = Wx::KeyCode.new(436)
     
-    # Available since wxWidgets 3.1.6 and only generated by {Wx::GTK}.
+    # Available since wxWidgets 3.1.6 and only generated by wxGTK.
     # 
     K_LAUNCH_5 = Wx::KeyCode.new(437)
     
-    # Available since wxWidgets 3.1.6 and only generated by {Wx::GTK}.
+    # Available since wxWidgets 3.1.6 and only generated by wxGTK.
     # 
     K_LAUNCH_6 = Wx::KeyCode.new(438)
     
-    # Available since wxWidgets 3.1.6 and only generated by {Wx::GTK}.
+    # Available since wxWidgets 3.1.6 and only generated by wxGTK.
     # 
     K_LAUNCH_7 = Wx::KeyCode.new(439)
     
-    # Available since wxWidgets 3.1.6 and only generated by {Wx::GTK}.
+    # Available since wxWidgets 3.1.6 and only generated by wxGTK.
     # 
     K_LAUNCH_8 = Wx::KeyCode.new(440)
     
-    # Available since wxWidgets 3.1.6 and only generated by {Wx::GTK}.
+    # Available since wxWidgets 3.1.6 and only generated by wxGTK.
     # 
     K_LAUNCH_9 = Wx::KeyCode.new(441)
     
-    # Available since wxWidgets 3.1.6, generated by {Wx::GTK} and {Wx::MSW}.
+    # Available since wxWidgets 3.1.6, generated by wxGTK and wxMSW.
     # 
     K_LAUNCH_A = Wx::KeyCode.new(442)
     
-    # Available since wxWidgets 3.1.6, generated by {Wx::GTK} and {Wx::MSW}.
+    # Available since wxWidgets 3.1.6, generated by wxGTK and wxMSW.
     # 
     K_LAUNCH_B = Wx::KeyCode.new(443)
     
-    # Available since wxWidgets 3.1.6 and only generated by {Wx::GTK}.
+    # Available since wxWidgets 3.1.6 and only generated by wxGTK.
     # 
     K_LAUNCH_C = Wx::KeyCode.new(444)
     
-    # Available since wxWidgets 3.1.6 and only generated by {Wx::GTK}.
+    # Available since wxWidgets 3.1.6 and only generated by wxGTK.
     # 
     K_LAUNCH_D = Wx::KeyCode.new(445)
     
-    # Available since wxWidgets 3.1.6 and only generated by {Wx::GTK}.
+    # Available since wxWidgets 3.1.6 and only generated by wxGTK.
     # 
     K_LAUNCH_E = Wx::KeyCode.new(446)
     
-    # Available since wxWidgets 3.1.6 and only generated by {Wx::GTK}.
+    # Available since wxWidgets 3.1.6 and only generated by wxGTK.
     # 
     K_LAUNCH_F = Wx::KeyCode.new(447)