wxruby3 0.9.0-x64-mingw-ucrt → 0.9.2-x64-mingw-ucrt

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

@@ -34,6 +34,7 @@ module Wx::PG
   # 
   # 
   # 
+  # @wxrb_require USE_PROPGRID
   class PG_GETPROPERTYVALUES_FLAGS < Wx::Enum
   
     # Flag for {Wx::PG::PropertyGridInterface::SetProperty}* functions, {Wx::PG::PropertyGridInterface#hide_property}, etc.
@@ -70,6 +71,7 @@ module Wx::PG
   # 
   # 
   # 
+  # @wxrb_require USE_PROPGRID
   class PG_MISC_ARG_FLAGS < Wx::Enum
   
     # Get/Store full value instead of displayed value.
@@ -110,6 +112,7 @@ module Wx::PG
   # 
   # 
   # 
+  # @wxrb_require USE_PROPGRID
   class PG_SETVALUE_FLAGS < Wx::Enum
   
     # 
@@ -222,8 +225,9 @@ module Wx::PG
   
   # 
   # 
-  # == wxPGProperty Flags
+  # ## wxPGProperty Flags
   # 
+  # @wxrb_require USE_PROPGRID
   class PGPropertyFlags < Wx::Enum
   
     # Indicates bold font.
@@ -315,7 +319,7 @@ module Wx::PG
   # 
   # - Creating Custom Properties
   # 
-  # == Supplied Ready-to-use Property Classes
+  # ## Supplied Ready-to-use Property Classes
   # 
   # 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}.
   # 
@@ -359,28 +363,65 @@ module Wx::PG
   # 
   # - {Wx::PG::UIntProperty}
   # 
-  # == wxPropertyCategory
+  # ## wxPropertyCategory
   # 
   # Not an actual property per se, but a header for a group of properties. Regardless inherits from {Wx::PG::PGProperty}, and supports displaying 'labels' for columns other than the first one. Easiest way to set category's label for second column is to call {Wx::PG::PGProperty#set_value} with string argument.
   # 
-  # == wxStringProperty
+  # ## wxStringProperty
   # 
   # 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::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
+  # <div class="wxrb-remark">
+  # <b>Remark:</b>
+  # <p>{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.
+  # </p>
+  # </div>>
+  # 
+  # ## 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. 
   # 
-  # == wxUIntProperty
+  # ## 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:
@@ -389,9 +430,14 @@ module Wx::PG
   # - {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
+  # <div class="wxrb-remark">
+  # <b>Remark:</b>
+  # <p>For example how to use seamless 64-bit integer support, see {Wx::PG::IntProperty} documentation (just use {Wx::ULongLong} instead of {Wx::LongLong}).
+  # </p>
+  # </div>>
+  # 
+  # ## wxFloatProperty
   # 
   # 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.
@@ -401,7 +447,7 @@ module Wx::PG
   # - {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
+  # ## 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:
@@ -409,7 +455,7 @@ module Wx::PG
   # - {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
+  # ## wxLongStringProperty
   # 
   # Like {Wx::PG::StringProperty}, but has a button that triggers a small text editor dialog. Note that in long string values, some control characters are escaped: tab is represented by "\t", line break by "\n", carriage return by "\r" and backslash character by "\\". If another character is preceded
   # by backslash, the backslash is skipped.
@@ -450,14 +496,14 @@ module Wx::PG
   # Supported special attributes:
   # - ::{Wx::PG::PG_DIALOG_TITLE}: Sets a specific title for the text editor dialog.
   # 
-  # == {Wx::PG::DirProperty}
+  # ## {Wx::PG::DirProperty}
   # 
   # Like {Wx::PG::LongStringProperty}, but the button triggers dir selector instead.
   # 
   # Supported special attributes:
   # - ::{Wx::PG::PG_DIALOG_TITLE}: Sets specific title for the dir selector.
   # 
-  # == {Wx::PG::FileProperty}
+  # ## {Wx::PG::FileProperty}
   # 
   # Like {Wx::PG::LongStringProperty}, but the button triggers file selector instead.
   # Default wildcard is "All files..." but this can be changed by setting
@@ -473,12 +519,12 @@ module Wx::PG
   # given path string.
   # - ::{Wx::PG::PG_FILE_INITIAL_PATH}: Sets the initial path of where to look for files.
   # 
-  # == {Wx::PG::EnumProperty}
+  # ## {Wx::PG::EnumProperty}
   # 
   # Represents a single selection from a list of choices -
   # {Wx::OwnerDrawnComboBox} is used to edit the value.
   # 
-  # == {Wx::PG::FlagsProperty}
+  # ## {Wx::PG::FlagsProperty}
   # 
   # Represents a bit set that fits in a long integer. {Wx::PG::BoolProperty} sub-
   # properties are created for editing individual bits. Textctrl is created to
@@ -491,7 +537,7 @@ module Wx::PG
   # 
   # {Wx::PG::FlagsProperty} supports the same attributes as {Wx::PG::BoolProperty}.
   # 
-  # == {Wx::PG::ArrayStringProperty}
+  # ## {Wx::PG::ArrayStringProperty}
   # 
   # Property that manages a list of strings. Allows editing of a list
   # of strings in {Wx::TextCtrl} and in a separate dialog.
@@ -501,7 +547,7 @@ module Wx::PG
   # - ::{Wx::PG::PG_DIALOG_TITLE}: Sets a specific title for the editor dialog.
   # Default is comma (',').
   # 
-  # == {Wx::PG::DateProperty}
+  # ## {Wx::PG::DateProperty}
   # 
   # Property representing {Wx::DateTime}. Default editor is DatePickerCtrl,
   # although TextCtrl should work as well.
@@ -513,7 +559,7 @@ module Wx::PG
   #    Default is ::{Wx::DP_DEFAULT} | ::{Wx::DP_SHOWCENTURY}. Using ::{Wx::DP_ALLOWNONE}
   #    enables additional support for unspecified property value.
   # 
-  # == {Wx::PG::EditEnumProperty}
+  # ## {Wx::PG::EditEnumProperty}
   # 
   # Represents a string that can be freely edited or selected from list of choices -
   # custom combobox control is used to edit the value.
@@ -521,7 +567,7 @@ module Wx::PG
   # Uses int value, similar to {Wx::PG::EnumProperty}, unless text entered by user is
   # is not in choices (in which case string value is used).
   # 
-  # == {Wx::PG::MultiChoiceProperty}
+  # ## {Wx::PG::MultiChoiceProperty}
   # 
   # Allows editing a multiple selection from a list of strings. This is
   # property is pretty much built around concept of {Wx::MultiChoiceDialog}.
@@ -534,7 +580,7 @@ module Wx::PG
   # is 2, then those strings will placed behind valid choices.
   # - ::{Wx::PG::PG_DIALOG_TITLE}: Sets a specific title for the editor dialog.
   # 
-  # == {Wx::PG::ImageFileProperty}
+  # ## {Wx::PG::ImageFileProperty}
   # 
   # Property representing image file(name). Like {Wx::PG::FileProperty},
   # but has thumbnail of the image in front of the filename
@@ -549,7 +595,7 @@ module Wx::PG
   # - {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
+  # ## 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.
@@ -557,14 +603,14 @@ module Wx::PG
   # 
   # - {Wx::PG::PG_COLOUR_HAS_ALPHA}: If set to true allows user to edit the alpha colour component. 
   # 
-  # == wxFontProperty
+  # ## 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
+  # ## 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).
   # 
@@ -587,11 +633,11 @@ module Wx::PG
   #   def get_colour(index) end
   # ```
   # 
-  # == wxCursorProperty
+  # ## wxCursorProperty
   # 
-  # Represents a {Wx::Cursor}. {Wx::Choice} is used to edit the value. Drop-down list has cursor images under some (wxMSW) 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
+  # ## 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:
@@ -629,8 +675,6 @@ module Wx::PG
   #   end
   # ```
   # 
-  # === 
-  # 
   # Category:  {Wx::PG::PropertyGrid}
   # @see wxPropertyGrid Property Attribute Identifiers
   # 
@@ -647,12 +691,20 @@ module Wx::PG
   # @see wxPropertyGrid Property Attribute Identifiers
   # 
   # 
+  # @wxrb_require USE_PROPGRID
   class PGProperty < Object
   
     # This virtual function is called after m_value has been set.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>
+    # 
     # - 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.
+    # - Default implementation does nothing. 
+    # 
+    # </p>
+    # </div>>
     # @return [void]
     def on_set_value; end
     
@@ -663,7 +715,14 @@ module Wx::PG
     # Implement this function in derived class to check the value.
     # Return true if it is ok. Returning false prevents property change events from occurring.
     # 
-    # - Default implementation always returns true.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>
+    # 
+    # - Default implementation always returns true. 
+    # 
+    # </p>
+    # </div>>
     # @param value [Wx::Variant] 
     # @param validationInfo [Wx::PG::PGValidationInfo] 
     # @return [Boolean]
@@ -672,7 +731,11 @@ module Wx::PG
     # Converts text into {Wx::Variant} value appropriate for this property.
     # Returns true if resulting {Wx::Variant} value was different.
     # 
-    # Default implementation converts semicolon delimited tokens into child values. Only works for properties with children.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Default implementation converts semicolon delimited tokens into child values. Only works for properties with children.
+    # </p>
+    # </div>>
     # 
     # You might want to take into account that m_value is Null 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.
@@ -684,10 +747,17 @@ module Wx::PG
     # Converts integer (possibly a choice selection) into {Wx::Variant} value appropriate for this property.
     # Returns true if resulting {Wx::Variant} value was different.
     # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>
+    # 
     # - 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).
+    # - 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). 
+    # 
+    # </p>
+    # </div>>
     # @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.
@@ -695,7 +765,11 @@ module Wx::PG
     def int_to_value(variant, number, argFlags=0) end
     
     # Converts property value into a text representation.
-    # Default implementation calls {Wx::PG::PGProperty#generate_composed_value}.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Default implementation calls {Wx::PG::PGProperty#generate_composed_value}. 
+    # </p>
+    # </div>>
     # @param value [Wx::Variant]  Value to be converted.
     # @param argFlags [Integer]  If 0 (default value), then displayed string is returned. If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable string value instead of displayable. If {Wx::PG::PG_MISC_ARG_FLAGS::PG_EDITABLE_VALUE} is set, returns string value that must be editable in textctrl. If {Wx::PG::PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT} is set, returns text that is appropriate to display as a part of string property's composite text representation.
     # @return [String]
@@ -724,9 +798,16 @@ module Wx::PG
     # 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.
     # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>
+    # 
     # - 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}.
+    # - You can also return {Wx::PG::PG_DEFAULT_IMAGE_SIZE} which equals {Wx::DEFAULT_SIZE}. 
+    # 
+    # </p>
+    # </div>>
     # @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
@@ -740,7 +821,14 @@ 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.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>
+    # 
+    # - 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. 
+    # 
+    # </p>
+    # </div>>
     # @param propgrid [Wx::PG::PropertyGrid] 
     # @param wnd_primary [Wx::Window] 
     # @param event [Wx::Event] 
@@ -784,7 +872,7 @@ 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 #set_property_validator will override this.
+    # Setting validator explicitly via \#set_property_validator will override this.
     # In most situations, code like this should work well:
     # 
     # ```ruby
@@ -807,7 +895,11 @@ module Wx::PG
     #   end
     # ```
     # 
-    # You can get common filename validator by returning {Wx::PG::FileProperty.get_class_validator}. {Wx::PG::DirProperty}, for example, uses it.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>You can get common filename validator by returning {Wx::PG::FileProperty.get_class_validator}. {Wx::PG::DirProperty}, for example, uses it. 
+    # </p>
+    # </div>>
     # @return [Wx::Validator]
     def do_get_validator; end
     
@@ -815,10 +907,17 @@ 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.
     # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>
+    # 
     # - 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.
+    # 
+    # </p>
+    # </div>>
     # @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).
@@ -841,7 +940,11 @@ module Wx::PG
     # Reimplement this member function to add special handling for attributes of this property.
     # Return false to have the attribute automatically stored in m_attributes. Default implementation simply does that and nothing else.
     # 
-    # To actually set property attribute values from the application, use {Wx::PG::PGProperty#set_attribute} instead.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>To actually set property attribute values from the application, use {Wx::PG::PGProperty#set_attribute} instead. 
+    # </p>
+    # </div>>
     # @param name [String] 
     # @param value [Wx::Variant] 
     # @return [Boolean]
@@ -861,7 +964,11 @@ module Wx::PG
     alias_method :editor_dialog, :get_editor_dialog
     
     # Called whenever validation has failed with given pending value.
-    # If you implement this in your custom property class, please remember to call the base implementation as well, since they may use it to revert property into pre-change state.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>If you implement this in your custom property class, please remember to call the base implementation as well, since they may use it to revert property into pre-change state. 
+    # </p>
+    # </div>>
     # @param pendingValue [Wx::Variant] 
     # @return [void]
     def on_validation_failure(pendingValue) end
@@ -889,7 +996,11 @@ module Wx::PG
     # regular) children to a property.
     # Appended childProperty.
     # 
-    # {Wx::PG::PropertyGrid} is not automatically refreshed by this function.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>{Wx::PG::PropertyGrid} is not automatically refreshed by this function.
+    # </p>
+    # </div>>
     # @see Wx::PG::PGProperty#insert_child
     # @see  Wx::PG::PGProperty#add_private_child 
     # @param childProperty [Wx::PG::PGProperty] 
@@ -907,11 +1018,16 @@ module Wx::PG
     
     # 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 
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>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 
     # ```ruby
     #   enable(false)
     # ```
     #  instead of setting {Wx::PG::PGPropertyFlags::PG_PROP_DISABLED} flag.
+    # </p>
+    # </div>>
     # @see Wx::PG::PGProperty#has_flag
     # @see  GetFlags() 
     # @param flag [Wx::PGPropertyFlags] 
@@ -953,13 +1069,22 @@ module Wx::PG
     
     # @overload get_attribute(name)
     #   Returns property attribute value, null variant if not found.
-    #   For built-in attribute returns null variant if extra style {Wx::PG::PG_EX_WINDOW_STYLES::PG_EX_WRITEONLY_BUILTIN_ATTRIBUTES} is set.
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>For built-in attribute returns null variant if extra style {Wx::PG::PG_EX_WINDOW_STYLES::PG_EX_WRITEONLY_BUILTIN_ATTRIBUTES} is set. 
+    #   </p>
+    #   </div>>
     #   @param name [String] 
     #   @return [Wx::Variant]
     # @overload get_attribute(name, defVal)
     #   Returns named attribute, as string, if found.
     #   Otherwise defVal is returned.
-    #   For built-in attribute returns defVal if extra style {Wx::PG::PG_EX_WINDOW_STYLES::PG_EX_WRITEONLY_BUILTIN_ATTRIBUTES} is set.
+    #   
+    #   <div class="wxrb-remark">
+    #   <b>Remark:</b>
+    #   <p>For built-in attribute returns defVal if extra style {Wx::PG::PG_EX_WINDOW_STYLES::PG_EX_WRITEONLY_BUILTIN_ATTRIBUTES} is set. 
+    #   </p>
+    #   </div>>
     #   @param name [String] 
     #   @param defVal [String] 
     #   @return [String]
@@ -968,7 +1093,12 @@ module Wx::PG
     
     # Returns named attribute, as long, if found.
     # Otherwise defVal is returned.
-    # For built-in attribute returns defVal if extra style {Wx::PG::PG_EX_WINDOW_STYLES::PG_EX_WRITEONLY_BUILTIN_ATTRIBUTES} is set.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>For built-in attribute returns defVal if extra style {Wx::PG::PG_EX_WINDOW_STYLES::PG_EX_WRITEONLY_BUILTIN_ATTRIBUTES} is set. 
+    # </p>
+    # </div>>
     # @param name [String] 
     # @param defVal [Integer] 
     # @return [Integer]
@@ -977,7 +1107,12 @@ module Wx::PG
     
     # Returns named attribute, as double, if found.
     # Otherwise defVal is returned.
-    # For built-in attribute returns defVal if extra style {Wx::PG::PG_EX_WINDOW_STYLES::PG_EX_WRITEONLY_BUILTIN_ATTRIBUTES} is set.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>For built-in attribute returns defVal if extra style {Wx::PG::PG_EX_WINDOW_STYLES::PG_EX_WRITEONLY_BUILTIN_ATTRIBUTES} is set. 
+    # </p>
+    # </div>>
     # @param name [String] 
     # @param defVal [Float] 
     # @return [Float]
@@ -985,13 +1120,21 @@ module Wx::PG
     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.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>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. 
+    # </p>
+    # </div>>
     # @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.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>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. 
+    # </p>
+    # </div>>
     # @return [Wx::Variant]
     def get_attributes_as_list; end
     alias_method :attributes_as_list, :get_attributes_as_list
@@ -1010,7 +1153,11 @@ module Wx::PG
     alias_method :base_name, :get_base_name
     
     # 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.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>const version of this member function returns 'default' {Wx::PG::PGCell} object if the property itself didn't hold cell data. 
+    # </p>
+    # </div>>
     # @param column [Integer] 
     # @return [Wx::PG::PGCell]
     def get_cell_or_default(column) end
@@ -1117,13 +1264,22 @@ module Wx::PG
     
     # Returns highest level non-category, non-root parent.
     # Useful when you have nested properties with children.
-    # If immediate parent is root or category, this will return the property itself.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>If immediate parent is root or category, this will return the property itself. 
+    # </p>
+    # </div>>
     # @return [Wx::PG::PGProperty]
     def get_main_parent; end
     alias_method :main_parent, :get_main_parent
     
     # Returns maximum allowed length of the text the user can enter in the property text editor.
-    # 0 is returned if length is not explicitly limited and the text can be as long as it is supported by the underlying native text control widget.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>0 is returned if length is not explicitly limited and the text can be as long as it is supported by the underlying native text control widget. 
+    # </p>
+    # </div>>
     # @return [Integer]
     def get_max_length; end
     alias_method :max_length, :get_max_length
@@ -1161,7 +1317,11 @@ module Wx::PG
     alias_method :value_image, :get_value_image
     
     # Returns text representation of property's value.
-    # In older versions, this function used to be overridden to convert property's value into a string representation. This function is now handled by {Wx::PG::PGProperty#value_to_string}, and overriding this function now will result in run-time assertion failure.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>In older versions, this function used to be overridden to convert property's value into a string representation. This function is now handled by {Wx::PG::PGProperty#value_to_string}, and overriding this function now will result in run-time assertion failure. 
+    # </p>
+    # </div>>
     # @param argFlags [Integer]  If 0 (default value), then displayed string is returned. If {Wx::PG::PG_MISC_ARG_FLAGS::PG_FULL_VALUE} is set, returns complete, storable string value instead of displayable. If {Wx::PG::PG_MISC_ARG_FLAGS::PG_EDITABLE_VALUE} is set, returns string value that must be editable in textctrl. If {Wx::PG::PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT} is set, returns text that is appropriate to display as a part of string property's composite text representation.
     # @return [String]
     def get_value_as_string(argFlags=0) end
@@ -1230,7 +1390,11 @@ module Wx::PG
     # regular) children to a property.
     # Inserted childProperty.
     # 
-    # {Wx::PG::PropertyGrid} is not automatically refreshed by this function.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>{Wx::PG::PropertyGrid} is not automatically refreshed by this function.
+    # </p>
+    # </div>>
     # @see Wx::PG::PGProperty#append_child
     # @see  Wx::PG::PGProperty#add_private_child 
     # @param index [Integer] 
@@ -1278,7 +1442,11 @@ module Wx::PG
     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).
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>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). 
+    # </p>
+    # </div>>
     # @return [Boolean]
     def is_text_editable; end
     alias_method :text_editable?, :is_text_editable
@@ -1313,7 +1481,11 @@ module Wx::PG
     def refresh_editor; end
     
     # Sets an attribute for this property.
-    # Setting attribute's value to Null variant will simply remove it from property's set of attributes.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Setting attribute's value to Null variant will simply remove it from property's set of attributes. 
+    # </p>
+    # </div>>
     # @param name [String]  Text identifier of attribute. See wxPropertyGrid Property Attribute Identifiers.
     # @param value [nil,String,Integer,Float,Time,Wx::Font,Wx::Colour,Wx::Variant,Array<WxVariant>,Array<String>,ObjectWx::PG::ColourPropertyValue]  Value of attribute.
     # @return [void]
@@ -1332,7 +1504,11 @@ module Wx::PG
     alias_method :auto_unspecified=, :set_auto_unspecified
     
     # Sets property's background colour.
-    # Unlike {Wx::PG::PropertyGridInterface#set_property_background_colour}, this does not automatically update the display.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Unlike {Wx::PG::PropertyGridInterface#set_property_background_colour}, this does not automatically update the display. 
+    # </p>
+    # </div>>
     # @param colour [Wx::Colour,String,Symbol]  Background colour to use.
     # @param flags [Integer]  Default is {Wx::PG::PG_GETPROPERTYVALUES_FLAGS::PG_RECURSE} which causes colour to be set recursively. Omit this flag to only set colour for the property in question and not any of its children.
     # @return [void]
@@ -1365,14 +1541,22 @@ module Wx::PG
     alias_method :common_value=, :set_common_value
     
     # Sets new set of choices for the property.
-    # This operation deselects the property and clears its value.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>This operation deselects the property and clears its value. 
+    # </p>
+    # </div>>
     # @param choices [Wx::PG::PGChoices] 
     # @return [Boolean]
     def set_choices(choices) end
     alias_method :choices=, :set_choices
     
     # Sets client data (void*) of a property.
-    # This untyped client data has to be deleted manually.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>This untyped client data has to be deleted manually. 
+    # </p>
+    # </div>>
     # @param clientData [Object] 
     # @return [void]
     def set_client_data(clientData) end
@@ -1423,8 +1607,15 @@ module Wx::PG
     alias_method :help_string=, :set_help_string
     
     # Sets property's label.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>
+    # 
     # - 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.
+    # - Unlike {Wx::PG::PropertyGridInterface#set_property_label}, this does not automatically update the display. 
+    # 
+    # </p>
+    # </div>>
     # @param label [String] 
     # @return [void]
     def set_label(label) end
@@ -1452,14 +1643,22 @@ module Wx::PG
     alias_method :name=, :set_name
     
     # Changes what sort of parent this property is for its children.
-    # You generally do not need to call this function.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>You generally do not need to call this function. 
+    # </p>
+    # </div>>
     # @param flag [Integer]  Use one of the following values: {Wx::PG::PGPropertyFlags::PG_PROP_MISC_PARENT} (for generic parents), {Wx::PG::PGPropertyFlags::PG_PROP_CATEGORY} (for categories), or {Wx::PG::PGPropertyFlags::PG_PROP_AGGREGATE} (for derived property classes with private children).
     # @return [void]
     def set_parental_type(flag) end
     alias_method :parental_type=, :set_parental_type
     
     # Sets property's text colour.
-    # Unlike {Wx::PG::PropertyGridInterface#set_property_text_colour}, this does not automatically update the display.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Unlike {Wx::PG::PropertyGridInterface#set_property_text_colour}, this does not automatically update the display. 
+    # </p>
+    # </div>>
     # @param colour [Wx::Colour,String,Symbol]  Text colour to use.
     # @param flags [Integer]  Default is {Wx::PG::PG_GETPROPERTYVALUES_FLAGS::PG_RECURSE} which causes colour to be set recursively. Omit this flag to only set colour for the property in question and not any of its children.
     # @return [void]
@@ -1467,7 +1666,11 @@ module Wx::PG
     alias_method :text_colour=, :set_text_colour
     
     # Sets property's default text and background colours.
-    # Unlike {Wx::PG::PropertyGridInterface#set_property_colours_to_default}, this does not automatically update the display.
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Unlike {Wx::PG::PropertyGridInterface#set_property_colours_to_default}, this does not automatically update the display.
+    # </p>
+    # </div>>
     # @param flags [Integer]  Default is {Wx::PG::PG_GETPROPERTYVALUES_FLAGS::PG_RECURSE} which causes colours to be set recursively. Omit this flag to only set colours for the property in question and not any of its children.
     # @return [void]
     def set_default_colours(flags=Wx::PG::PG_GETPROPERTYVALUES_FLAGS::PG_RECURSE) end
@@ -1481,7 +1684,12 @@ module Wx::PG
     
     # Call this to set value of the property.
     # Unlike methods in {Wx::PG::PropertyGrid}, this does not automatically update the display.
-    # Use {Wx::PG::PropertyGrid#change_property_value} instead if you need to run through validation process and send property change event.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Use {Wx::PG::PropertyGrid#change_property_value} instead if you need to run through validation process and send property change event.
+    # </p>
+    # </div>>
     # 
     # If you need to change property value in event, based on user input, use {Wx::PG::PGProperty#set_value_in_event} instead.
     # @param value [nil,String,Integer,Float,Time,Wx::Font,Wx::Colour,Wx::Variant,Array<WxVariant>,Array<String>,ObjectWx::PG::ColourPropertyValue]  The value to set.
@@ -1500,7 +1708,12 @@ module Wx::PG
     
     # Call this function in {Wx::PG::PGProperty#on_event}, OnButtonClick() etc.
     # to change the property value based on user input.
-    # This method is const since it doesn't actually modify value, but posts given variant as pending value, stored in {Wx::PG::PropertyGrid}.
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>This method is const since it doesn't actually modify value, but posts given variant as pending value, stored in {Wx::PG::PropertyGrid}. 
+    # </p>
+    # </div>>
     # @param value [nil,String,Integer,Float,Time,Wx::Font,Wx::Colour,Wx::Variant,Array<WxVariant>,Array<String>,ObjectWx::PG::ColourPropertyValue] 
     # @return [void]
     def set_value_in_event(value) end
@@ -1520,7 +1733,12 @@ module Wx::PG
     
     # Updates composed values of parent non-category properties, recursively.
     # Returns topmost property updated.
-    # Must not call {Wx::PG::PGProperty#set_value} (as can be called in it).
+    # 
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Must not call {Wx::PG::PGProperty#set_value} (as can be called in it). 
+    # </p>
+    # </div>>
     # @return [Wx::PG::PGProperty]
     def update_parent_values; end
     
@@ -1540,7 +1758,11 @@ module Wx::PG
     def ensure_cells(column) end
     
     # Returns (direct) child property with given name (or NULL if not found), with hint index.
-    # Does not support scope (i.e. Parent.Child notation).
+    # <div class="wxrb-remark">
+    # <b>Remark:</b>
+    # <p>Does not support scope (i.e. Parent.Child notation). 
+    # </p>
+    # </div>>
     # @param name [String]  Name of the child property to look for.
     # @param hintIndex [Integer]  Start looking for the child at this index.
     # @return [Wx::PG::PGProperty]
@@ -1604,14 +1826,18 @@ module Wx::PG
   # Helper class for managing choices of {Wx::PG::PropertyGrid} properties.
   # Each entry can have label, value, bitmap, text colour, and background colour.
   # {Wx::PG::PGChoices} uses reference counting, similar to other wxWidgets classes. This means that assignment operator and copy constructor only copy the reference and not the actual data. Use {Wx::PG::PGChoices#copy} member function to create a real copy.
-  # If you do not specify value for entry, index is used.
   # 
-  # === 
+  # <div class="wxrb-remark">
+  # <b>Remark:</b>
+  # <p>If you do not specify value for entry, index is used.
+  # </p>
+  # </div>>
   # 
   # Category:  {Wx::PG::PropertyGrid}
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_PROPGRID
   class PGChoices < ::Object
   
     # @overload initialize()
@@ -1775,6 +2001,7 @@ module Wx::PG
   # 
   # 
   # @note This class is <b>untracked</b> and should not be derived from nor instances extended!
+  # @wxrb_require USE_PROPGRID
   class PGPaintData < ::Object
   
     # {Wx::PG::PropertyGrid}