Class: Wx::PG::MultiChoiceProperty

Inherits:
EditorDialogProperty show all
Defined in:
lib/wx/doc/gen/pg/pg_properties.rb

Overview

Property that manages a value resulting from MultiChoiceDialog.

Value is array of strings. You can get value as array of choice values/indices by calling #get_value_as_array_int. Supported special attributes:

  • PG_ATTR_MULTICHOICE_USERSTRINGMODE: If > 0, allow user to manually enter strings that are not in the list of choices. If this value is 1, user strings are preferably placed in front of valid choices. If value is 2, then those strings will placed behind valid choices.

  • PG_DIALOG_TITLE: Sets a specific title for the editor dialog (since 3.1.3).

Requires:

  • USE_PROPGRID

Instance Method Summary collapse

Methods inherited from EditorDialogProperty

#dlg_style_, #dlg_style_=, #dlg_title_, #dlg_title_=, #do_set_attribute, #get_editor_dialog

Methods inherited from PGProperty

#adapt_list_to_value, #add_choice, #add_private_child, #append_child, #are_all_children_specified, #are_children_components, #change_flag, #child_changed, #clear_cells, #delete_children, #delete_choice, #do_get_attribute, #do_get_editor_class, #do_get_validator, #do_get_value, #do_set_attribute, #each_attribute, #empty, #enable, #enable_common_value, #ensure_cells, #generate_composed_value, #get_attribute, #get_attribute_as_double, #get_attribute_as_long, #get_attributes, #get_attributes_as_list, #get_base_name, #get_cell, #get_cell_or_default, #get_child_count, #get_children_height, #get_choice_selection, #get_choices, #get_client_object, #get_column_editor, #get_common_value, #get_default_value, #get_depth, #get_displayed_common_value_count, #get_displayed_string, #get_editor_class, #get_editor_dialog, #get_flags_as_string, #get_grid, #get_grid_if_displayed, #get_help_string, #get_hint_text, #get_image_offset, #get_index_in_parent, #get_item_at_y, #get_label, #get_last_visible_sub_item, #get_main_parent, #get_max_length, #get_name, #get_parent, #get_property_by_name, #get_property_by_name_wh, #get_validator, #get_value, #get_value_as_string, #get_value_image, #get_value_type, #get_y, #has_flag, #has_flags_exact, #has_visible_children, #hide, #index, #insert_child, #insert_choice, #int_to_value, #is_category, #is_child_selected, #is_enabled, #is_expanded, #is_root, #is_some_parent, #is_sub_property, #is_text_editable, #is_value_unspecified, #is_visible, #item, #last, #on_custom_paint, #on_event, #on_measure_image, #on_validation_failure, #recreate_editor, #refresh_children, #refresh_editor, #set_attribute, #set_attributes, #set_auto_unspecified, #set_background_colour, #set_cell, #set_choice_selection, #set_choices, #set_client_object, #set_common_value, #set_default_colours, #set_default_value, #set_editor, #set_expanded, #set_flag_recursively, #set_flags_from_string, #set_help_string, #set_label, #set_max_length, #set_modified_status, #set_name, #set_parental_type, #set_text_colour, #set_validator, #set_value, #set_value_from_int, #set_value_from_string, #set_value_image, #set_value_in_event, #set_value_to_unspecified, #set_was_modified, #update_parent_values, #uses_auto_unspecified, #validate_value

Methods inherited from Object

#clone, #dup, #is_same_as, #un_share

Constructor Details

#initialize(label, name, strings, value) ⇒ Wx::PG::MultiChoiceProperty #initialize(label, name, choices, value = (Wx::ArrayString.new())) ⇒ Wx::PG::MultiChoiceProperty #initialize(label = Wx::PG::PG_LABEL, name = Wx::PG::PG_LABEL, value = (Wx::ArrayString.new())) ⇒ Wx::PG::MultiChoiceProperty

Returns a new instance of MultiChoiceProperty.

Overloads:

  • #initialize(label, name, strings, value) ⇒ Wx::PG::MultiChoiceProperty

    Parameters:

    • label (String)
    • name (String)
    • strings (Array<String>)
    • value (Array<String>)
  • #initialize(label, name, choices, value = (Wx::ArrayString.new())) ⇒ Wx::PG::MultiChoiceProperty

    Parameters:

    • label (String)
    • name (String)
    • choices (Wx::PG::PGChoices)
    • value (Array<String>) (defaults to: (Wx::ArrayString.new()))
  • #initialize(label = Wx::PG::PG_LABEL, name = Wx::PG::PG_LABEL, value = (Wx::ArrayString.new())) ⇒ Wx::PG::MultiChoiceProperty

    Parameters:

    • label (String) (defaults to: Wx::PG::PG_LABEL)
    • name (String) (defaults to: Wx::PG::PG_LABEL)
    • value (Array<String>) (defaults to: (Wx::ArrayString.new()))


1354
# File 'lib/wx/doc/gen/pg/pg_properties.rb', line 1354

def initialize(*args) end

Instance Method Details

#display_String

Returns:

  • (String)


1408
# File 'lib/wx/doc/gen/pg/pg_properties.rb', line 1408

def display_; end

#display_=(val) ⇒ void

This method returns an undefined value.

Parameters:

  • val (String)


1414
# File 'lib/wx/doc/gen/pg/pg_properties.rb', line 1414

def display_=(val); end

#display_editor_dialog(pg, value) ⇒ Boolean (protected)

Shows editor dialog.

Value to be edited should be read from value, and if dialog is not cancelled, it should be stored back and true should be returned.

Returns true if editor dialog was not cancelled and value was updated.

Parameters:

Returns:

  • (Boolean)


1455
# File 'lib/wx/doc/gen/pg/pg_properties.rb', line 1455

def display_editor_dialog(pg, value) end

#generate_value_as_string(value) ⇒ String

Parameters:

  • value (nil, String, Integer, Float, Time, Wx::Font, Wx::Colour, Wx::Variant, Array<WxVariant>, Array<String>, ObjectWx::PG::ColourPropertyValue)

Returns:

  • (String)


1430
# File 'lib/wx/doc/gen/pg/pg_properties.rb', line 1430

def generate_value_as_string(value) end

#get_value_as_array_intArray<Integer> Also known as: value_as_array_int

Returns:

  • (Array<Integer>)


1401
# File 'lib/wx/doc/gen/pg/pg_properties.rb', line 1401

def get_value_as_array_int; end

#get_value_as_indicesArray<Integer> Also known as: value_as_indices

Returns:

  • (Array<Integer>)


1433
# File 'lib/wx/doc/gen/pg/pg_properties.rb', line 1433

def get_value_as_indices; end

#on_set_valuevoid

This method returns an undefined value.

This virtual function is called after m_value has been set.

Remark:

- If m_value was set to Null variant (i.e. unspecified value), #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 #on_set_value provides a good opportunity to convert supported values into internal type. - Default implementation does nothing.



1369
# File 'lib/wx/doc/gen/pg/pg_properties.rb', line 1369

def on_set_value; end

#string_to_value(variant, text, argFlags = 0) ⇒ Boolean

Converts text into Variant value appropriate for this property.

Returns true if resulting Variant value was different.

Remark:

Default implementation converts semicolon delimited tokens into child values. Only works for properties with children.

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).

Parameters:

  • variant (Wx::Variant)

    On function entry this is the old value (should not be NullVariant in normal cases). Translated value must be assigned back to it.

  • text (String)

    Text to be translated into variant.

  • argFlags (Integer) (defaults to: 0)

    If PG_MISC_ARG_FLAGS::PG_FULL_VALUE is set, returns complete, storable value instead of displayable one (they may be different). If PG_MISC_ARG_FLAGS::PG_COMPOSITE_FRAGMENT is set, text is interpreted as a part of composite property string value (as generated by #value_to_string called with this same flag).

Returns:

  • (Boolean)


1398
# File 'lib/wx/doc/gen/pg/pg_properties.rb', line 1398

def string_to_value(variant, text, argFlags=0) end

#user_string_mode_Integer

Returns:

  • (Integer)


1420
# File 'lib/wx/doc/gen/pg/pg_properties.rb', line 1420

def user_string_mode_; end

#user_string_mode_=(val) ⇒ void

This method returns an undefined value.

Parameters:

  • val (Integer)


1426
# File 'lib/wx/doc/gen/pg/pg_properties.rb', line 1426

def user_string_mode_=(val); end

#value_Wx::Variant

Returns:



1438
# File 'lib/wx/doc/gen/pg/pg_properties.rb', line 1438

def value_; end

#value_=(val) ⇒ void

This method returns an undefined value.

Parameters:



1442
# File 'lib/wx/doc/gen/pg/pg_properties.rb', line 1442

def value_=(val); end

#value_to_string(value, argFlags = 0) ⇒ String

Converts property value into a text representation.

Remark:

Default implementation calls PGProperty#generate_composed_value.

Parameters:

Returns:

  • (String)


1381
# File 'lib/wx/doc/gen/pg/pg_properties.rb', line 1381

def value_to_string(value, argFlags=0) end