.. 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.PGCellRenderer:

==========================================================================================================================================
|phoenix_title|  **wx.propgrid.PGCellRenderer**
==========================================================================================================================================

Base class for :ref:`wx.propgrid.PropertyGrid`  cell renderers.          







|

|class_hierarchy| Class Hierarchy
=================================

.. raw:: html

   <div id="toggleBlock" onclick="return toggleVisibility(this)" class="closed" style="cursor:pointer;">
   <img id="toggleBlock-trigger" src="_static/images/closed.png"/>
   Inheritance diagram for class <strong>PGCellRenderer</strong>:
   </div>
   <div id="toggleBlock-summary" style="display:block;"></div>
   <div id="toggleBlock-content" style="display:none;">
   <p class="graphviz">
   <center><img src="_static/images/inheritance/wx.propgrid.PGCellRenderer_inheritance.png" alt="Inheritance diagram of PGCellRenderer" usemap="#dummy" class="inheritance"/></center>
   <script type="text/javascript">toggleVisibilityOnLoad(document.getElementById('toggleBlock'))</script>
   <map id="dummy" name="dummy"> <area shape="rect" id="node1" href="wx.propgrid.PGCellRenderer.html" title="Base class for wx.propgrid.PropertyGrid  cell renderers." alt="" coords="5,83,204,112"/> <area shape="rect" id="node2" href="wx.ObjectRefData.html" title="wx.ObjectRefData" alt="" coords="37,5,172,35"/> </map> 
   </p>
   </div>

|


|sub_classes| Known Subclasses
==============================

:ref:`wx.propgrid.PGDefaultRenderer`

|


|method_summary| Methods Summary
================================

================================================================================ ================================================================================
:meth:`~wx.propgrid.PGCellRenderer.__init__`                                     
:meth:`~wx.propgrid.PGCellRenderer.DrawCaptionSelectionRect`                     Paints property category selection rectangle.
:meth:`~wx.propgrid.PGCellRenderer.DrawEditorValue`                              Utility to draw editor's value, or vertically aligned text if editor is ``None``.
:meth:`~wx.propgrid.PGCellRenderer.DrawText`                                     Utility to draw vertically centered text.
:meth:`~wx.propgrid.PGCellRenderer.GetImageSize`                                 Returns size of the image in front of the editable area.
:meth:`~wx.propgrid.PGCellRenderer.PostDrawCell`                                 Utility to be called after drawing is done, to revert whatever changes :meth:`~PGCellRenderer.PreDrawCell`   did.
:meth:`~wx.propgrid.PGCellRenderer.PreDrawCell`                                  Utility to render cell bitmap and set text colour plus bg brush colour.
:meth:`~wx.propgrid.PGCellRenderer.Render`                                       Returns ``True`` if rendered something in the foreground (text or bitmap).
================================================================================ ================================================================================


|


|api| Class API
===============


.. class:: wx.propgrid.PGCellRenderer(RefCounter)

   **Possible constructors**::

       PGCellRenderer()
       
   
   Base class for PropertyGrid cell renderers.



   .. method:: __init__(self)






   .. method:: DrawCaptionSelectionRect(self, dc, x, y, w, h)

      Paints property category selection rectangle.                  


      :param `dc`: 
      :type `dc`: wx.DC
      :param `x`: 
      :type `x`: int
      :param `y`: 
      :type `y`: int
      :param `w`: 
      :type `w`: int
      :param `h`: 
      :type `h`: int







   .. method:: DrawEditorValue(self, dc, rect, xOffset, text, property, editor)

      Utility to draw editor's value, or vertically aligned text if editor is ``None``.                  


      :param `dc`: 
      :type `dc`: wx.DC
      :param `rect`: 
      :type `rect`: wx.Rect
      :param `xOffset`: 
      :type `xOffset`: int
      :param `text`: 
      :type `text`: string
      :param `property`: 
      :type `property`: wx.propgrid.PGProperty
      :param `editor`: 
      :type `editor`: wx.propgrid.PGEditor







   .. method:: DrawText(self, dc, rect, imageWidth, text)

      Utility to draw vertically centered text.                  


      :param `dc`: 
      :type `dc`: wx.DC
      :param `rect`: 
      :type `rect`: wx.Rect
      :param `imageWidth`: 
      :type `imageWidth`: int
      :param `text`: 
      :type `text`: string







   .. method:: GetImageSize(self, property, column, item)

      Returns size of the image in front of the editable area.                  

                


      :param `property`: 
      :type `property`: wx.propgrid.PGProperty
      :param `column`: 
      :type `column`: int
      :param `item`: 
      :type `item`: int




      :rtype: `Size`     







      .. note:: 

         If property is ``None``, then this call is for a custom value. In that case the item is index to :ref:`wx.propgrid.PropertyGrid`'s custom values.   








   .. method:: PostDrawCell(self, dc, propGrid, cell, flags)

      Utility to be called after drawing is done, to revert whatever changes :meth:`PreDrawCell`   did.                  




      :param `dc`: :ref:`wx.DC`  which was used to paint on.  
      :type `dc`: wx.DC
      :param `propGrid`: Property grid to which the cell belongs.  
      :type `propGrid`: wx.propgrid.PropertyGrid
      :param `cell`: Cell information.  
      :type `cell`: wx.propgrid.PGCell
      :param `flags`: Same as those passed to :meth:`PreDrawCell` . See :ref:`list of render flags <wx.propgrid.PGCellRenderer>`.   
      :type `flags`: int










                  





   .. method:: PreDrawCell(self, dc, rect, propGrid, cell, flags)

      Utility to render cell bitmap and set text colour plus bg brush colour.                  




      :param `dc`: :ref:`wx.DC`  to paint on.  
      :type `dc`: wx.DC
      :param `rect`: Box reserved for drawing.  
      :type `rect`: wx.Rect
      :param `propGrid`: Property grid to which the cell belongs.  
      :type `propGrid`: wx.propgrid.PropertyGrid
      :param `cell`: Cell information.  
      :type `cell`: wx.propgrid.PGCell
      :param `flags`: See :ref:`list of render flags <wx.propgrid.PGCellRenderer>`.  
      :type `flags`: int














      :rtype: `int`



                  



      :returns: 

         Returns image width, which, for instance, can be passed to :meth:`DrawText` .   








   .. method:: Render(self, dc, rect, propertyGrid, property, column, item, flags)

      Returns ``True`` if rendered something in the foreground (text or bitmap).                  




      :param `dc`: :ref:`wx.DC`  to paint on.  
      :type `dc`: wx.DC
      :param `rect`: Box reserved for drawing.  
      :type `rect`: wx.Rect
      :param `propertyGrid`: Property grid in which property is displayed.  
      :type `propertyGrid`: wx.propgrid.PropertyGrid
      :param `property`: Property to be rendered.  
      :type `property`: wx.propgrid.PGProperty
      :param `column`: Property cell column.  
      :type `column`: int
      :param `item`: Index of chosen item if combo popup is drawn, -1 otherwise.  
      :type `item`: int
      :param `flags`: See :ref:`list of render flags <wx.propgrid.PGCellRenderer>`.   
      :type `flags`: int


















      :rtype: `bool`