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

data/lib/wx/doc/gen/pg/pg_properties.rb

@@ -16,7 +16,7 @@ module Wx::PG
   
     # @param label [String] 
     # @param name [String] 
-    # @param value [true,false] 
+    # @param value [Boolean] 
     # @return [Wx::PG::BoolProperty]
     def initialize(label=Wx::PG::PG_LABEL, name=Wx::PG::PG_LABEL, value=false) end
     
@@ -36,7 +36,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param text [String]  Text to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one (they may be different). If {Wx::PG::PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT} is set, text is interpreted as a part of composite property string value (as generated by {Wx::PG::BoolProperty#value_to_string} called with this same flag).
-    # @return []
+    # @return [Boolean]
     def string_to_value(variant, text, argFlags=0) end
     
     # Converts integer (possibly a choice selection) into {Wx::Variant} value appropriate for this property.
@@ -49,7 +49,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param number [Integer]  Integer to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one.
-    # @return []
+    # @return [Boolean]
     def int_to_value(variant, number, argFlags=0) end
     
     # Reimplement this member function to add special handling for attributes of this property.
@@ -58,7 +58,7 @@ module Wx::PG
     # To actually set property attribute values from the application, use {Wx::PG::PGProperty#set_attribute} instead.
     # @param name [String] 
     # @param value [Wx::Variant] 
-    # @return []
+    # @return [Boolean]
     def do_set_attribute(name, value) end
     
     # 
@@ -108,7 +108,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param text [String]  Text to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one (they may be different). If {Wx::PG::PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT} is set, text is interpreted as a part of composite property string value (as generated by {Wx::PG::DateProperty#value_to_string} called with this same flag).
-    # @return []
+    # @return [Boolean]
     def string_to_value(variant, text, argFlags=0) end
     
     # Reimplement this member function to add special handling for attributes of this property.
@@ -117,7 +117,7 @@ module Wx::PG
     # To actually set property attribute values from the application, use {Wx::PG::PGProperty#set_attribute} instead.
     # @param name [String] 
     # @param value [Wx::Variant] 
-    # @return []
+    # @return [Boolean]
     def do_set_attribute(name, value) end
     
     # @param format [String] 
@@ -219,7 +219,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param text [String]  Text to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one (they may be different). If {Wx::PG::PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT} is set, text is interpreted as a part of composite property string value (as generated by {Wx::PG::FlagsProperty#value_to_string} called with this same flag).
-    # @return []
+    # @return [Boolean]
     def string_to_value(variant, text, argFlags) end
     
     # Called after value of a child property has been altered.
@@ -227,31 +227,24 @@ module Wx::PG
     # Note that this function is usually called at the time that value of this property, or given child property, is still pending for change, and as such, result of {Wx::PG::FlagsProperty#get_value} or m_value should not be relied on.
     # Sample pseudo-code implementation:
     # 
-    # ```
-    #   wxVariant MyProperty::ChildChanged( wxVariant& thisValue,
-    #                                       int childIndex,
-    #                                       wxVariant& childValue ) const
-    #   {
-    #       // Acquire reference to actual type of data stored in variant
-    #       // (TFromVariant only exists if wxPropertyGrid's wxVariant-macros
-    #       // were used to create the variant class).
-    #       T& data = TFromVariant(thisValue);
-    #   
-    #       // Copy childValue into data.
-    #       switch ( childIndex )
-    #       {
-    #           case 0:
-    #               data.SetSubProp1( childvalue.GetLong() );
-    #               break;
-    #           case 1:
-    #               data.SetSubProp2( childvalue.GetString() );
-    #               break;
-    #           ...
-    #       }
-    #   
-    #       // Return altered data
-    #       return data;
-    #   }
+    # ```ruby
+    #   class MyProperty < Wx::PG::FlagsProperty
+    # 
+    #     def child_changed(thisValue, childIndex, childValue)
+    #       # Acquire reference to actual type of data stored in variant
+    #       flags = thisValue.object;
+    #       case childIndex
+    #         when 0
+    #           flags.sub_prop1 = childValue.to_i
+    #         when 1
+    #           flags.sub_prop2 = childValue.to_s
+    #         # ...
+    #       end
+    #       # return altered data
+    #       Wx::Variant.new(flags)
+    #     end
+    # 
+    #   end
     # ```
     # 
     # Modified value of the whole property.
@@ -272,7 +265,7 @@ module Wx::PG
     # To actually set property attribute values from the application, use {Wx::PG::PGProperty#set_attribute} instead.
     # @param name [String] 
     # @param value [Wx::Variant] 
-    # @return []
+    # @return [Boolean]
     def do_set_attribute(name, value) end
     
     # Returns which choice is currently selected.
@@ -332,7 +325,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param text [String]  Text to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one (they may be different). If {Wx::PG::PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT} is set, text is interpreted as a part of composite property string value (as generated by {Wx::PG::StringProperty#value_to_string} called with this same flag).
-    # @return []
+    # @return [Boolean]
     def string_to_value(variant, text, argFlags=0) end
     
     # Reimplement this member function to add special handling for attributes of this property.
@@ -341,7 +334,7 @@ module Wx::PG
     # To actually set property attribute values from the application, use {Wx::PG::PGProperty#set_attribute} instead.
     # @param name [String] 
     # @param value [Wx::Variant] 
-    # @return []
+    # @return [Boolean]
     def do_set_attribute(name, value) end
     
     # This is updated so "<composed>" special value can be handled.
@@ -422,7 +415,7 @@ module Wx::PG
     # To actually set property attribute values from the application, use {Wx::PG::PGProperty#set_attribute} instead.
     # @param name [String] 
     # @param value [Wx::Variant] 
-    # @return []
+    # @return [Boolean]
     def do_set_attribute(name, value) end
     
     # 
@@ -472,7 +465,7 @@ module Wx::PG
     # Returns true if editor dialog was not cancelled and value was updated.
     # @param pg [Wx::PG::PropertyGrid]  Property grid in which property is displayed.
     # @param value [Wx::Variant]  Value to be edited.
-    # @return []
+    # @return [Boolean]
     def display_editor_dialog(pg, value) end
     
   end # EditorDialogProperty
@@ -530,7 +523,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param text [String]  Text to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one (they may be different). If {Wx::PG::PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT} is set, text is interpreted as a part of composite property string value (as generated by {Wx::PG::ArrayStringProperty#value_to_string} called with this same flag).
-    # @return []
+    # @return [Boolean]
     def string_to_value(variant, text, argFlags=0) end
     
     # Reimplement this member function to add special handling for attributes of this property.
@@ -539,7 +532,7 @@ module Wx::PG
     # To actually set property attribute values from the application, use {Wx::PG::PGProperty#set_attribute} instead.
     # @param name [String] 
     # @param value [Wx::Variant] 
-    # @return []
+    # @return [Boolean]
     def do_set_attribute(name, value) end
     
     # Implement in derived class for custom array-to-string conversion.
@@ -551,7 +544,7 @@ module Wx::PG
     # Shows string editor dialog to edit the individual item.
     # Value to be edited should be read from value, and if dialog is not cancelled, it should be stored back and true should be returned if that was the case.
     # @param parent [Wx::Window] 
-    # @return [Array(,String)]
+    # @return [String]
     def on_custom_string_edit(parent) end
     
     # Creates {Wx::PG::PGArrayEditorDialog} for string editing.
@@ -618,7 +611,7 @@ module Wx::PG
     # Returns true if editor dialog was not cancelled and value was updated.
     # @param pg [Wx::PG::PropertyGrid]  Property grid in which property is displayed.
     # @param value [Wx::Variant]  Value to be edited.
-    # @return []
+    # @return [Boolean]
     def display_editor_dialog(pg, value) end
     
   end # ArrayStringProperty
@@ -652,24 +645,31 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param text [String]  Text to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one (they may be different). If {Wx::PG::PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT} is set, text is interpreted as a part of composite property string value (as generated by {Wx::PG::DirProperty#value_to_string} called with this same flag).
-    # @return []
+    # @return [Boolean]
     def string_to_value(variant, text, argFlags=0) end
     
     # Returns pointer to the {Wx::Validator} that should be used with the editor of this property (NULL for no validator).
-    # Setting validator explicitly via SetPropertyValidator will override this.
-    # In most situations, code like this should work well (macros are used to maintain one actual validator instance, so on the second call the function exits within the first macro):
+    # Setting validator explicitly via #set_property_validator will override this.
+    # In most situations, code like this should work well:
     # 
-    # ```
-    #   wxValidator* wxMyPropertyClass::DoGetValidator () const
-    #   {
-    #       WX_PG_DOGETVALIDATOR_ENTRY()
-    #   
-    #       wxMyValidator* validator = new wxMyValidator(...);
-    #   
-    #       ... prepare validator...
-    #   
-    #       WX_PG_DOGETVALIDATOR_EXIT(validator)
-    #   }
+    # ```ruby
+    #   class MyPropertyClass < Wx::PG::DirProperty
+    # 
+    #     class << self
+    #       def validator
+    #         @validator ||= MyValidator.new(...)
+    #       end
+    #     end
+    #     
+    #     # ...
+    # 
+    #     def do_get_validator
+    #       MyPropertyClass.validator
+    #     end
+    # 
+    #     # ...
+    # 
+    #   end
     # ```
     # 
     # You can get common filename validator by returning {Wx::PG::FileProperty.get_class_validator}. {Wx::PG::DirProperty}, for example, uses it.
@@ -693,7 +693,7 @@ module Wx::PG
     # Returns true if editor dialog was not cancelled and value was updated.
     # @param pg [Wx::PG::PropertyGrid]  Property grid in which property is displayed.
     # @param value [Wx::Variant]  Value to be edited.
-    # @return []
+    # @return [Boolean]
     def display_editor_dialog(pg, value) end
     
   end # DirProperty
@@ -739,7 +739,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param text [String]  Text to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one (they may be different). If {Wx::PG::PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT} is set, text is interpreted as a part of composite property string value (as generated by {Wx::PG::FileProperty#value_to_string} called with this same flag).
-    # @return []
+    # @return [Boolean]
     def string_to_value(variant, text, argFlags=0) end
     
     # Reimplement this member function to add special handling for attributes of this property.
@@ -748,24 +748,31 @@ module Wx::PG
     # To actually set property attribute values from the application, use {Wx::PG::PGProperty#set_attribute} instead.
     # @param name [String] 
     # @param value [Wx::Variant] 
-    # @return []
+    # @return [Boolean]
     def do_set_attribute(name, value) end
     
     # Returns pointer to the {Wx::Validator} that should be used with the editor of this property (NULL for no validator).
-    # Setting validator explicitly via SetPropertyValidator will override this.
-    # In most situations, code like this should work well (macros are used to maintain one actual validator instance, so on the second call the function exits within the first macro):
+    # Setting validator explicitly via #set_property_validator will override this.
+    # In most situations, code like this should work well:
     # 
-    # ```
-    #   wxValidator* wxMyPropertyClass::DoGetValidator () const
-    #   {
-    #       WX_PG_DOGETVALIDATOR_ENTRY()
-    #   
-    #       wxMyValidator* validator = new wxMyValidator(...);
-    #   
-    #       ... prepare validator...
-    #   
-    #       WX_PG_DOGETVALIDATOR_EXIT(validator)
-    #   }
+    # ```ruby
+    #   class MyPropertyClass < Wx::PG::FileProperty
+    # 
+    #     class << self
+    #       def validator
+    #         @validator ||= MyValidator.new(...)
+    #       end
+    #     end
+    # 
+    #     # ...
+    # 
+    #     def do_get_validator
+    #       MyPropertyClass.validator
+    #     end
+    # 
+    #     # ...
+    # 
+    #   end
     # ```
     # 
     # You can get common filename validator by returning {Wx::PG::FileProperty.get_class_validator}. {Wx::PG::DirProperty}, for example, uses it.
@@ -773,7 +780,7 @@ module Wx::PG
     def do_get_validator; end
     
     # Returns filename to file represented by current value.
-    # @return [Wx::FileName]
+    # @return [String]
     def get_file_name; end
     alias_method :file_name, :get_file_name
     
@@ -845,7 +852,7 @@ module Wx::PG
     # Returns true if editor dialog was not cancelled and value was updated.
     # @param pg [Wx::PG::PropertyGrid]  Property grid in which property is displayed.
     # @param value [Wx::Variant]  Value to be edited.
-    # @return []
+    # @return [Boolean]
     def display_editor_dialog(pg, value) end
     
   end # FileProperty
@@ -897,23 +904,7 @@ module Wx::PG
     # @see Wx::PG::ImageFileProperty#value_to_string 
     # @param dc [Wx::DC]  {Wx::DC} to paint on.
     # @param rect [Wx::Rect]  Box reserved for custom graphics. Includes surrounding rectangle, if any. If x+width is < 0, then this is a measure item call (see above).
-    # @param paintdata [Wx::PG::PGPaintData]  {Wx::PG::PGPaintData} structure with much useful data about painted item. 
-    #   ```
-    #     struct wxPGPaintData
-    #     {
-    #         // wxPropertyGrid.
-    #         const wxPropertyGrid*   m_parent;
-    #     
-    #         // Normally -1, otherwise index to drop-down list item that has to be drawn.
-    #         int                     m_choiceItem;
-    #     
-    #         // Set to drawn width in OnCustomPaint (optional).
-    #         int                     m_drawnWidth;
-    #     
-    #         // In a measure item call, set this to the height of item at m_choiceItem index
-    #         int                     m_drawnHeight;
-    #     };
-    #   ```
+    # @param paintdata [Wx::PG::PGPaintData]  {Wx::PG::PGPaintData} structure with much useful data about painted item.
     # @return [void]
     def on_custom_paint(dc, rect, paintdata) end
     
@@ -959,31 +950,30 @@ module Wx::PG
     # Note that this function is usually called at the time that value of this property, or given child property, is still pending for change, and as such, result of {Wx::PG::FontProperty#get_value} or m_value should not be relied on.
     # Sample pseudo-code implementation:
     # 
-    # ```
-    #   wxVariant MyProperty::ChildChanged( wxVariant& thisValue,
-    #                                       int childIndex,
-    #                                       wxVariant& childValue ) const
-    #   {
-    #       // Acquire reference to actual type of data stored in variant
-    #       // (TFromVariant only exists if wxPropertyGrid's wxVariant-macros
-    #       // were used to create the variant class).
-    #       T& data = TFromVariant(thisValue);
-    #   
-    #       // Copy childValue into data.
-    #       switch ( childIndex )
-    #       {
-    #           case 0:
-    #               data.SetSubProp1( childvalue.GetLong() );
-    #               break;
-    #           case 1:
-    #               data.SetSubProp2( childvalue.GetString() );
-    #               break;
-    #           ...
-    #       }
-    #   
-    #       // Return altered data
-    #       return data;
-    #   }
+    # ```ruby
+    #   class WxFontDataProperty < Wx::PG::FontProperty
+    # 
+    #     def child_changed(thisValue, childIndex, childValue)
+    #       fontData = thisValue.object
+    #       fontData.initial_font = fontData.chosen_font
+    #       
+    #       case childIndex
+    #         when 6
+    #           col = childValue.colour
+    #           fontData.colour = col
+    #         else
+    #           # Transfer from subset to superset.
+    #           font = fontData.chosen_font
+    #           variant = Wx::Variant.new(font)
+    #           variant = super(variant, childIndex, childValue)
+    #           font = variant.font
+    #           fontData.chosen_font = font
+    #       end
+    #       
+    #       Wx::Variant.new(fontData)
+    #     end
+    # 
+    #   end
     # ```
     # 
     # Modified value of the whole property.
@@ -1015,7 +1005,7 @@ module Wx::PG
     # Returns true if editor dialog was not cancelled and value was updated.
     # @param pg [Wx::PG::PropertyGrid]  Property grid in which property is displayed.
     # @param value [Wx::Variant]  Value to be edited.
-    # @return []
+    # @return [Boolean]
     def display_editor_dialog(pg, value) end
     
   end # FontProperty
@@ -1049,7 +1039,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param text [String]  Text to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one (they may be different). If {Wx::PG::PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT} is set, text is interpreted as a part of composite property string value (as generated by {Wx::PG::LongStringProperty#value_to_string} called with this same flag).
-    # @return []
+    # @return [Boolean]
     def string_to_value(variant, text, argFlags=0) end
     
     # 
@@ -1069,7 +1059,7 @@ module Wx::PG
     # Returns true if editor dialog was not cancelled and value was updated.
     # @param pg [Wx::PG::PropertyGrid]  Property grid in which property is displayed.
     # @param value [Wx::Variant]  Value to be edited.
-    # @return []
+    # @return [Boolean]
     def display_editor_dialog(pg, value) end
     
   end # LongStringProperty
@@ -1125,7 +1115,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param text [String]  Text to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one (they may be different). If {Wx::PG::PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT} is set, text is interpreted as a part of composite property string value (as generated by {Wx::PG::MultiChoiceProperty#value_to_string} called with this same flag).
-    # @return []
+    # @return [Boolean]
     def string_to_value(variant, text, argFlags=0) end
     
     # @return [Array<Integer>]
@@ -1181,7 +1171,7 @@ module Wx::PG
     # Returns true if editor dialog was not cancelled and value was updated.
     # @param pg [Wx::PG::PropertyGrid]  Property grid in which property is displayed.
     # @param value [Wx::Variant]  Value to be edited.
-    # @return []
+    # @return [Boolean]
     def display_editor_dialog(pg, value) end
     
   end # MultiChoiceProperty
@@ -1202,7 +1192,7 @@ module Wx::PG
     # To actually set property attribute values from the application, use {Wx::PG::PGProperty#set_attribute} instead.
     # @param name [String] 
     # @param value [Wx::Variant] 
-    # @return []
+    # @return [Boolean]
     def do_set_attribute(name, value) end
     
     # Returns what would be the new value of the property after adding SpinCtrl editor step to the current value.
@@ -1216,7 +1206,7 @@ module Wx::PG
     def add_spin_step_value(stepScale) end
     
     # Return true if value can be changed with SpinCtrl editor by moving the mouse.
-    # @return []
+    # @return [Boolean]
     def use_spin_motion; end
     
     # 
@@ -1246,12 +1236,12 @@ module Wx::PG
     # 
     # 
     # 
-    # @return []
+    # @return [Boolean]
     def spin_motion_; end
     # 
     # 
     # 
-    # @param val [true,false]
+    # @param val [Boolean]
     # @return [void]
     def spin_motion_=(val); end
     
@@ -1270,12 +1260,12 @@ module Wx::PG
     # 
     # 
     # 
-    # @return []
+    # @return [Boolean]
     def spin_wrap_; end
     # 
     # 
     # 
-    # @param val [true,false]
+    # @param val [Boolean]
     # @return [void]
     def spin_wrap_=(val); end
     
@@ -1299,39 +1289,7 @@ module Wx::PG
   end # NumericProperty
   
   # Basic property with integer value.
-  # Seamlessly supports 64-bit integer ({Wx::LongLong}) on overflow.
-  # <b>Example how to use seamless 64-bit integer support</b>
-  # Getting value:
-  # 
-  # ```
-  #   wxLongLong_t value = pg->GetPropertyValueAsLongLong();
-  # ```
-  # 
-  # or
-  # 
-  # ```
-  #   wxLongLong_t value;
-  #   wxVariant variant = property->GetValue();
-  #   if ( variant.GetType() == "wxLongLong" )
-  #       value = wxLongLongFromVariant(variant);
-  #   else
-  #       value = variant.GetLong();
-  # ```
-  # 
-  # Setting value:
-  # 
-  # ```
-  #   pg->SetPropertyValue(longLongVal);
-  # ```
-  # 
-  # or
-  # 
-  # ```
-  #   property->SetValue(WXVARIANT(longLongVal));
-  # ```
-  # 
   # <b>Supported special attributes:</b>
-  # 
   # - {Wx::PG::PG_ATTR_MIN}, {Wx::PG::PG_ATTR_MAX}, {Wx::PG::PG_ATTR_SPINCTRL_STEP}, {Wx::PG::PG_ATTR_SPINCTRL_WRAP}, {Wx::PG::PG_ATTR_SPINCTRL_MOTION}: like in {Wx::PG::NumericProperty}.
   # 
   class IntProperty < NumericProperty
@@ -1364,7 +1322,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param text [String]  Text to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one (they may be different). If {Wx::PG::PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT} is set, text is interpreted as a part of composite property string value (as generated by {Wx::PG::IntProperty#value_to_string} called with this same flag).
-    # @return []
+    # @return [Boolean]
     def string_to_value(variant, text, argFlags=0) end
     
     # Implement this function in derived class to check the value.
@@ -1373,7 +1331,7 @@ module Wx::PG
     # - Default implementation always returns true.
     # @param value [Wx::Variant] 
     # @param validationInfo [Wx::PG::PGValidationInfo] 
-    # @return []
+    # @return [Boolean]
     def validate_value(value, validationInfo) end
     
     # Converts integer (possibly a choice selection) into {Wx::Variant} value appropriate for this property.
@@ -1386,24 +1344,31 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param number [Integer]  Integer to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one.
-    # @return []
+    # @return [Boolean]
     def int_to_value(variant, number, argFlags=0) end
     
     # Returns pointer to the {Wx::Validator} that should be used with the editor of this property (NULL for no validator).
-    # Setting validator explicitly via SetPropertyValidator will override this.
-    # In most situations, code like this should work well (macros are used to maintain one actual validator instance, so on the second call the function exits within the first macro):
+    # Setting validator explicitly via #set_property_validator will override this.
+    # In most situations, code like this should work well:
     # 
-    # ```
-    #   wxValidator* wxMyPropertyClass::DoGetValidator () const
-    #   {
-    #       WX_PG_DOGETVALIDATOR_ENTRY()
-    #   
-    #       wxMyValidator* validator = new wxMyValidator(...);
-    #   
-    #       ... prepare validator...
-    #   
-    #       WX_PG_DOGETVALIDATOR_EXIT(validator)
-    #   }
+    # ```ruby
+    #   class MyPropertyClass < Wx::PG::IntProperty
+    # 
+    #     class << self
+    #       def validator
+    #         @validator ||= MyValidator.new(...)
+    #       end
+    #     end
+    # 
+    #     # ...
+    # 
+    #     def do_get_validator
+    #       MyPropertyClass.validator
+    #     end
+    # 
+    #     # ...
+    # 
+    #   end
     # ```
     # 
     # You can get common filename validator by returning {Wx::PG::FileProperty.get_class_validator}. {Wx::PG::DirProperty}, for example, uses it.
@@ -1448,10 +1413,10 @@ module Wx::PG
     def max_val_=(val); end
     
     # 
-    # @return []
+    # @return [Boolean]
     def spin_motion_; end
     # 
-    # @param val [true,false]
+    # @param val [Boolean]
     # @return [void]
     def spin_motion_=(val); end
     
@@ -1464,10 +1429,10 @@ module Wx::PG
     def spin_step_=(val); end
     
     # 
-    # @return []
+    # @return [Boolean]
     def spin_wrap_; end
     # 
-    # @param val [true,false]
+    # @param val [Boolean]
     # @return [void]
     def spin_wrap_=(val); end
     
@@ -1503,7 +1468,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param text [String]  Text to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one (they may be different). If {Wx::PG::PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT} is set, text is interpreted as a part of composite property string value (as generated by {Wx::PG::FloatProperty#value_to_string} called with this same flag).
-    # @return []
+    # @return [Boolean]
     def string_to_value(variant, text, argFlags=0) end
     
     # Reimplement this member function to add special handling for attributes of this property.
@@ -1512,7 +1477,7 @@ module Wx::PG
     # To actually set property attribute values from the application, use {Wx::PG::PGProperty#set_attribute} instead.
     # @param name [String] 
     # @param value [Wx::Variant] 
-    # @return []
+    # @return [Boolean]
     def do_set_attribute(name, value) end
     
     # Implement this function in derived class to check the value.
@@ -1521,24 +1486,31 @@ module Wx::PG
     # - Default implementation always returns true.
     # @param value [Wx::Variant] 
     # @param validationInfo [Wx::PG::PGValidationInfo] 
-    # @return []
+    # @return [Boolean]
     def validate_value(value, validationInfo) end
     
     # Returns pointer to the {Wx::Validator} that should be used with the editor of this property (NULL for no validator).
-    # Setting validator explicitly via SetPropertyValidator will override this.
-    # In most situations, code like this should work well (macros are used to maintain one actual validator instance, so on the second call the function exits within the first macro):
+    # Setting validator explicitly via #set_property_validator will override this.
+    # In most situations, code like this should work well:
     # 
-    # ```
-    #   wxValidator* wxMyPropertyClass::DoGetValidator () const
-    #   {
-    #       WX_PG_DOGETVALIDATOR_ENTRY()
-    #   
-    #       wxMyValidator* validator = new wxMyValidator(...);
-    #   
-    #       ... prepare validator...
-    #   
-    #       WX_PG_DOGETVALIDATOR_EXIT(validator)
-    #   }
+    # ```ruby
+    #   class MyPropertyClass < Wx::PG::FloatProperty
+    # 
+    #     class << self
+    #       def validator
+    #         @validator ||= MyValidator.new(...)
+    #       end
+    #     end
+    # 
+    #     # ...
+    # 
+    #     def do_get_validator
+    #       MyPropertyClass.validator
+    #     end
+    # 
+    #     # ...
+    # 
+    #   end
     # ```
     # 
     # You can get common filename validator by returning {Wx::PG::FileProperty.get_class_validator}. {Wx::PG::DirProperty}, for example, uses it.
@@ -1595,10 +1567,10 @@ module Wx::PG
     def max_val_=(val); end
     
     # 
-    # @return []
+    # @return [Boolean]
     def spin_motion_; end
     # 
-    # @param val [true,false]
+    # @param val [Boolean]
     # @return [void]
     def spin_motion_=(val); end
     
@@ -1611,10 +1583,10 @@ module Wx::PG
     def spin_step_=(val); end
     
     # 
-    # @return []
+    # @return [Boolean]
     def spin_wrap_; end
     # 
-    # @param val [true,false]
+    # @param val [Boolean]
     # @return [void]
     def spin_wrap_=(val); end
     
@@ -1660,7 +1632,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param text [String]  Text to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one (they may be different). If {Wx::PG::PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT} is set, text is interpreted as a part of composite property string value (as generated by {Wx::PG::UIntProperty#value_to_string} called with this same flag).
-    # @return []
+    # @return [Boolean]
     def string_to_value(variant, text, argFlags=0) end
     
     # Reimplement this member function to add special handling for attributes of this property.
@@ -1669,7 +1641,7 @@ module Wx::PG
     # To actually set property attribute values from the application, use {Wx::PG::PGProperty#set_attribute} instead.
     # @param name [String] 
     # @param value [Wx::Variant] 
-    # @return []
+    # @return [Boolean]
     def do_set_attribute(name, value) end
     
     # Implement this function in derived class to check the value.
@@ -1678,24 +1650,31 @@ module Wx::PG
     # - Default implementation always returns true.
     # @param value [Wx::Variant] 
     # @param validationInfo [Wx::PG::PGValidationInfo] 
-    # @return []
+    # @return [Boolean]
     def validate_value(value, validationInfo) end
     
     # Returns pointer to the {Wx::Validator} that should be used with the editor of this property (NULL for no validator).
-    # Setting validator explicitly via SetPropertyValidator will override this.
-    # In most situations, code like this should work well (macros are used to maintain one actual validator instance, so on the second call the function exits within the first macro):
+    # Setting validator explicitly via #set_property_validator will override this.
+    # In most situations, code like this should work well:
     # 
-    # ```
-    #   wxValidator* wxMyPropertyClass::DoGetValidator () const
-    #   {
-    #       WX_PG_DOGETVALIDATOR_ENTRY()
-    #   
-    #       wxMyValidator* validator = new wxMyValidator(...);
-    #   
-    #       ... prepare validator...
-    #   
-    #       WX_PG_DOGETVALIDATOR_EXIT(validator)
-    #   }
+    # ```ruby
+    #   class MyPropertyClass < Wx::PG::UIntProperty
+    # 
+    #     class << self
+    #       def validator
+    #         @validator ||= MyValidator.new(...)
+    #       end
+    #     end
+    # 
+    #     # ...
+    # 
+    #     def do_get_validator
+    #       MyPropertyClass.validator
+    #     end
+    # 
+    #     # ...
+    # 
+    #   end
     # ```
     # 
     # You can get common filename validator by returning {Wx::PG::FileProperty.get_class_validator}. {Wx::PG::DirProperty}, for example, uses it.
@@ -1712,7 +1691,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param number [Integer]  Integer to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one.
-    # @return []
+    # @return [Boolean]
     def int_to_value(variant, number, argFlags=0) end
     
     # Returns what would be the new value of the property after adding SpinCtrl editor step to the current value.
@@ -1786,10 +1765,10 @@ module Wx::PG
     def max_val_=(val); end
     
     # 
-    # @return []
+    # @return [Boolean]
     def spin_motion_; end
     # 
-    # @param val [true,false]
+    # @param val [Boolean]
     # @return [void]
     def spin_motion_=(val); end
     
@@ -1802,10 +1781,10 @@ module Wx::PG
     def spin_step_=(val); end
     
     # 
-    # @return []
+    # @return [Boolean]
     def spin_wrap_; end
     # 
-    # @param val [true,false]
+    # @param val [Boolean]
     # @return [void]
     def spin_wrap_=(val); end
     
@@ -1860,7 +1839,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param text [String]  Text to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one (they may be different). If {Wx::PG::PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT} is set, text is interpreted as a part of composite property string value (as generated by {Wx::PG::EnumProperty#value_to_string} called with this same flag).
-    # @return []
+    # @return [Boolean]
     def string_to_value(variant, text, argFlags=0) end
     
     # Implement this function in derived class to check the value.
@@ -1869,7 +1848,7 @@ module Wx::PG
     # - Default implementation always returns true.
     # @param value [Wx::Variant] 
     # @param validationInfo [Wx::PG::PGValidationInfo] 
-    # @return []
+    # @return [Boolean]
     def validate_value(value, validationInfo) end
     
     # Converts integer (possibly a choice selection) into {Wx::Variant} value appropriate for this property.
@@ -1882,7 +1861,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param number [Integer]  Integer to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one.
-    # @return []
+    # @return [Boolean]
     def int_to_value(variant, number, argFlags=0) end
     
     # @param value [Integer] 
@@ -1909,13 +1888,13 @@ module Wx::PG
     # @param value [Wx::Variant] 
     # @param text [String] 
     # @param argFlags [Integer] 
-    # @return []
+    # @return [Boolean]
     def value_from_string_(value, text, argFlags) end
     
     # @param value [Wx::Variant] 
     # @param intVal [Integer] 
     # @param argFlags [Integer] 
-    # @return []
+    # @return [Boolean]
     def value_from_int_(value, intVal, argFlags) end
     
     # 
@@ -1960,23 +1939,7 @@ module Wx::PG
     # @see Wx::PG::CursorProperty#value_to_string 
     # @param dc [Wx::DC]  {Wx::DC} to paint on.
     # @param rect [Wx::Rect]  Box reserved for custom graphics. Includes surrounding rectangle, if any. If x+width is < 0, then this is a measure item call (see above).
-    # @param paintdata [Wx::PG::PGPaintData]  {Wx::PG::PGPaintData} structure with much useful data about painted item. 
-    #   ```
-    #     struct wxPGPaintData
-    #     {
-    #         // wxPropertyGrid.
-    #         const wxPropertyGrid*   m_parent;
-    #     
-    #         // Normally -1, otherwise index to drop-down list item that has to be drawn.
-    #         int                     m_choiceItem;
-    #     
-    #         // Set to drawn width in OnCustomPaint (optional).
-    #         int                     m_drawnWidth;
-    #     
-    #         // In a measure item call, set this to the height of item at m_choiceItem index
-    #         int                     m_drawnHeight;
-    #     };
-    #   ```
+    # @param paintdata [Wx::PG::PGPaintData]  {Wx::PG::PGPaintData} structure with much useful data about painted item.
     # @return [void]
     def on_custom_paint(dc, rect, paintdata) end
     
@@ -2049,7 +2012,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param number [Integer]  Integer to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one.
-    # @return []
+    # @return [Boolean]
     def int_to_value(variant, number, argFlags=0) end
     
     # Override in derived class to customize how colours are printed as strings.
@@ -2080,7 +2043,7 @@ module Wx::PG
     # @param variant [Wx::Variant]  On function entry this is the old value (should not be {Wx::NullVariant} in normal cases). Translated value must be assigned back to it.
     # @param text [String]  Text to be translated into variant.
     # @param argFlags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable value instead of displayable one (they may be different). If {Wx::PG::PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT} is set, text is interpreted as a part of composite property string value (as generated by {Wx::PG::SystemColourProperty#value_to_string} called with this same flag).
-    # @return []
+    # @return [Boolean]
     def string_to_value(variant, text, argFlags=0) end
     
     # Events received by editor widgets are processed here.
@@ -2096,7 +2059,7 @@ module Wx::PG
     # @param propgrid [Wx::PG::PropertyGrid] 
     # @param wnd_primary [Wx::Window] 
     # @param event [Wx::Event] 
-    # @return []
+    # @return [Boolean]
     def on_event(propgrid, wnd_primary, event) end
     
     # Reimplement this member function to add special handling for attributes of this property.
@@ -2105,7 +2068,7 @@ module Wx::PG
     # To actually set property attribute values from the application, use {Wx::PG::PGProperty#set_attribute} instead.
     # @param name [String] 
     # @param value [Wx::Variant] 
-    # @return []
+    # @return [Boolean]
     def do_set_attribute(name, value) end
     
     # Returns size of the custom painted image in front of property.
@@ -2129,28 +2092,12 @@ module Wx::PG
     # @see Wx::PG::SystemColourProperty#value_to_string 
     # @param dc [Wx::DC]  {Wx::DC} to paint on.
     # @param rect [Wx::Rect]  Box reserved for custom graphics. Includes surrounding rectangle, if any. If x+width is < 0, then this is a measure item call (see above).
-    # @param paintdata [Wx::PG::PGPaintData]  {Wx::PG::PGPaintData} structure with much useful data about painted item. 
-    #   ```
-    #     struct wxPGPaintData
-    #     {
-    #         // wxPropertyGrid.
-    #         const wxPropertyGrid*   m_parent;
-    #     
-    #         // Normally -1, otherwise index to drop-down list item that has to be drawn.
-    #         int                     m_choiceItem;
-    #     
-    #         // Set to drawn width in OnCustomPaint (optional).
-    #         int                     m_drawnWidth;
-    #     
-    #         // In a measure item call, set this to the height of item at m_choiceItem index
-    #         int                     m_drawnHeight;
-    #     };
-    #   ```
+    # @param paintdata [Wx::PG::PGPaintData]  {Wx::PG::PGPaintData} structure with much useful data about painted item.
     # @return [void]
     def on_custom_paint(dc, rect, paintdata) end
     
     # @param variant [Wx::Variant] 
-    # @return []
+    # @return [Boolean]
     def query_colour_from_user(variant) end
     
     # Default is to use {Wx::SystemSettings.get_colour(index)}.