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

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

@@ -312,6 +312,7 @@ module Wx::PG
   # In sections below we cover few related topics.
   # 
   # - Supplied Ready-to-use Property Classes 
+  # 
   # - Creating Custom Properties
   # 
   # == Supplied Ready-to-use Property Classes
@@ -319,24 +320,43 @@ module Wx::PG
   # Here is a list and short description of supplied fully-functional property classes. They are located in either {Wx::props.h} or {Wx::advprops.h}.
   # 
   # - {Wx::PG::ArrayStringProperty} 
+  # 
   # - {Wx::PG::BoolProperty} 
+  # 
   # - {Wx::PG::ColourProperty} 
+  # 
   # - {Wx::PG::CursorProperty} 
+  # 
   # - {Wx::PG::DateProperty} 
+  # 
   # - {Wx::PG::DirProperty} 
+  # 
   # - {Wx::PG::EditEnumProperty} 
+  # 
   # - {Wx::PG::EnumProperty} 
+  # 
   # - {Wx::PG::FileProperty} 
+  # 
   # - {Wx::PG::FlagsProperty} 
+  # 
   # - {Wx::PG::FloatProperty} 
+  # 
   # - {Wx::PG::FontProperty} 
+  # 
   # - {Wx::PG::ImageFileProperty} 
+  # 
   # - {Wx::PG::IntProperty} 
+  # 
   # - {Wx::PG::LongStringProperty} 
+  # 
   # - {Wx::PG::MultiChoiceProperty} 
+  # 
   # - {Wx::PG::PropertyCategory} 
+  # 
   # - {Wx::PG::StringProperty} 
+  # 
   # - {Wx::PG::SystemColourProperty} 
+  # 
   # - {Wx::PG::UIntProperty}
   # 
   # == wxPropertyCategory
@@ -347,52 +367,28 @@ module Wx::PG
   # 
   # Simple string property.
   # Supported special attributes:
-  # - {Wx::PG::PG_STRING_PASSWORD}: Set to true in order to echo value as asterisks and to use {Wx::TE_PASSWORD} on the editor ({Wx::TextCtrl}).- {Wx::PG::PG_ATTR_AUTOCOMPLETE}: Set to true to enable auto-completion (use a {Wx::ArrayString} value), and is also supported by any property that happens to use a {Wx::TextCtrl}-based editor. 
+  # 
+  # - {Wx::PG::PG_STRING_PASSWORD}: Set to true in order to echo value as asterisks and to use {Wx::TE_PASSWORD} on the editor ({Wx::TextCtrl}).
+  # - {Wx::PG::PG_ATTR_AUTOCOMPLETE}: Set to true to enable auto-completion (use a {Wx::ArrayString} value), and is also supported by any property that happens to use a {Wx::TextCtrl}-based editor. 
   # {Wx::PG::StringProperty} has a special trait: if it has value of "<composed>", and also has child properties, then its displayed value becomes composition of child property values, similar as with {Wx::PG::FontProperty}, for instance.
   # 
   # == wxIntProperty
   # 
-  # It derives from {Wx::PG::NumericProperty} and displays value as a signed long integer. {Wx::PG::IntProperty} seamlessly supports 64-bit integers (i.e. {Wx::LongLong}) on overflow. To safely convert variant to integer, use code like this:
-  # 
-  # ```
-  #   wxLongLong ll;
-  #   ll << property->GetValue();
-  #   
-  #   // or
-  #   wxLongLong ll = propertyGrid->GetPropertyValueAsLong(property);
-  # ```
-  # 
-  # Getting 64-bit value: 
-  # ```
-  #   wxLongLong_t value = pg->GetPropertyValueAsLongLong();
-  #   
-  #   // or
-  #   
-  #   wxLongLong value;
-  #   wxVariant variant = property->GetValue();
-  #   if ( variant.IsType(wxPG_VARIANT_TYPE_LONGLONG) )
-  #       value = variant.GetLongLong();
-  #   else
-  #       value = variant.GetLong();
-  # ```
-  # 
-  # Setting 64-bit value: 
-  # ```
-  #   pg->SetPropertyValue(longLongVal);
-  #   
-  #   // or
-  #   
-  #   property->SetValue(WXVARIANT(longLongVal));
-  # ```
-  # 
+  # It derives from {Wx::PG::NumericProperty} and displays value as a signed long integer.
   # Supported special attributes:
-  # - {Wx::PG::PG_ATTR_MIN}, {Wx::PG::PG_ATTR_MAX} to specify acceptable value range.- {Wx::PG::PG_ATTR_SPINCTRL_STEP}, {Wx::PG::PG_ATTR_SPINCTRL_WRAP}, {Wx::PG::PG_ATTR_SPINCTRL_MOTION}: Sets SpinCtrl editor parameters. 
+  #  
+  # - {Wx::PG::PG_ATTR_MIN}, {Wx::PG::PG_ATTR_MAX} to specify acceptable value range.
+  # - {Wx::PG::PG_ATTR_SPINCTRL_STEP}, {Wx::PG::PG_ATTR_SPINCTRL_WRAP}, {Wx::PG::PG_ATTR_SPINCTRL_MOTION}: Sets SpinCtrl editor parameters. 
   # 
   # == wxUIntProperty
   # 
   # Like {Wx::PG::IntProperty}, but displays value as unsigned int. To set the prefix used globally, manipulate {Wx::PG::PG_UINT_PREFIX} string attribute. To set the globally used base, manipulate {Wx::PG::PG_UINT_BASE} int attribute. Regardless of current prefix, understands (hex) values starting with both "0x" and "$" (apart from edit mode). Like {Wx::PG::IntProperty}, {Wx::PG::UIntProperty} seamlessly supports 64-bit unsigned integers (i.e. {Wx::ULongLong}). Same {Wx::Variant} safety rules apply.
   # Supported special attributes:
-  # - {Wx::PG::PG_ATTR_MIN}, {Wx::PG::PG_ATTR_MAX}: Specifies acceptable value range.- {Wx::PG::PG_UINT_BASE}: Defines base. Valid constants are {Wx::PG::PG_BASE_OCT}, {Wx::PG::PG_BASE_DEC}, {Wx::PG::PG_BASE_HEX} and {Wx::PG::PG_BASE_HEXL} (lowercase characters). Arbitrary bases are <b>not</b> supported.- {Wx::PG::PG_UINT_PREFIX}: Defines displayed prefix. Possible values are {Wx::PG::PG_PREFIX_NONE}, {Wx::PG::PG_PREFIX_0x} and {Wx::PG::PG_PREFIX_DOLLAR_SIGN}. Only {Wx::PG::PG_PREFIX_NONE} works with decimal and octal numbers.- {Wx::PG::PG_ATTR_SPINCTRL_STEP}, {Wx::PG::PG_ATTR_SPINCTRL_WRAP}, {Wx::PG::PG_ATTR_SPINCTRL_MOTION}: Sets SpinCtrl editor parameters. 
+  # 
+  # - {Wx::PG::PG_ATTR_MIN}, {Wx::PG::PG_ATTR_MAX}: Specifies acceptable value range.
+  # - {Wx::PG::PG_UINT_BASE}: Defines base. Valid constants are {Wx::PG::PG_BASE_OCT}, {Wx::PG::PG_BASE_DEC}, {Wx::PG::PG_BASE_HEX} and {Wx::PG::PG_BASE_HEXL} (lowercase characters). Arbitrary bases are <b>not</b> supported.
+  # - {Wx::PG::PG_UINT_PREFIX}: Defines displayed prefix. Possible values are {Wx::PG::PG_PREFIX_NONE}, {Wx::PG::PG_PREFIX_0x} and {Wx::PG::PG_PREFIX_DOLLAR_SIGN}. Only {Wx::PG::PG_PREFIX_NONE} works with decimal and octal numbers.
+  # - {Wx::PG::PG_ATTR_SPINCTRL_STEP}, {Wx::PG::PG_ATTR_SPINCTRL_WRAP}, {Wx::PG::PG_ATTR_SPINCTRL_MOTION}: Sets SpinCtrl editor parameters. 
   # For example how to use seamless 64-bit integer support, see {Wx::PG::IntProperty} documentation (just use {Wx::ULongLong} instead of {Wx::LongLong}).
   # 
   # == wxFloatProperty
@@ -400,13 +396,18 @@ module Wx::PG
   # Like {Wx::PG::StringProperty}, but converts text to a double-precision floating point. Default float-to-text precision is 6 decimals, but this can be changed by modifying {Wx::PG::PG_FLOAT_PRECISION} attribute.
   # Note that when displaying the value, sign is omitted if the resulting textual representation is effectively zero (for example, -0.0001 with precision of 3 will become 0.0 instead of -0.0). This behaviour is unlike what C standard library does, but should result in better end-user experience in almost all cases.
   # Supported special attributes:
-  # - {Wx::PG::PG_ATTR_MIN}, {Wx::PG::PG_ATTR_MAX}: Specifies acceptable value range.- {Wx::PG::PG_FLOAT_PRECISION}: Sets the (max) precision used when floating point value is rendered as text. The default -1 means shortest floating-point 6-digit representation.- {Wx::PG::PG_ATTR_SPINCTRL_STEP}, {Wx::PG::PG_ATTR_SPINCTRL_WRAP}, {Wx::PG::PG_ATTR_SPINCTRL_MOTION}: Sets SpinCtrl editor parameters. 
+  # 
+  # - {Wx::PG::PG_ATTR_MIN}, {Wx::PG::PG_ATTR_MAX}: Specifies acceptable value range.
+  # - {Wx::PG::PG_FLOAT_PRECISION}: Sets the (max) precision used when floating point value is rendered as text. The default -1 means shortest floating-point 6-digit representation.
+  # - {Wx::PG::PG_ATTR_SPINCTRL_STEP}, {Wx::PG::PG_ATTR_SPINCTRL_WRAP}, {Wx::PG::PG_ATTR_SPINCTRL_MOTION}: Sets SpinCtrl editor parameters. 
   # 
   # == wxBoolProperty
   # 
   # Represents a boolean value. {Wx::Choice} is used as editor control, by the default. {Wx::PG::PG_BOOL_USE_CHECKBOX} attribute can be set to true in order to use check box instead.
   # Supported special attributes:
-  # - {Wx::PG::PG_BOOL_USE_CHECKBOX}: If set to true uses check box editor instead of combo box.- {Wx::PG::PG_BOOL_USE_DOUBLE_CLICK_CYCLING}: If set to true cycles combo box instead showing the list. 
+  # 
+  # - {Wx::PG::PG_BOOL_USE_CHECKBOX}: If set to true uses check box editor instead of combo box.
+  # - {Wx::PG::PG_BOOL_USE_DOUBLE_CLICK_CYCLING}: If set to true cycles combo box instead showing the list. 
   # 
   # == wxLongStringProperty
   # 
@@ -543,129 +544,89 @@ module Wx::PG
   # - ::{Wx::PG::PG_DIALOG_TITLE}: Sets a specific title for the file dialog.
   # - ::{Wx::PG::PG_FILE_DIALOG_STYLE}: Sets a specific {Wx::FileDialog} style for the file dialog.
   # - ::{Wx::PG::PG_FILE_WILDCARD}: Sets wildcard (see {Wx::FileDialog} for format details), "All files..." is default.
-  # - {Wx::PG::PG_FILE_SHOW_FULL_PATH}: Default true. When false, only the file name is shown (i.e. drive and directory are hidden).- {Wx::PG::PG_FILE_SHOW_RELATIVE_PATH}: If set, then the filename is shown relative to the given path string.- {Wx::PG::PG_FILE_INITIAL_PATH}: Sets the initial path of where to look for files. 
+  # 
+  # - {Wx::PG::PG_FILE_SHOW_FULL_PATH}: Default true. When false, only the file name is shown (i.e. drive and directory are hidden).
+  # - {Wx::PG::PG_FILE_SHOW_RELATIVE_PATH}: If set, then the filename is shown relative to the given path string.
+  # - {Wx::PG::PG_FILE_INITIAL_PATH}: Sets the initial path of where to look for files. 
   # 
   # == wxColourProperty
   # 
   # <b>Useful alternate editor:</b> Choice.
   # Represents {Wx::Colour}. {Wx::Button} is used to trigger a colour picker dialog. There are various sub-classing opportunities with this class. See below in {Wx::PG::SystemColourProperty} section for details.
   # Supported special attributes:
+  # 
   # - {Wx::PG::PG_COLOUR_HAS_ALPHA}: If set to true allows user to edit the alpha colour component. 
   # 
   # == wxFontProperty
   # 
   # Represents {Wx::Font}. Various sub-properties are used to edit individual subvalues.
   # Supported special attributes:
+  # 
   # - {Wx::PG::PG_DIALOG_TITLE}: Sets a specific title for the font dialog.
   # 
   # == wxSystemColourProperty
   # 
   # Represents {Wx::Colour} and a system colour index. {Wx::Choice} is used to edit the value. Drop-down list has color images. Note that value type is {Wx::PG::ColourPropertyValue} instead of {Wx::Colour} (which {Wx::PG::ColourProperty} uses).
   # 
-  # ```
-  #   class wxColourPropertyValue : public wxObject
-  #   {
-  #   public:
-  #       //  An integer value relating to the colour, and which exact
-  #       //  meaning depends on the property with which it is used.
-  #       //
-  #       //  For wxSystemColourProperty:
-  #       //  Any of wxSYS_COLOUR_XXX, or any web-colour ( use wxPG_TO_WEB_COLOUR
-  #       //  macro - (currently unsupported) ), or wxPG_COLOUR_CUSTOM.
-  #       wxUint32    m_type;
-  #   
-  #       // Resulting colour. Should be correct regardless of type.
-  #       wxColour    m_colour;
-  #   };
-  # ```
-  # 
   # In {Wx::PG::SystemColourProperty}, and its derived class {Wx::PG::ColourProperty}, there are various sub-classing features. To set a basic list of colour names, call {Wx::PG::PGProperty#set_choices}.
   # 
-  # ```
-  #   // Override in derived class to customize how colours are translated
-  #   // to strings.
-  #   virtual wxString ColourToString( const wxColour& col, int index ) const;
-  #   
-  #   // Returns index of entry that triggers colour picker dialog
-  #   // (default is last).
-  #   virtual int GetCustomColourIndex() const;
-  #   
-  #   // Helper function to show the colour dialog
-  #   bool QueryColourFromUser( wxVariant& variant ) const;
-  #   
-  #   // Returns colour for given choice.
-  #   // Default function returns wxSystemSettings::GetColour(index).
-  #   virtual wxColour GetColour( int index ) const;
+  # ```ruby
+  #   # Override in derived class to customize how colours are translated
+  #   # to strings.
+  #   def colour_to_string(col, index) end
+  # 
+  #   # Returns index of entry that triggers colour picker dialog
+  #   # (default is last).
+  #   def get_custom_colour_index; end
+  # 
+  #   # Helper function to show the colour dialog
+  #   def query_colour_from_user(variant) end
+  # 
+  #   # Returns colour for given choice.
+  #   # Default function returns Wx::SystemSettings.get_colour(index).
+  #   def get_colour(index) end
   # ```
   # 
   # == wxCursorProperty
   # 
-  # Represents a {Wx::Cursor}. {Wx::Choice} is used to edit the value. Drop-down list has cursor images under some ({Wx::MSW}) platforms.
+  # Represents a {Wx::Cursor}. {Wx::Choice} is used to edit the value. Drop-down list has cursor images under some (wxMSW) platforms.
   # 
   # == Creating Custom Properties
   # 
   # New properties can be created by subclassing {Wx::PG::PGProperty} or one of the provided property classes, and (re)implementing necessary member functions. Below, each virtual member function has ample documentation about its purpose and any odd details which to keep in mind.
   # Here is a very simple 'template' code:
   # 
-  # ```
-  #   class MyProperty : public wxPGProperty
-  #   {
-  #   public:
-  #       // Default constructor
-  #       MyProperty() { }
-  #   
-  #       // All arguments of this ctor must have a default value -
-  #       // use wxPG_LABEL for label and name
-  #       MyProperty( const wxString& label = wxPG_LABEL,
-  #                   const wxString& name = wxPG_LABEL,
-  #                   const wxString& value = wxEmptyString )
-  #           : wxPGProperty(label, name)
-  #       {
-  #           // m_value is wxVariant
-  #           m_value = value;
-  #       }
+  # ``` ruby
+  #   class MyProperty < Wx::PG::PGProperty
   #   
-  #       virtual ~MyProperty() { }
+  #       # All arguments of this ctor must have a default value -
+  #       # use Wx::PG::PG_LABEL for label and name
+  #       def initialize(label = Wx::PG::PG_LABEL, name = Wx::PG::PG_LABEL, value = '')
+  #         super(label, name)
+  #         # self.value is Wx::Variant
+  #         self.value = value
+  #       end
   #   
-  #       const wxPGEditor* DoGetEditorClass() const
-  #       {
-  #           // Determines editor used by property.
-  #           // You can replace 'TextCtrl' below with any of these
-  #           // builtin-in property editor identifiers: Choice, ComboBox,
-  #           // TextCtrlAndButton, ChoiceAndButton, CheckBox, SpinCtrl,
-  #           // DatePickerCtrl.
-  #           return wxPGEditor_TextCtrl;
-  #       }
+  #       def do_get_editor_class
+  #         # Determines editor used by property.
+  #         # You can replace 'TEXT_CTRL' below with any of these
+  #         # builtin-in property editor identifiers: CHOICE, COMBO_BOX,
+  #         # TEXT_CTRL_AND_BUTTON, CHOICE_AND_BUTTON, CHECK_BOX, SPIN_CTRL,
+  #         # DATE_PICKER_CTRL.
+  #         return Wx::PG::PG_EDITOR_TEXT_CTRL
+  #       end
   #   
-  #       virtual wxString ValueToString( wxVariant& value,
-  #                                       int argFlags ) const
-  #       {
-  #           // TODO: Convert given property value to a string
-  #       }
+  #       def value_to_string(value, argFlags)
+  #         # TODO: Convert given property value to a string
+  #       end
   #   
-  #       virtual bool StringToValue( wxVariant& variant, const wxString& text, int argFlags )
-  #       {
-  #           // TODO: Adapt string to property value.
-  #       }
+  #       def string_to_value(variant, text, argFlags)
+  #         # TODO: Adapt string to property value.
+  #       end
   #   
-  #   protected:
-  #   };
-  # ```
-  # 
-  # Since {Wx::PG::PGProperty} derives from {Wx::Object}, you can use standard {Wx::DECLARE_DYNAMIC_CLASS} and {Wx::IMPLEMENT_DYNAMIC_CLASS} macros. From the above example they were omitted for sake of simplicity, and besides, they are only really needed if you need to use {Wx::RTTI} with your property class.
-  # You can change the 'value type' of a property by simply assigning different type of variant with SetValue. <b>It is mandatory to implement {Wx::VariantData} class for all data types used as property values.</b> You can use macros declared in {Wx::PG::PropertyGrid} headers. For instance:
-  # 
-  # ```
-  #   // In header file:
-  #   // (If you need to have export declaration, use version of macros
-  #   // with _EXPORTED postfix)
-  #   WX_PG_DECLARE_VARIANT_DATA(MyDataClass)
-  #   
-  #   // In sources file:
-  #   WX_PG_IMPLEMENT_VARIANT_DATA(MyDataClass)
-  #   
-  #   // Or, if you don't have valid == operator:
-  #   WX_PG_IMPLEMENT_VARIANT_DATA_DUMMY_EQ(MyDataClass)
+  #   protected
+  #       # ...
+  #   end
   # ```
   # 
   # === 
@@ -689,7 +650,9 @@ module Wx::PG
   class PGProperty < Object
   
     # This virtual function is called after m_value has been set.
-    # - If m_value was set to Null variant (i.e. unspecified value), {Wx::PG::PGProperty#on_set_value} will not be called.- m_value may be of any variant type. Typically properties internally support only one variant type, and as such {Wx::PG::PGProperty#on_set_value} provides a good opportunity to convert supported values into internal type.- Default implementation does nothing.
+    # - If m_value was set to Null variant (i.e. unspecified value), {Wx::PG::PGProperty#on_set_value} will not be called.
+    # - m_value may be of any variant type. Typically properties internally support only one variant type, and as such {Wx::PG::PGProperty#on_set_value} provides a good opportunity to convert supported values into internal type.
+    # - Default implementation does nothing.
     # @return [void]
     def on_set_value; end
     
@@ -702,8 +665,8 @@ module Wx::PG
     # 
     # - Default implementation always returns true.
     # @param value [Wx::Variant] 
-    # @param validationInfo [Wx::PGValidationInfo] 
-    # @return [true,false]
+    # @param validationInfo [Wx::PG::PGValidationInfo] 
+    # @return [Boolean]
     def validate_value(value, validationInfo) end
     
     # Converts text into {Wx::Variant} value appropriate for this property.
@@ -715,17 +678,20 @@ 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::PGProperty#value_to_string} called with this same flag).
-    # @return [true,false]
+    # @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.
     # Returns true if resulting {Wx::Variant} value was different.
     # 
-    # - If property is not supposed to use choice or spinctrl or other editor with int-based value, it is not necessary to implement this method.- Default implementation simply assign given int to m_value.- If property uses choice control, and displays a dialog on some choice items, then it is preferred to display that dialog in IntToValue instead of OnEvent.- You might want to take into account that m_value is Mull variant if property value is unspecified (which is usually only case if you explicitly enabled that sort behaviour).
+    # - If property is not supposed to use choice or spinctrl or other editor with int-based value, it is not necessary to implement this method.
+    # - Default implementation simply assign given int to m_value.
+    # - If property uses choice control, and displays a dialog on some choice items, then it is preferred to display that dialog in IntToValue instead of OnEvent.
+    # - You might want to take into account that m_value is Mull variant if property value is unspecified (which is usually only case if you explicitly enabled that sort behaviour).
     # @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 [true,false]
+    # @return [Boolean]
     def int_to_value(variant, number, argFlags=0) end
     
     # Converts property value into a text representation.
@@ -741,7 +707,7 @@ module Wx::PG
     # true if value was changed.
     # @param text [String]  String to get the value from.
     # @param flags [Integer]  If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, the function sets complete, storable value instead of displayable one (they may be different). {Wx::PG::PG_MISC_ARG_FLAGS::PG_PROGRAMMATIC_VALUE} flag is used to indicate that value is being set programmatically (i.e. operation is not caused by user input). If {Wx::PG::PG_MISC_ARG_FLAGS::PG_REPORT_ERROR} is set, a special action should be performed if string couldn't have been successfully converted to the valid value (e.g. a special value can be set in this case).
-    # @return [true,false]
+    # @return [Boolean]
     def set_value_from_string(text, flags=Wx::PG::PG_MISC_ARG_FLAGS::PG_PROGRAMMATIC_VALUE) end
     alias_method :value_from_string=, :set_value_from_string
     
@@ -751,14 +717,16 @@ module Wx::PG
     # true if value was changed.
     # @param value [Integer]  Int to get the value from.
     # @param flags [Integer]  If has {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE}, then the value given is an actual value and not an index.
-    # @return [true,false]
+    # @return [Boolean]
     def set_value_from_int(value, flags=0) end
     alias_method :value_from_int=, :set_value_from_int
     
     # Returns size of the custom painted image in front of property.
     # This method must be overridden to return non-default value if OnCustomPaint is to be called.
     # 
-    # - Default behaviour is to return {size(0,0)}, which means no image.- Default image width or height is indicated with dimension -1.- You can also return {Wx::PG::PG_DEFAULT_IMAGE_SIZE} which equals {Wx::DEFAULT_SIZE}.
+    # - Default behaviour is to return {size(0,0)}, which means no image.
+    # - Default image width or height is indicated with dimension -1.
+    # - You can also return {Wx::PG::PG_DEFAULT_IMAGE_SIZE} which equals {Wx::DEFAULT_SIZE}.
     # @param item [Integer]  Normally -1, but can be an index to the property's list of items.
     # @return [Wx::Size]
     def on_measure_image(item=-1) end
@@ -773,10 +741,10 @@ module Wx::PG
     # return true if any changes in value should be reported.
     # 
     # - If property uses choice control, and displays a dialog on some choice items, then it is preferred to display that dialog in IntToValue instead of OnEvent.
-    # @param propgrid [Wx::PropertyGrid] 
+    # @param propgrid [Wx::PG::PropertyGrid] 
     # @param wnd_primary [Wx::Window] 
     # @param event [Wx::Event] 
-    # @return [true,false]
+    # @return [Boolean]
     def on_event(propgrid, wnd_primary, event) end
     
     # Called after value of a child property has been altered.
@@ -784,31 +752,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::PGProperty#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.
@@ -819,24 +780,31 @@ module Wx::PG
     def child_changed(thisValue, childIndex, childValue) end
     
     # Returns pointer to an instance of used editor.
-    # @return [Wx::PGEditor]
+    # @return [Wx::PG::PGEditor]
     def do_get_editor_class; 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.
@@ -847,27 +815,14 @@ module Wx::PG
     # If property's {Wx::PG::PGProperty#on_measure_image} returns size that has height != 0 but less than row height ( < 0 has special meanings), {Wx::PG::PropertyGrid} calls this method to draw a custom image in a limited area in front of the editor control or value text/graphics, and if control has drop-down list, then the image is drawn there as well (even in the case {Wx::PG::PGProperty#on_measure_image} returned higher height than row height).
     # NOTE: Following applies when {Wx::PG::PGProperty#on_measure_image} returns a "flexible" height ( using <code>wxPG_FLEXIBLE_SIZE(W,H)</code> macro), which implies variable height items: If (rect.x+rect.width) is < 0, then this is a measure item call, which means that dc is invalid and only thing that should be done is to set paintdata.m_drawnHeight to the height of the image of item at index paintdata.m_choiceItem. This call may be done even as often as once every drop-down popup show.
     # 
-    # - You can actually exceed rect width, but if you do so then paintdata.m_drawnWidth must be set to the full width drawn in pixels.- Due to technical reasons, rect's height will be default even if custom height was reported during measure call.- Brush is guaranteed to be default background colour. It has been already used to clear the background of area being painted. It can be modified.- Pen is guaranteed to be 1-wide 'black' (or whatever is the proper colour) pen for drawing framing rectangle. It can be changed as well.
+    # - You can actually exceed rect width, but if you do so then paintdata.m_drawnWidth must be set to the full width drawn in pixels.
+    # - Due to technical reasons, rect's height will be default even if custom height was reported during measure call.
+    # - Brush is guaranteed to be default background colour. It has been already used to clear the background of area being painted. It can be modified.
+    # - Pen is guaranteed to be 1-wide 'black' (or whatever is the proper colour) pen for drawing framing rectangle. It can be changed as well.
     # @see Wx::PG::PGProperty#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::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
     
@@ -889,7 +844,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 [true,false]
+    # @return [Boolean]
     def do_set_attribute(name, value) end
     
     # Returns value of an attribute.
@@ -901,7 +856,7 @@ module Wx::PG
     
     # Returns instance of a new {Wx::PG::PGEditorDialogAdapter} instance, which is used when user presses the (optional) button next to the editor control;.
     # Default implementation returns NULL (i.e. no action is generated when button is pressed).
-    # @return [Wx::PGEditorDialogAdapter]
+    # @return [Wx::PG::PGEditorDialogAdapter]
     def get_editor_dialog; end
     alias_method :editor_dialog, :get_editor_dialog
     
@@ -920,7 +875,7 @@ module Wx::PG
     
     # Adds a private child property.
     # If you use this instead of {Wx::PG::PropertyGridInterface#insert} or {Wx::PG::PropertyGridInterface#append_in}, then property's parental type will automatically be set up to {Wx::PG::PGPropertyFlags::PG_PROP_AGGREGATE}. In other words, all properties of this property will become private.
-    # @param prop [Wx::PGProperty] 
+    # @param prop [Wx::PG::PGProperty] 
     # @return [void]
     def add_private_child(prop) end
     
@@ -937,30 +892,30 @@ module Wx::PG
     # {Wx::PG::PropertyGrid} is not automatically refreshed by this function.
     # @see Wx::PG::PGProperty#insert_child
     # @see  Wx::PG::PGProperty#add_private_child 
-    # @param childProperty [Wx::PGProperty] 
+    # @param childProperty [Wx::PG::PGProperty] 
     # @return [Wx::PG::PGProperty]
     def append_child(childProperty) end
     
     # Determines, recursively, if all children are not unspecified.
     # @param pendingList [Wx::Variant]  Assumes members in this {Wx::Variant} list as pending replacement values.
-    # @return [true,false]
+    # @return [Boolean]
     def are_all_children_specified(pendingList=nil) end
     
     # Returns true if children of this property are component values (for instance, points size, face name, and is_underlined are component values of a font).
-    # @return [true,false]
+    # @return [Boolean]
     def are_children_components; end
     
     # Sets or clears given property flag.
     # Mainly for internal use.
     # Setting a property flag never has any side-effect, and is intended almost exclusively for internal use. So, for example, if you want to disable a property, call 
-    # ```
-    #   Enable(false) 
+    # ```ruby
+    #   enable(false)
     # ```
     #  instead of setting {Wx::PG::PGPropertyFlags::PG_PROP_DISABLED} flag.
     # @see Wx::PG::PGProperty#has_flag
     # @see  GetFlags() 
-    # @param flag [PGPropertyFlags] 
-    # @param set [true,false] 
+    # @param flag [Wx::PGPropertyFlags] 
+    # @param set [Boolean] 
     # @return [void]
     def change_flag(flag, set) end
     
@@ -977,13 +932,13 @@ module Wx::PG
     # Enables or disables the property.
     # Disabled property usually appears as having grey text.
     # @see Wx::PG::PropertyGridInterface#enable_property 
-    # @param enable [true,false]  If false, property is disabled instead.
+    # @param enable [Boolean]  If false, property is disabled instead.
     # @return [void]
     def enable(enable=true) end
     
     # Call to enable or disable usage of common value (integer value that can be selected for properties instead of their normal values) for this property.
     # Common values are disabled by the default for all properties.
-    # @param enable [true,false] 
+    # @param enable [Boolean] 
     # @return [void]
     def enable_common_value(enable=true) end
     
@@ -1029,6 +984,12 @@ module Wx::PG
     def get_attribute_as_double(name, defVal) end
     alias_method :attribute_as_double, :get_attribute_as_double
     
+    # Returns map-like storage of property's attributes.
+    # If extra style {Wx::PG::PG_EX_WINDOW_STYLES::PG_EX_WRITEONLY_BUILTIN_ATTRIBUTES} is set, then builtin-attributes are not included in the storage.
+    # @return [Wx::PGAttributeStorage]
+    def get_attributes; end
+    alias_method :attributes, :get_attributes
+    
     # Returns attributes as list {Wx::Variant}.
     # If extra style {Wx::PG::PG_EX_WINDOW_STYLES::PG_EX_WRITEONLY_BUILTIN_ATTRIBUTES} is set, then builtin-attributes are not included in the list.
     # @return [Wx::Variant]
@@ -1038,7 +999,7 @@ module Wx::PG
     # Returns editor used for given column.
     # NULL for no editor.
     # @param column [Integer] 
-    # @return [Wx::PGEditor]
+    # @return [Wx::PG::PGEditor]
     def get_column_editor(column) end
     alias_method :column_editor, :get_column_editor
     
@@ -1051,7 +1012,7 @@ module Wx::PG
     # Returns {Wx::PG::PGCell} of given column.
     # const version of this member function returns 'default' {Wx::PG::PGCell} object if the property itself didn't hold cell data.
     # @param column [Integer] 
-    # @return [Wx::PGCell]
+    # @return [Wx::PG::PGCell]
     def get_cell_or_default(column) end
     alias_method :cell_or_default, :get_cell_or_default
     
@@ -1074,7 +1035,7 @@ module Wx::PG
     alias_method :children_height, :get_children_height
     
     # Returns read-only reference to property's list of choices.
-    # @return [Wx::PGChoices]
+    # @return [Wx::PG::PGChoices]
     def get_choices; end
     alias_method :choices, :get_choices
     
@@ -1111,7 +1072,7 @@ module Wx::PG
     
     # Returns {Wx::PG::PGEditor} that will be used and created when property becomes selected.
     # Returns more accurate value than {Wx::PG::PGProperty#do_get_editor_class}.
-    # @return [Wx::PGEditor]
+    # @return [Wx::PG::PGEditor]
     def get_editor_class; end
     alias_method :editor_class, :get_editor_class
     
@@ -1121,12 +1082,12 @@ module Wx::PG
     alias_method :hint_text, :get_hint_text
     
     # Returns property grid where property lies.
-    # @return [Wx::PropertyGrid]
+    # @return [Wx::PG::PropertyGrid]
     def get_grid; end
     alias_method :grid, :get_grid
     
     # Returns owner {Wx::PG::PropertyGrid}, but only if one is currently on a page displaying this property.
-    # @return [Wx::PropertyGrid]
+    # @return [Wx::PG::PropertyGrid]
     def get_grid_if_displayed; end
     alias_method :grid_if_displayed, :get_grid_if_displayed
     
@@ -1139,7 +1100,7 @@ module Wx::PG
     
     # Gets flags as a'|' delimited string.
     # Note that flag names are not prepended with '{Wx::PG_PROP_}'.
-    # @param flagsMask [FlagType]  String will only be made to include flags combined by this parameter.
+    # @param flagsMask [Integer]  String will only be made to include flags combined by this parameter.
     # @return [String]
     def get_flags_as_string(flagsMask) end
     alias_method :flags_as_string, :get_flags_as_string
@@ -1150,7 +1111,7 @@ module Wx::PG
     alias_method :index_in_parent, :get_index_in_parent
     
     # Returns last visible child property, recursively.
-    # @return [Wx::PGProperty]
+    # @return [Wx::PG::PGProperty]
     def get_last_visible_sub_item; end
     alias_method :last_visible_sub_item, :get_last_visible_sub_item
     
@@ -1233,35 +1194,35 @@ module Wx::PG
     #   Returns true if property has given flag set.
     #   
     #   @see propgrid_propflags 
-    #   @param flag [PGPropertyFlags] 
-    #   @return [true,false]
+    #   @param flag [Wx::PGPropertyFlags] 
+    #   @return [Boolean]
     # @overload has_flag(flag)
     #   Returns true if property has given flag set.
-    #   @param flag [FlagType] 
-    #   @return [true,false]
+    #   @param flag [Integer] 
+    #   @return [Boolean]
     def has_flag(*args) end
     alias_method :has_flag?, :has_flag
     
     # Returns true if property has all given flags set.
-    # @param flags [FlagType] 
-    # @return [true,false]
+    # @param flags [Integer] 
+    # @return [Boolean]
     def has_flags_exact(flags) end
     alias_method :has_flags_exact?, :has_flags_exact
     
     # Returns true if property has even one visible child.
-    # @return [true,false]
+    # @return [Boolean]
     def has_visible_children; end
     alias_method :has_visible_children?, :has_visible_children
     
     # Hides or reveals the property.
-    # @param hide [true,false]  true for hide, false for reveal.
+    # @param hide [Boolean]  true for hide, false for reveal.
     # @param flags [Integer]  By default changes are applied recursively. Set this parameter to {Wx::PG::PG_GETPROPERTYVALUES_FLAGS::PG_DONT_RECURSE} to prevent this.
-    # @return [true,false]
+    # @return [Boolean]
     def hide(hide, flags=Wx::PG::PG_GETPROPERTYVALUES_FLAGS::PG_RECURSE) end
     
     # Returns index of given child property.
     # {Wx::NOT_FOUND} if given property is not child of this.
-    # @param p [Wx::PGProperty] 
+    # @param p [Wx::PG::PGProperty] 
     # @return [Integer]
     def index(p) end
     
@@ -1273,7 +1234,7 @@ module Wx::PG
     # @see Wx::PG::PGProperty#append_child
     # @see  Wx::PG::PGProperty#add_private_child 
     # @param index [Integer] 
-    # @param childProperty [Wx::PGProperty] 
+    # @param childProperty [Wx::PG::PGProperty] 
     # @return [Wx::PG::PGProperty]
     def insert_child(index, childProperty) end
     
@@ -1285,51 +1246,51 @@ module Wx::PG
     def insert_choice(label, index, value=Wx::PG::PG_INVALID_VALUE) end
     
     # Returns true if this property is actually a {Wx::PG::PropertyCategory}.
-    # @return [true,false]
+    # @return [Boolean]
     def is_category; end
     alias_method :category?, :is_category
     
     # Returns true if property is enabled.
-    # @return [true,false]
+    # @return [Boolean]
     def is_enabled; end
     alias_method :enabled?, :is_enabled
     
     # Returns true if property has visible children.
-    # @return [true,false]
+    # @return [Boolean]
     def is_expanded; end
     alias_method :expanded?, :is_expanded
     
     # Returns true if this property is actually a {Wx::RootProperty}.
-    # @return [true,false]
+    # @return [Boolean]
     def is_root; end
     alias_method :root?, :is_root
     
     # Returns true if this is a sub-property.
-    # @return [true,false]
+    # @return [Boolean]
     def is_sub_property; end
     alias_method :sub_property?, :is_sub_property
     
     # Returns true if candidateParent is some parent of this property.
     # Use, for example, to detect if item is inside collapsed section.
-    # @param candidateParent [Wx::PGProperty] 
-    # @return [true,false]
+    # @param candidateParent [Wx::PG::PGProperty] 
+    # @return [Boolean]
     def is_some_parent(candidateParent) end
     alias_method :some_parent?, :is_some_parent
     
     # Returns true if property has editable {Wx::TextCtrl} when selected.
     # Although disabled properties do not displayed editor, they still return true here as being disabled is considered a temporary condition (unlike being read-only or having limited editing enabled).
-    # @return [true,false]
+    # @return [Boolean]
     def is_text_editable; end
     alias_method :text_editable?, :is_text_editable
     
     # Returns true if property's value is considered unspecified.
     # This usually means that value is Null variant.
-    # @return [true,false]
+    # @return [Boolean]
     def is_value_unspecified; end
     alias_method :value_unspecified?, :is_value_unspecified
     
     # Returns true if all parents expanded.
-    # @return [true,false]
+    # @return [Boolean]
     def is_visible; end
     alias_method :visible?, :is_visible
     
@@ -1344,7 +1305,7 @@ module Wx::PG
     
     # If property's editor is created this forces its recreation.
     # Useful in SetAttribute etc. Returns true if actually did anything.
-    # @return [true,false]
+    # @return [Boolean]
     def recreate_editor; end
     
     # If property's editor is active, then update it's value.
@@ -1365,7 +1326,7 @@ module Wx::PG
     
     # Set if user can change the property's value to unspecified by modifying the value of the editor control (usually by clearing it).
     # Currently, this can work with following properties: {Wx::PG::IntProperty}, {Wx::PG::UIntProperty}, {Wx::PG::FloatProperty}, {Wx::PG::EditEnumProperty}.
-    # @param enable [true,false]  Whether to enable or disable this behaviour (it is disabled by default).
+    # @param enable [Boolean]  Whether to enable or disable this behaviour (it is disabled by default).
     # @return [void]
     def set_auto_unspecified(enable=true) end
     alias_method :auto_unspecified=, :set_auto_unspecified
@@ -1381,7 +1342,7 @@ module Wx::PG
     # @overload set_editor(editor)
     #   Sets editor for a property.
     #   For custom editors, use pointer you received from {Wx::PG::PropertyGrid.register_editor_class}.
-    #   @param editor [Wx::PGEditor]  For builtin editors, use {Wx::PGEditor_X}, where X is builtin editor's name (TextCtrl, Choice, etc. see {Wx::PG::PGEditor} documentation for full list).
+    #   @param editor [Wx::PG::PGEditor]  For builtin editors, use {Wx::PGEditor_X}, where X is builtin editor's name (TextCtrl, Choice, etc. see {Wx::PG::PGEditor} documentation for full list).
     #   @return [void]
     # @overload set_editor(editorName)
     #   Sets editor for a property, by editor name.
@@ -1392,7 +1353,7 @@ module Wx::PG
     
     # Sets cell information for given column.
     # @param column [Integer] 
-    # @param cell [Wx::PGCell] 
+    # @param cell [Wx::PG::PGCell] 
     # @return [void]
     def set_cell(column, cell) end
     
@@ -1405,8 +1366,8 @@ module Wx::PG
     
     # Sets new set of choices for the property.
     # This operation deselects the property and clears its value.
-    # @param choices [Wx::PGChoices] 
-    # @return [true,false]
+    # @param choices [Wx::PG::PGChoices] 
+    # @return [Boolean]
     def set_choices(choices) end
     alias_method :choices=, :set_choices
     
@@ -1427,15 +1388,15 @@ module Wx::PG
     # Set default value of a property.
     # Synonymous to
     # 
-    # ```
-    #   SetAttribute("DefaultValue", value);
+    # ```ruby
+    #   set_attribute('DefaultValue', value)
     # ```
     # @param value [Wx::Variant] 
     # @return [void]
     def set_default_value(value) end
     alias_method :default_value=, :set_default_value
     
-    # @param expanded [true,false] 
+    # @param expanded [Boolean] 
     # @return [void]
     def set_expanded(expanded) end
     alias_method :expanded=, :set_expanded
@@ -1450,8 +1411,8 @@ module Wx::PG
     # Sets or clears given property flag, recursively.
     # This function is primarily intended for internal use.
     # @see Wx::PG::PGProperty#change_flag 
-    # @param flag [PGPropertyFlags] 
-    # @param set [true,false] 
+    # @param flag [Wx::PGPropertyFlags] 
+    # @param set [Boolean] 
     # @return [void]
     def set_flag_recursively(flag, set) end
     
@@ -1462,7 +1423,8 @@ module Wx::PG
     alias_method :help_string=, :set_help_string
     
     # Sets property's label.
-    # - Properties under same parent may have same labels. However, property names must still remain unique.- Unlike {Wx::PG::PropertyGridInterface#set_property_label}, this does not automatically update the display.
+    # - Properties under same parent may have same labels. However, property names must still remain unique.
+    # - Unlike {Wx::PG::PropertyGridInterface#set_property_label}, this does not automatically update the display.
     # @param label [String] 
     # @return [void]
     def set_label(label) end
@@ -1472,13 +1434,13 @@ module Wx::PG
     # If it is 0, the length is not limited and the text can be as long as it is supported by the underlying native text control widget.
     # Returns true if maximum length was set.
     # @param maxLen [Integer] 
-    # @return [true,false]
+    # @return [Boolean]
     def set_max_length(maxLen) end
     alias_method :max_length=, :set_max_length
     
     # Sets property's "is it modified?" flag.
     # Affects children recursively.
-    # @param modified [true,false] 
+    # @param modified [Boolean] 
     # @return [void]
     def set_modified_status(modified) end
     alias_method :modified_status=, :set_modified_status
@@ -1551,7 +1513,7 @@ module Wx::PG
     
     # Call with false in {Wx::PG::PGProperty#on_set_value} to cancel value changes after all (i.e.
     # cancel true returned by {Wx::PG::PGProperty#string_to_value} or {Wx::PG::PGProperty#int_to_value}).
-    # @param set [true,false] 
+    # @param set [Boolean] 
     # @return [void]
     def set_was_modified(set=true) end
     alias_method :was_modified=, :set_was_modified
@@ -1563,12 +1525,12 @@ module Wx::PG
     def update_parent_values; end
     
     # Returns true if containing grid uses {Wx::PG::PG_EX_WINDOW_STYLES::PG_EX_AUTO_UNSPECIFIED_VALUES}.
-    # @return [true,false]
+    # @return [Boolean]
     def uses_auto_unspecified; end
     
     # Clear cells associated with property.
-    # @param ignoreWithFlags [FlagType]  Cells will not be cleared for properties having these flags set.
-    # @param recursively [true,false]  If true, apply this operation recursively in child properties.
+    # @param ignoreWithFlags [Integer]  Cells will not be cleared for properties having these flags set.
+    # @param recursively [Boolean]  If true, apply this operation recursively in child properties.
     # @return [void]
     def clear_cells(ignoreWithFlags, recursively) end
     
@@ -1590,8 +1552,8 @@ module Wx::PG
     def empty; end
     
     # Returns true if child property is selected.
-    # @param recursive [true,false] 
-    # @return [true,false]
+    # @param recursive [Boolean] 
+    # @return [Boolean]
     def is_child_selected(recursive=false) end
     alias_method :child_selected?, :is_child_selected
     
@@ -1609,31 +1571,32 @@ module Wx::PG
     # @overload initialize()
     #   Default constructor.
     #   It is protected because {Wx::PG::PGProperty} is only a base class for other property classes.
-    #   @return [PGProperty]
+    #   @return [Wx::PG::PGProperty]
     # @overload initialize(label, name)
     #   Constructor.
     #   It is protected because {Wx::PG::PGProperty} is only a base class for other property classes. Non-abstract property classes should have constructor of this style:
     #   
-    #   ```
-    #     MyProperty( const wxString& label, const wxString& name, const T& value )
-    #         : wxPGProperty(label, name)
-    #     {
-    #         // Generally recommended way to set the initial value
-    #         // (as it should work in pretty much 100% of cases).
-    #         wxVariant variant;
-    #         variant << value;
-    #         SetValue(variant);
-    #     
-    #         // If has private child properties then create them here.
-    #         // For example:
-    #         //     AddPrivateChild( new wxStringProperty("Subprop 1",
-    #         //                                           wxPG_LABEL,
-    #         //                                           value.GetSubProp1()));
-    #     }
+    #   ```ruby
+    #     class WxPointProperty < Wx::PG::PGProperty
+    #   
+    #       def initialize(label = Wx::PG::PG_LABEL, name = Wx::PG::PG_LABEL, value = Wx::Point.new)
+    #         super(label, name)
+    #   
+    #         # should work in pretty much 100% of cases
+    #         self.value = value
+    #   
+    #         # add private child properties
+    #         add_private_child( Wx::PG::IntProperty.new("X", Wx::PG::PG_LABEL,value.x))
+    #         add_private_child( Wx::PG::IntProperty.new("Y", Wx::PG::PG_LABEL,value.y))
+    #       end
+    #   
+    #       # ...
+    #   
+    #     end
     #   ```
     #   @param label [String] 
     #   @param name [String] 
-    #   @return [PGProperty]
+    #   @return [Wx::PG::PGProperty]
     def initialize(*args) end
     
   end # PGProperty
@@ -1653,17 +1616,17 @@ module Wx::PG
   
     # @overload initialize()
     #   Default constructor.
-    #   @return [PGChoices]
+    #   @return [Wx::PG::PGChoices]
     # @overload initialize(a)
     #   Copy constructor, uses reference counting.
     #   To create a real copy, use {Wx::PG::PGChoices#copy} member function instead.
-    #   @param a [Wx::PGChoices] 
-    #   @return [PGChoices]
+    #   @param a [Wx::PG::PGChoices] 
+    #   @return [Wx::PG::PGChoices]
     # @overload initialize(labels, values=(Wx::ArrayInt.new()))
     #   Constructor.
     #   @param labels [Array<String>]  Labels for choices.
     #   @param values [Array<Integer>]  Values for choices. If empty, indexes are used. Otherwise must have at least the same size as labels.
-    #   @return [PGChoices]
+    #   @return [Wx::PG::PGChoices]
     def initialize(*args) end
     
     # @overload add(arr, arrint)
@@ -1675,28 +1638,28 @@ module Wx::PG
     #   Adds a single choice item.
     #   @param label [String]  Label for added choice.
     #   @param value [Integer]  Value for added choice. If unspecified, index is used.
-    #   @return [Wx::PGChoiceEntry]
+    #   @return [Wx::PG::PGChoiceEntry]
     # @overload add(label, bitmap, value=Wx::PG::PG_INVALID_VALUE)
     #   Adds a single item, with bitmap.
     #   @param label [String] 
     #   @param bitmap [Wx::Bitmap] 
     #   @param value [Integer] 
-    #   @return [Wx::PGChoiceEntry]
+    #   @return [Wx::PG::PGChoiceEntry]
     # @overload add(entry)
     #   Adds a single item with full entry information.
-    #   @param entry [Wx::PGChoiceEntry] 
-    #   @return [Wx::PGChoiceEntry]
+    #   @param entry [Wx::PG::PGChoiceEntry] 
+    #   @return [Wx::PG::PGChoiceEntry]
     def add(*args) end
     
     # Adds a single item, sorted.
     # @param label [String] 
     # @param value [Integer] 
-    # @return [Wx::PGChoiceEntry]
+    # @return [Wx::PG::PGChoiceEntry]
     def add_as_sorted(label, value=Wx::PG::PG_INVALID_VALUE) end
     
     # Assigns choices data, using reference counting.
     # To create a real copy, use {Wx::PG::PGChoices#copy} member function instead.
-    # @param a [Wx::PGChoices] 
+    # @param a [Wx::PG::PGChoices] 
     # @return [void]
     def assign(a) end
     
@@ -1705,17 +1668,12 @@ module Wx::PG
     def clear; end
     
     # Returns a real copy of the choices.
-    # @return [Wx::PGChoices]
+    # @return [Wx::PG::PGChoices]
     def copy; end
     
     # @return [void]
     def ensure_data; end
     
-    # Gets an unsigned number identifying this list.
-    # @return [Wx::PGChoicesId]
-    def get_id; end
-    alias_method :id, :get_id
-    
     # Returns label of item.
     # @param ind [Integer] 
     # @return [Wx::String]
@@ -1743,7 +1701,7 @@ module Wx::PG
     # Returns array of indices matching given strings.
     # Unmatching strings are added to 'unmatched', if not NULL.
     # @param strings [Array<String>] 
-    # @param unmatched [Wx::ArrayString] 
+    # @param unmatched [Array,nil] 
     # @return [Array<Integer>]
     def get_indices_for_strings(strings, unmatched=nil) end
     alias_method :indices_for_strings, :get_indices_for_strings
@@ -1763,28 +1721,23 @@ module Wx::PG
     #   @param label [String] 
     #   @param index [Integer] 
     #   @param value [Integer] 
-    #   @return [Wx::PGChoiceEntry]
+    #   @return [Wx::PG::PGChoiceEntry]
     # @overload insert(entry, index)
     #   Inserts a single item with full entry information.
-    #   @param entry [Wx::PGChoiceEntry] 
+    #   @param entry [Wx::PG::PGChoiceEntry] 
     #   @param index [Integer] 
-    #   @return [Wx::PGChoiceEntry]
+    #   @return [Wx::PG::PGChoiceEntry]
     def insert(*args) end
     
     # Returns false if this is a constant empty set of choices, which should not be modified.
-    # @return [true,false]
+    # @return [Boolean]
     def is_ok; end
     alias_method :ok?, :is_ok
     
-    # @overload item(i)
-    #   Returns item at given index.
-    #   @param i [Integer] 
-    #   @return [Wx::PGChoiceEntry]
-    # @overload item(i)
-    #   Returns item at given index.
-    #   @param i [Integer] 
-    #   @return [Wx::PGChoiceEntry]
-    def item(*args) end
+    # Returns item at given index.
+    # @param i [Integer] 
+    # @return [Wx::PG::PGChoiceEntry]
+    def item(i) end
     
     # Removes count items starting at position nIndex.
     # @param nIndex [Integer] 
@@ -1809,10 +1762,10 @@ module Wx::PG
     
     # @overload [](i)
     #   @param i [Integer] 
-    #   @return [Wx::PGChoiceEntry]
+    #   @return [Wx::PG::PGChoiceEntry]
     # @overload [](i)
     #   @param i [Integer] 
-    #   @return [Wx::PGChoiceEntry]
+    #   @return [Wx::PG::PGChoiceEntry]
     def [](*args) end
     
   end # PGChoices
@@ -1827,12 +1780,12 @@ module Wx::PG
     # {Wx::PG::PropertyGrid}
     # 
     # 
-    # @return [Wx::PropertyGrid]
+    # @return [Wx::PG::PropertyGrid]
     def parent; end
     # {Wx::PG::PropertyGrid}
     # 
     # 
-    # @param val [Wx::PropertyGrid]
+    # @param val [Wx::PG::PropertyGrid]
     # @return [void]
     def parent=(val); end