wxownerdrawncombobox

wxownerdrawncombobox is a combobox with owner-drawn list items. in essence, it is a wxcomboctrl with wxvlistbox popup and wxcontrolwithitems interface.

implementing item drawing and measuring is similar to wxvlistbox. application needs to subclass wxownerdrawncombobox and implement ondrawitem(), onmeasureitem() and onmeasureitemwidth().

derived from

wxcomboctrl
wxcontrolwithitems
wxcontrol
wxwindow
wxevthandler
wxobject

include files

<odcombo.h>

window styles

wxodcb_dclick_cycles	double-clicking cycles item if wxcb_readonly is also used. synonymous with wxcc_special_dclick.
wxodcb_std_control_paint	control itself is not custom painted using ondrawitem. even if this style is not used, writable wxownerdrawncombobox is never custom painted unless setcustompaintwidth is called.

event handling

evt_combobox(id, func)

process a wxevt_command_combobox_selected event, when an item on the list is selected. note that calling getvalue returns the new value of selection.

wxownerdrawncombobox::wxownerdrawncombobox

wxownerdrawncombobox()

default constructor.

wxownerdrawncombobox(wxwindow* parent, wxwindowid id, const wxstring& value = "", const wxpoint& pos = wxdefaultposition, const wxsize& size = wxdefaultsize, int n = 0, const wxstring choices[] = null, long style = 0, const wxvalidator& validator = wxdefaultvalidator, const wxstring& name = "combobox")

wxownerdrawncombobox(wxwindow* parent, wxwindowid id, const wxstring& value, const wxpoint& pos, const wxsize& size, const wxarraystring& choices, long style = 0, const wxvalidator& validator = wxdefaultvalidator, const wxstring& name = "combobox")

constructor, creating and showing a owner-drawn combobox.

parameters

parent

parent window. must not be null.

window identifier. a value of -1 indicates a default value.

value

initial selection string. an empty string indicates no selection.

pos

window position.

size

window size. if the default size (-1, -1) is specified then the window is sized appropriately.

number of strings with which to initialise the control.

choices

an array of strings with which to initialise the control.

style

wxownerdrawncombobox

validator

window validator.

name

window name.

wxownerdrawncombobox::~wxownerdrawncombobox

~wxownerdrawncombobox()

destructor, destroying the owner-drawn combobox.

wxownerdrawncombobox::create

bool create(wxwindow* parent, wxwindowid id, const wxstring& value = "", const wxpoint& pos = wxdefaultposition, const wxsize& size = wxdefaultsize, int n, const wxstring choices[], long style = 0, const wxvalidator& validator = wxdefaultvalidator, const wxstring& name = "combobox")

bool create(wxwindow* parent, wxwindowid id, const wxstring& value, const wxpoint& pos, const wxsize& size, const wxarraystring& choices, long style = 0, const wxvalidator& validator = wxdefaultvalidator, const wxstring& name = "combobox")

creates the combobox for two-step construction. derived classes should call or replace this function. see wxownerdrawncombobox::wxownerdrawncombobox for further details.

wxownerdrawncombobox::getwidestitem

int getwidestitem() const

returns index to the widest item in the list.

wxownerdrawncombobox::getwidestitemwidth

int getwidestitemwidth() const

returns width of the widest item in the list.

wxownerdrawncombobox::ondrawbackground

void ondrawbackground(wxdc& dc, const wxrect& rect, int item, int flags) const

this method is used to draw the items background and, maybe, a border around it.

the base class version implements a reasonable default behaviour which consists in drawing the selected item with the standard background colour and drawing a border around the item if it is either selected or current.

remarks

flags has the same meaning as with ondrawitem.

wxownerdrawncombobox::ondrawitem

void ondrawitem(wxdc& dc, const wxrect& rect, int item, int flags) const

the derived class may implement this function to actually draw the item with the given index on the provided dc. if function is not implemented, the item text is simply drawn, as if the control was a normal combobox.

parameters

the device context to use for drawing

rect

the bounding rectangle for the item being drawn (dc clipping region is set to this rectangle before calling this function)

item

the index of the item to be drawn

flags

combines any of the following flag values:

`wxodcb_painting_control`	combo control is being painted, instead of a list item. argument item may be wxnot_found in this case.
`wxodcb_painting_selected`	an item with selection background is being painted. dc text colour should already be correct.

wxownerdrawncombobox::onmeasureitem

wxcoord onmeasureitem(size_t item) const

the derived class may implement this method to return the height of the specified item (in pixels).

the default implementation returns text height, as if this control was a normal combobox.

wxownerdrawncombobox::onmeasureitemwidth

wxcoord onmeasureitemwidth(size_t item) const

the derived class may implement this method to return the width of the specified item (in pixels). if -1 is returned, then the item text width is used.

the default implementation returns -1.