wx.propgrid.LongStringProperty

Like wx.propgrid.StringProperty, but has a button that triggers a small text editor dialog.

Supported special attributes:

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

Class Hierarchy

Inheritance diagram for class LongStringProperty:

Methods Summary

__init__
DisplayEditorDialog	Shows editor dialog.
StringToValue	Converts text into Variant value appropriate for this property.
ValueToString	Converts property value into a text representation.

Class API

class wx.propgrid.LongStringProperty(EditorDialogProperty)

Possible constructors:

LongStringProperty(label=PG_LABEL, name=PG_LABEL, value="")

Like StringProperty, but has a button that triggers a small text editor dialog.

Methods

__init__(self, label=PG_LABEL, name=PG_LABEL, value="")

Parameters

• label (string) –

• name (string) –

• value (string) –

---

DisplayEditorDialog(self, pg, value)

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.

Parameters

• pg (wx.propgrid.PropertyGrid) – Property grid in which property is displayed.

• value (PGVariant) – Value to be edited.

Return type

tuple

Returns

( bool, value )

---

StringToValue(self, text, argFlags=0)

Converts text into Variant value appropriate for this property.

Parameters

• text (string) – Text to be translated into variant.

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

Return type

tuple

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

Returns

( bool, variant )

Note

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

---

ValueToString(self, value, argFlags=0)

Converts property value into a text representation.

Parameters

• value (PGVariant) – Value to be converted.

• argFlags (int) – If 0 (default value), then displayed string is returned. If PG_FULL_VALUE is set, returns complete, storable string value instead of displayable. If PG_EDITABLE_VALUE is set, returns string value that must be editable in textctrl. If PG_COMPOSITE_FRAGMENT is set, returns text that is appropriate to display as a part of string property’s composite text representation.

Return type

string

Note

Default implementation calls GenerateComposedValue .