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

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

@@ -374,41 +374,9 @@ module Wx::PG
   # 
   # == 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. 
   # 
@@ -600,40 +568,23 @@ module Wx::PG
   # 
   # 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
@@ -645,65 +596,37 @@ module Wx::PG
   # 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
-  #       }
-  #   
-  #       virtual bool StringToValue( wxVariant& variant, const wxString& text, int argFlags )
-  #       {
-  #           // TODO: Adapt string to property value.
-  #       }
-  #   
-  #   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)
+  #       def value_to_string(value, argFlags)
+  #         # TODO: Convert given property value to a string
+  #       end
   #   
-  #   // In sources file:
-  #   WX_PG_IMPLEMENT_VARIANT_DATA(MyDataClass)
+  #       def string_to_value(variant, text, argFlags)
+  #         # TODO: Adapt string to property value.
+  #       end
   #   
-  #   // Or, if you don't have valid == operator:
-  #   WX_PG_IMPLEMENT_VARIANT_DATA_DUMMY_EQ(MyDataClass)
+  #   protected
+  #       # ...
+  #   end
   # ```
   # 
   # === 
@@ -743,7 +666,7 @@ module Wx::PG
     # - Default implementation always returns true.
     # @param value [Wx::Variant] 
     # @param validationInfo [Wx::PG::PGValidationInfo] 
-    # @return [true,false]
+    # @return [Boolean]
     def validate_value(value, validationInfo) end
     
     # Converts text into {Wx::Variant} value appropriate for this property.
@@ -755,7 +678,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::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.
@@ -768,7 +691,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 [true,false]
+    # @return [Boolean]
     def int_to_value(variant, number, argFlags=0) end
     
     # Converts property value into a text representation.
@@ -784,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
     
@@ -794,7 +717,7 @@ 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
     
@@ -821,7 +744,7 @@ module Wx::PG
     # @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.
@@ -829,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.
@@ -868,20 +784,27 @@ module Wx::PG
     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.
@@ -899,23 +822,7 @@ module Wx::PG
     # @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::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
     
@@ -937,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.
@@ -991,24 +898,24 @@ module Wx::PG
     
     # 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
     
@@ -1025,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
     
@@ -1077,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]
@@ -1187,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
@@ -1281,30 +1194,30 @@ 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.
@@ -1333,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::PG::PGProperty] 
-    # @return [true,false]
+    # @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
     
@@ -1392,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.
@@ -1413,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
@@ -1454,7 +1367,7 @@ module Wx::PG
     # Sets new set of choices for the property.
     # This operation deselects the property and clears its value.
     # @param choices [Wx::PG::PGChoices] 
-    # @return [true,false]
+    # @return [Boolean]
     def set_choices(choices) end
     alias_method :choices=, :set_choices
     
@@ -1475,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
@@ -1498,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
     
@@ -1521,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
@@ -1600,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
@@ -1612,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
     
@@ -1639,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
     
@@ -1663,22 +1576,23 @@ module Wx::PG
     #   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] 
@@ -1760,11 +1674,6 @@ module Wx::PG
     # @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]
@@ -1792,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
@@ -1821,19 +1730,14 @@ module Wx::PG
     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::PG::PGChoiceEntry]
-    # @overload item(i)
-    #   Returns item at given index.
-    #   @param i [Integer] 
-    #   @return [Wx::PG::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]