.. wxPython Phoenix documentation
This file was generated by Phoenix's sphinx generator and associated
tools, do not edit by hand.
Copyright: (c) 2011-2020 by Total Control Software
License: wxWindows License
.. include:: headings.inc
.. _wx.propgrid.PGChoiceEditor:
==========================================================================================================================================
|phoenix_title| **wx.propgrid.PGChoiceEditor**
==========================================================================================================================================
|
|class_hierarchy| Class Hierarchy
=================================
.. raw:: html

Inheritance diagram for class
PGChoiceEditor:
|
|sub_classes| Known Subclasses
==============================
:ref:`wx.propgrid.PGChoiceAndButtonEditor`, :ref:`wx.propgrid.PGComboBoxEditor`
|
|method_summary| Methods Summary
================================
================================================================================ ================================================================================
:meth:`~wx.propgrid.PGChoiceEditor.__init__`
:meth:`~wx.propgrid.PGChoiceEditor.CanContainCustomImage` Returns ``True`` if control itself can contain the custom image.
:meth:`~wx.propgrid.PGChoiceEditor.CreateControls` Instantiates editor controls.
:meth:`~wx.propgrid.PGChoiceEditor.CreateControlsBase`
:meth:`~wx.propgrid.PGChoiceEditor.DeleteItem` Deletes item from existing control.
:meth:`~wx.propgrid.PGChoiceEditor.GetName` Returns pointer to the name of the editor.
:meth:`~wx.propgrid.PGChoiceEditor.GetValueFromControl` Returns value from control, via parameter `variant`.
:meth:`~wx.propgrid.PGChoiceEditor.InsertItem` Inserts item to existing control.
:meth:`~wx.propgrid.PGChoiceEditor.OnEvent` Handles events.
:meth:`~wx.propgrid.PGChoiceEditor.SetControlIntValue` Sets control's value specifically from int (applies to choice etc.).
:meth:`~wx.propgrid.PGChoiceEditor.SetControlStringValue` Sets control's value specifically from string.
:meth:`~wx.propgrid.PGChoiceEditor.SetValueToUnspecified` Sets value in control to unspecified.
:meth:`~wx.propgrid.PGChoiceEditor.UpdateControl` Loads value from property to the control.
================================================================================ ================================================================================
|
|property_summary| Properties Summary
=====================================
================================================================================ ================================================================================
:attr:`~wx.propgrid.PGChoiceEditor.Name` See :meth:`~wx.propgrid.PGChoiceEditor.GetName`
================================================================================ ================================================================================
|
|api| Class API
===============
.. class:: wx.propgrid.PGChoiceEditor(PGEditor)
**Possible constructors**::
PGChoiceEditor() -> None
.. method:: __init__(self)
:rtype: `None`
.. method:: CanContainCustomImage(self)
Returns ``True`` if control itself can contain the custom image.
Default implementation returns ``False``.
:rtype: `bool`
.. method:: CreateControls(self, propgrid : PropertyGrid, property : PGProperty, pos : Point, size : Size)
Instantiates editor controls.
:param `propgrid`: :ref:`wx.propgrid.PropertyGrid` to which the property belongs (use as parent for control).
:type `propgrid`: wx.propgrid.PropertyGrid
:param `property`: Property for which this method is called.
:type `property`: wx.propgrid.PGProperty
:param `pos`: Position, inside :ref:`wx.propgrid.PropertyGrid`, to create control(s) to.
:type `pos`: wx.Point
:param `size`: Initial size for control(s).
:type `size`: wx.Size
:rtype: :ref:`wx.propgrid.PGWindowList`
.. note::
- It is not necessary to call :meth:`wx.EvtHandler.Bind` for interesting editor events. All events from controls are automatically forwarded to :meth:`wx.propgrid.PGEditor.OnEvent` and :meth:`wx.propgrid.PGProperty.OnEvent` .
.. method:: CreateControlsBase(self, propgrid : PropertyGrid, property : PGProperty, pos : Point, sz : Size, extraStyle : int)
:param `propgrid`:
:type `propgrid`: wx.propgrid.PropertyGrid
:param `property`:
:type `property`: wx.propgrid.PGProperty
:param `pos`:
:type `pos`: wx.Point
:param `sz`:
:type `sz`: wx.Size
:param `extraStyle`:
:type `extraStyle`: long
:rtype: `Window`
.. method:: DeleteItem(self, ctrl : Window, index : int)
Deletes item from existing control.
Default implementation does nothing.
:param `ctrl`:
:type `ctrl`: wx.Window
:param `index`:
:type `index`: int
:rtype: `None`
.. method:: GetName(self)
Returns pointer to the name of the editor.
For example, PGEditor_TextCtrl has name "TextCtrl". If you don't need to access your custom editor by string name, then you do not need to implement this function.
:rtype: `str`
.. method:: GetValueFromControl(self, variant : PGVariant, property : PGProperty, ctrl : Window)
Returns value from control, via parameter `variant`.
Usually ends up calling property's StringToValue() or IntToValue(). Returns ``True`` if value was different.
:param `variant`:
:type `variant`: PGVariant
:param `property`:
:type `property`: wx.propgrid.PGProperty
:param `ctrl`:
:type `ctrl`: wx.Window
:rtype: `bool`
.. method:: InsertItem(self, ctrl : Window, label : str, index : int)
Inserts item to existing control.
Index -1 means end of list. Default implementation does nothing. Returns index of item added.
:param `ctrl`:
:type `ctrl`: wx.Window
:param `label`:
:type `label`: string
:param `index`:
:type `index`: int
:rtype: `int`
.. method:: OnEvent(self, propgrid : PropertyGrid, property : PGProperty, wnd_primary : Window, event : Event)
Handles events.
Returns ``True`` if value in control was modified (see :meth:`wx.propgrid.PGProperty.OnEvent` for more information).
:param `propgrid`:
:type `propgrid`: wx.propgrid.PropertyGrid
:param `property`:
:type `property`: wx.propgrid.PGProperty
:param `wnd_primary`:
:type `wnd_primary`: wx.Window
:param `event`:
:type `event`: wx.Event
:rtype: `bool`
.. note::
:ref:`wx.propgrid.PropertyGrid` will automatically unfocus the editor when ``wxEVT_TEXT_ENTER`` is received and when it results in property value being modified. This happens regardless of editor type (i.e. behaviour is same for any :ref:`wx.TextCtrl` and :ref:`wx.ComboBox` based editor).
.. method:: SetControlIntValue(self, property : PGProperty, ctrl : Window, value : int)
Sets control's value specifically from int (applies to choice etc.).
:param `property`:
:type `property`: wx.propgrid.PGProperty
:param `ctrl`:
:type `ctrl`: wx.Window
:param `value`:
:type `value`: int
:rtype: `None`
.. method:: SetControlStringValue(self, property : PGProperty, ctrl : Window, txt : str)
Sets control's value specifically from string.
:param `property`:
:type `property`: wx.propgrid.PGProperty
:param `ctrl`:
:type `ctrl`: wx.Window
:param `txt`:
:type `txt`: string
:rtype: `None`
.. method:: SetValueToUnspecified(self, property : PGProperty, ctrl : Window)
Sets value in control to unspecified.
:param `property`:
:type `property`: wx.propgrid.PGProperty
:param `ctrl`:
:type `ctrl`: wx.Window
:rtype: `None`
.. method:: UpdateControl(self, property : PGProperty, ctrl : Window)
Loads value from property to the control.
:param `property`:
:type `property`: wx.propgrid.PGProperty
:param `ctrl`:
:type `ctrl`: wx.Window
:rtype: `None`
.. attribute:: Name
See :meth:`~wx.propgrid.PGChoiceEditor.GetName`