Version: 3.2.7
Loading...
Searching...
No Matches

#include <wx/propgrid/property.h>

+ Inheritance diagram for wxPGCellRenderer:

Detailed Description

Base class for wxPropertyGrid cell renderers.

Library:  wxPropertyGrid
Category:  wxPropertyGrid

Public Types

enum  {
  Selected ,
  ChoicePopup ,
  Control ,
  Disabled ,
  DontUseCellFgCol ,
  DontUseCellBgCol ,
  DontUseCellColours
}
  More...
 

Public Member Functions

 wxPGCellRenderer ()
 
virtual ~wxPGCellRenderer ()
 
virtual bool Render (wxDC &dc, const wxRect &rect, const wxPropertyGrid *propertyGrid, wxPGProperty *property, int column, int item, int flags) const =0
 Returns true if rendered something in the foreground (text or bitmap).
 
virtual wxSize GetImageSize (const wxPGProperty *property, int column, int item) const
 Returns size of the image in front of the editable area.
 
virtual void DrawCaptionSelectionRect (wxDC &dc, int x, int y, int w, int h) const
 Paints property category selection rectangle.
 
void DrawText (wxDC &dc, const wxRect &rect, int imageWidth, const wxString &text) const
 Utility to draw vertically centered text.
 
void DrawEditorValue (wxDC &dc, const wxRect &rect, int xOffset, const wxString &text, wxPGProperty *property, const wxPGEditor *editor) const
 Utility to draw editor's value, or vertically aligned text if editor is NULL.
 
int PreDrawCell (wxDC &dc, const wxRect &rect, const wxPropertyGrid *propGrid, const wxPGCell &cell, int flags) const
 Utility to render cell bitmap and set text colour plus bg brush colour.
 
void PostDrawCell (wxDC &dc, const wxPropertyGrid *propGrid, const wxPGCell &cell, int flags) const
 Utility to be called after drawing is done, to revert whatever changes PreDrawCell() did.
 

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Flags for Render(), PreDrawCell() and PostDrawCell().

Enumerator
Selected 

We are painting selected item.

ChoicePopup 

We are painting item in choice popup.

Control 

We are rendering wxOwnerDrawnComboBox control or other owner drawn control, but that is only officially supported one ATM).

Disabled 

We are painting a disable property.

DontUseCellFgCol 

We are painting selected, disabled, or similar item that dictates fore- and background colours, overriding any cell values.

DontUseCellBgCol 
DontUseCellColours 

Constructor & Destructor Documentation

◆ wxPGCellRenderer()

wxPGCellRenderer::wxPGCellRenderer ( )

◆ ~wxPGCellRenderer()

virtual wxPGCellRenderer::~wxPGCellRenderer ( )
virtual

Member Function Documentation

◆ DrawCaptionSelectionRect()

virtual void wxPGCellRenderer::DrawCaptionSelectionRect ( wxDC & dc,
int x,
int y,
int w,
int h ) const
virtual

Paints property category selection rectangle.

◆ DrawEditorValue()

void wxPGCellRenderer::DrawEditorValue ( wxDC & dc,
const wxRect & rect,
int xOffset,
const wxString & text,
wxPGProperty * property,
const wxPGEditor * editor ) const

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

◆ DrawText()

void wxPGCellRenderer::DrawText ( wxDC & dc,
const wxRect & rect,
int imageWidth,
const wxString & text ) const

Utility to draw vertically centered text.

◆ GetImageSize()

virtual wxSize wxPGCellRenderer::GetImageSize ( const wxPGProperty * property,
int column,
int item ) const
virtual

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

Remarks
If property is NULL, then this call is for a custom value. In that case the item is index to wxPropertyGrid's custom values.

Reimplemented in wxPGDefaultRenderer.

◆ PostDrawCell()

void wxPGCellRenderer::PostDrawCell ( wxDC & dc,
const wxPropertyGrid * propGrid,
const wxPGCell & cell,
int flags ) const

Utility to be called after drawing is done, to revert whatever changes PreDrawCell() did.

Parameters
dcwxDC which was used to paint on.
propGridProperty grid to which the cell belongs.
cellCell information.
flagsSame as those passed to PreDrawCell(). See list of render flags.

◆ PreDrawCell()

int wxPGCellRenderer::PreDrawCell ( wxDC & dc,
const wxRect & rect,
const wxPropertyGrid * propGrid,
const wxPGCell & cell,
int flags ) const

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

Parameters
dcwxDC to paint on.
rectBox reserved for drawing.
propGridProperty grid to which the cell belongs.
cellCell information.
flagsSee list of render flags.
Returns
Returns image width, which, for instance, can be passed to DrawText().

◆ Render()

virtual bool wxPGCellRenderer::Render ( wxDC & dc,
const wxRect & rect,
const wxPropertyGrid * propertyGrid,
wxPGProperty * property,
int column,
int item,
int flags ) const
pure virtual

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

Parameters
dcwxDC to paint on.
rectBox reserved for drawing.
propertyGridProperty grid in which property is displayed.
propertyProperty to be rendered.
columnProperty cell column.
itemIndex of chosen item if combo popup is drawn, -1 otherwise.
flagsSee list of render flags.

Implemented in wxPGDefaultRenderer.