Public Member Functions

VDKCombo (VDKForm *owner, char *def=(char *) NULL, GtkWidget *combo=NULL)
void SetBackground (VDKRgb rgb, GtkStateType state)

Public Attributes

VDKReadWriteValueProp
< VDKCombo, char * > Text
VDKReadWriteValueProp
< VDKCombo, bool > Editable
VDKReadWriteValueProp
< VDKCombo, bool > Sorted
VDKReadWriteValueProp
< VDKCombo, bool > Hidden
VDKReadWriteValueProp
< VDKCombo, bool > CaseSensitive
VDKReadWriteValueProp
< VDKCombo, StringList > PopdownStrings
VDKReadOnlyValueProp< VDKCombo,
int > Selected

Detailed Description

Provides a simplified wrapper for gtkcombo.

Author:: Eric T. Wienke <eric@liquidsilver.com>

Signals

activate_signal received when the Enter key is pressed in the Entry.
changed_signal received when text in Entry is changed.
selection_changed_signal, received when the selection in the List is changed. This happens when an item has been selected or unselected. This means that the signal is received more than once on a new selection. Always check the Selected property for a value of -1.
focus_in_signal received when Entry gets focus.
focus_out_signal received when Entry loses focus.

Constructor & Destructor Documentation

VDKCombo::VDKCombo	(	VDKForm *	owner,
		char *	def = `(char*) NULL`,
		GtkWidget *	combo = `NULL`
	)

Constructor

Parameters:

def	is an optional initial value to be shown in the Entrybox.
combo	internal use, leave it as NULL.

Member Function Documentation

void VDKCombo::SetBackground	(	VDKRgb	color,
		GtkStateType	state
	)		`[virtual]`

Sets object background

Parameters:

color	a VDKRgb object
state	can be one of the gtk+ widget states

Reimplemented from VDKObject.

Member Data Documentation

VDKReadWriteValueProp<VDKCombo,bool> VDKCombo::CaseSensitive

Default: false. Whether the Combo box should check for equality in the list case-sensitive or not.

VDKReadWriteValueProp<VDKCombo,bool> VDKCombo::Editable

Same as Editable property in VDKEntry. Setting it to false allows you to provide a read-only list to select from, without the user being able to enter text.

VDKReadWriteValueProp<VDKCombo,bool> VDKCombo::Hidden

Entry text visibility flag. (As in VDKEntry)

VDKReadWriteValueProp<VDKCombo,StringList> VDKCombo::PopdownStrings

A StringList corresponding to the Text of the Listitems. Use this function to add items to the list,

    StringList sl = mycombo->PopdownStrings;
    VDKString s("New line");
    sl.add(s);
    mycombo->PopdownStrings = sl;

Since StringList is of type VDKValueList<VDKString> you can use all functions of VDKValueList to manipulate the list. It is very convenient to access the StringList by index:

    int sel = mycombo->Selected;
    char *seltext = (sel == -1) ? "None" : 
           (char*)(mycombo->GetPopdownStrings())[sel];
    printf("Selected item is %s\n",seltext);

Tip

Note the use of the get function GetPopdownStrings() instead of the property because it was used within an expression.

    mycombo->PopdownStrings[sel];

would result in a compilation error. You can however use a typecast:

    ((StringList)mycombo->PopdownStrings)[sel]

VDKReadOnlyValueProp<VDKCombo,int> VDKCombo::Selected

Returns the index of the currently selected item in the dropdown list or -1 if no item is selected. See PopdownStrings for example usage.

VDKReadWriteValueProp<VDKCombo,bool> VDKCombo::Sorted

Default: false. Setting Sorted to true will automatically sort the listitems alphabetically and maintain the list sorted whenever a new item is added

VDKReadWriteValueProp<VDKCombo,char*> VDKCombo::Text

Set/Get the text in the Entry

The documentation for this class was generated from the following files:

combo.h
combo.cc