7c913512a4
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@52383 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
110 lines
3.7 KiB
Objective-C
110 lines
3.7 KiB
Objective-C
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: pickerbase.h
|
|
// Purpose: documentation for wxPickerBase class
|
|
// Author: wxWidgets team
|
|
// RCS-ID: $Id$
|
|
// Licence: wxWindows license
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
/**
|
|
@class wxPickerBase
|
|
@wxheader{pickerbase.h}
|
|
|
|
Base abstract class for all pickers which support an auxiliary text control.
|
|
This class handles all positioning and sizing of the text control like a
|
|
an horizontal wxBoxSizer would do, with the text control on
|
|
the left of the picker button.
|
|
The proportion (see wxSizer documentation for more info about
|
|
proportion values) of the picker control defaults to 1 when there isn't a text
|
|
control
|
|
associated (see @c wxPB_USE_TEXTCTRL style) and to 0 otherwise.
|
|
|
|
@beginStyleTable
|
|
@style{wxPB_USE_TEXTCTRL}:
|
|
Creates a text control to the left of the picker which is
|
|
completely managed by this wxPickerBase class.
|
|
@endStyleTable
|
|
|
|
@library{wxcore}
|
|
@category{FIXME}
|
|
|
|
@seealso
|
|
wxColourPickerCtrl
|
|
*/
|
|
class wxPickerBase : public wxControl
|
|
{
|
|
public:
|
|
/**
|
|
Returns the margin (in pixel) between the picker and the text control.
|
|
This function can be used only when HasTextCtrl() returns @true.
|
|
*/
|
|
int GetInternalMargin();
|
|
|
|
/**
|
|
Returns the proportion value of the picker.
|
|
*/
|
|
int GetPickerCtrlProportion();
|
|
|
|
/**
|
|
Returns a pointer to the text control handled by this window or @NULL if the
|
|
@b wxPB_USE_TEXTCTRL style was not specified when this control was created.
|
|
Very important: the contents of the text control could be containing an invalid
|
|
representation of the entity which can be chosen through the picker (e.g. the user entered an invalid colour syntax because of a typo). Thus you should never parse the content of the textctrl to get the user's input; rather use the derived-class getter (e.g. wxColourPickerCtrl::GetColour, wxFilePickerCtrl::GetPath, etc).
|
|
*/
|
|
wxTextCtrl * GetTextCtrl();
|
|
|
|
/**
|
|
Returns the proportion value of the text control.
|
|
This function can be used only when HasTextCtrl() returns @true.
|
|
*/
|
|
int GetTextCtrlProportion();
|
|
|
|
/**
|
|
Returns @true if this window has a valid text control (i.e. if the @b
|
|
wxPB_USE_TEXTCTRL style was
|
|
given when creating this control).
|
|
*/
|
|
bool HasTextCtrl();
|
|
|
|
/**
|
|
Returns @true if the picker control is growable.
|
|
*/
|
|
bool IsPickerCtrlGrowable();
|
|
|
|
/**
|
|
Returns @true if the text control is growable.
|
|
This function can be used only when HasTextCtrl() returns @true.
|
|
*/
|
|
bool IsTextCtrlGrowable();
|
|
|
|
/**
|
|
Sets the margin (in pixel) between the picker and the text control.
|
|
This function can be used only when HasTextCtrl() returns @true.
|
|
*/
|
|
void SetInternalMargin(int margin);
|
|
|
|
/**
|
|
Sets the picker control as growable when @c grow is @true.
|
|
*/
|
|
void SetPickerCtrlGrowable(bool grow = @true);
|
|
|
|
/**
|
|
Sets the proportion value of the picker.
|
|
Look at the overview of wxPickerBase for more details about this.
|
|
*/
|
|
void SetPickerCtrlProportion(int prop);
|
|
|
|
/**
|
|
Sets the text control as growable when @c grow is @true.
|
|
This function can be used only when HasTextCtrl() returns @true.
|
|
*/
|
|
void SetTextCtrlGrowable(bool grow = @true);
|
|
|
|
/**
|
|
Sets the proportion value of the text control.
|
|
Look at the overview of wxPickerBase for more details about this.
|
|
This function can be used only when HasTextCtrl() returns @true.
|
|
*/
|
|
void SetTextCtrlProportion(int prop);
|
|
};
|