SRadioGroup
Verwaltet einen Gruppe von zusammengehörigen SRadioButtons
Vererbung
| Basisklassen(n) |
|
abgeleitete Klassen |
|
|
SRadioGroup |
|
Attribute
public:
| Attribut |
Typ |
Beschreibung |
| radioCreateHeight |
int |
Breite, mit der neue RadioButtons in der Funktion 'addButton()' erstelltwerden. |
| radioCreateWidth |
int |
Breite, mit der neue RadioButtons in der Funktion 'addButton()' erstelltwerden. |
protected:
| Attribut |
Typ |
Beschreibung |
| posLeft |
int |
Y-Koordinate des nächsten mit 'addButton()' anzulegenden Radiobuttons. |
| posTop |
int |
Y-Koordinate des nächsten mit 'addButton()' anzulegenden Radiobuttons. |
| radios |
SPointerList |
Liste mit Zeigern auf die vorhandenen SRadioButtons. |
Operationen
public:
| Name |
Parameter |
Rückgabewert |
Beschreibung |
| addButton |
const SString& text,
int numValue,
const SString& stringValue="" |
BOOL |
Fügt dieser Gruppe einen Button hinzu. |
| deinit |
|
void |
Deinitialisiert, löscht die RadioGroup und alle enthaltenen Buttons. |
| getButton |
int value |
SRadioButton* |
Gibt den RadioButton zurück, dem 'value' zugeordnet ist. |
| getButton |
const SString& value |
SRadioButton* |
Gibt den RadioButton zurück, dem 'value' zugeordnet ist. |
| getButtonAt |
int pos |
SRadioButton* |
Liefert einen Zeiger auf den SRadioButton an der angegebenen Position. |
| getNumValue |
|
int |
Gibt einen Int-Wert zurück, der dem aktuell ausgewählten SRadioButton zugewiesen ist. |
| getSize |
|
int |
Ermittelt die aktuelle Anzahl an SRadioButton in der Gruppe. |
| getStringValue |
|
SString |
Gibt einen String zurück, der dem aktuell ausgewählten SRadioButton zugewiesen ist. |
| setChecked |
const SString& value |
BOOL |
Wählt den RadioButton aus, dem value zugeordnet ist. |
| setChecked |
int value |
BOOL |
Wählt den RadioButton aus, dem 'value' zugeordnet ist. |
protected:
| Name |
Parameter |
Rückgabewert |
Beschreibung |
| onHide |
|
void |
|
| onShow |
|
void |
|
Verwaltet einen Gruppe von zusammengehörigen SRadioButtons
Fügt dieser Gruppe einen Button hinzu.
Während des Hinzufügens aller RadioButtons zu einer Gruppe sollten keine anderen Controls erzeugt werden, um die TabOrder nicht zu unterbrechen.
Parameter:
| text |
der neben dem RadioButton darzustellende Text |
| numValue |
Wert der bei Auswahl dieses Radiobuttons gesetzt wird |
| stringValue |
Wert der bei Auswahl dieses Radiobuttons gesetzt wird |
Rückgabe:
| BOOL |
true wenn erfolgreich |
Deinitialisiert, löscht die RadioGroup und alle enthaltenen Buttons.
Gibt den RadioButton zurück, dem 'value' zugeordnet ist.
Parameter:
| value |
zugeordneter Wert des RadioButtons der zurückgegeben werden soll |
Rückgabe:
| SRadioButton* |
NULL wenn fehlerhaft, sonst einen Zeiger auf den Radioschalter |
Gibt den RadioButton zurück, dem 'value' zugeordnet ist.
Parameter:
| value |
zugeordneter Wert des RadioButtons der zurückgegeben werden soll |
Rückgabe:
| SRadioButton* |
NULL wenn fehlerhaft, sonst einen Zeiger auf den Radioschalter |
Liefert einen Zeiger auf den SRadioButton an der angegebenen Position.
Die Position wird duch die Reihenfolge beim Anlegen bestimmt. liegt die angegebene Position außerhalb der Listengröße, wird nach einer Fehlermeldung der erste bzw. letzte Button zurückgegeben. Wurde noch kein Button angelegt wird das Programm mit einer Zugriffsverletzung abstürzen.
Beispiel: Formatieren des Button-Texte
// Gruppe anlegen
rgrOptionen.createCtrl(this,"Optionen",50,50,200,200);
// Button hinzufügen
rgrOptionen.addButton("Auswahl 1",0);
rgrOptionen.addButton("Auswahl 2",5);
rgrOptionen.addButton("Auswahl 3",23);
rgrOptionen.addButton("Auswahl 4",42);
// formatieren (blauer Text)
SRadioButton* button;
for(int i = 0;i<rgrOptionen.getSize();++i)
{
button = rgrOptionen.getButtonAt(i);
button->screen.setTextColor(RGB(0,0,255));
}
Parameter:
| pos |
Position des SRadioButtons in der SRadioGroup |
Rückgabe:
| SRadioButton* |
Zeiger auf den angeforderten Button. |
Gibt einen Int-Wert zurück, der dem aktuell ausgewählten SRadioButton zugewiesen ist.
Ermittelt die aktuelle Anzahl an SRadioButton in der Gruppe.
Rückgabe:
Gibt einen String zurück, der dem aktuell ausgewählten SRadioButton zugewiesen ist.
Wählt den RadioButton aus, dem value zugeordnet ist.
Parameter:
| value |
zugeordneter Wert des RadioButtons der selektiert werden soll |
Rückgabe:
| BOOL |
true wenn erfolgreich |
Wählt den RadioButton aus, dem 'value' zugeordnet ist.
Parameter:
| value |
zugeordneter Wert des RadioButtons der selektiert werden soll |
Rückgabe:
| BOOL |
true wenn erfolgreich |
