Přehled vlastností, metod a událostí objektu:
--------------------------------------------------------------
Align (RW) Caption (RW) Color (RW)
Columns (RW) Ctl3D (RW) Cursor (RW)
Enabled (RW) Font (RW) Height (RW)
HelpContext (RW) Hint (RW) ItemIndex (RW)
Items (RW) Left (RW) Name (R)
ParentColor (RW) ParentCtl3D (RW) ParentFont (RW)
ParentShowHint (RW) PopupMenu (RW) ShowHint (RW)
TabOrder (RW) TabStop (RW) Tag (RW)
Top (RW) Visible (RW) Width (RW)
--------------------------------------------------------------
SetFocus
--------------------------------------------------------------
OnClick OnEnter OnExit
--------------------------------------------------------------
Legenda: * -> pouze z programu, R -> lze číst, W -> lze zadat
Komponenta RadioGroup se používá na vytvoření skupiny přepínacích tlačítek RadioButton včetně definice použitých tlačítek. Odpadnou tak problémy se skupinováním tlačítek a vše máte uloženo v jednom objektu. Výhodou je také možnost měnit počet tlačítek dynamicky přímo z aplikace. Lze je také uložit vytvořenou skupinu tlačítek do souboru k možnému pozdějšímu použití.
Index stisknutého tlačítka je přístupný ve vlastnosti ItemIndex. Index se čísluje od nuly, proto má například třetí zobrazené tlačítko přístupový index s číslem dva.
Objekt RadioGroup neobsahuje přetáčecí pruh a rozestup mezi tlačítky je upravován automaticky podle vymezené velikosti zobrazovaného objektu. Při velkém množství tlačítek by mohlo dojít až k jejich překrývání. Pokud je seznam rozsáhlejší, využijte vlastnost Columns pro rozdělení tlačítek do odstavců.
Seznam tlačítek je uložen ve vlastnosti Items, kterou představuje proměnná typu StrArray. Uvedený typ proměnné má své vlastní metody pro práci s obsaženým seznamem řetězců. Pro zadání počátečního obsahu můžete použít speciální editor přístupný z okna Nastavení objektu, který se aktivuje kliknutím na ikonu se třemi tečkami vpravo od vlastnosti Items.
Jednotlivá tlačítka jsou v seznamu řetězců přístupná svým indexem, to je pořadovým číslem.
Položky seznamu tlačítek jsou číslovány od nuly. První položka v pořadí má proto index nula,
pátá položka má index 4. Pokud potřebujete zjistit obsah položky, musíte zadat její pořadový
index. Obsah první položky proto zobrazíte následujícím způsobem:
Jazyk KLONDAIK:
ShowMessage(RadioGroup.Items[0]);
Jazyk BONANZA:
ShowMessage(RadioGroup.Items(0))
Podobným způsobem můžete změnit obsah položky, kdy opět zadáváte index položky a nový
obsah. Pro druhou položku v pořadí proto zadáte:
Jazyk KLONDAIK:
RadioGroup.Items[1]:='druhé tlačítko';
Jazyk BONANZA:
RadioGroup.Items(1) = "druhé tlačítko"
Nové tlačítko přidáte do seznamu z aplikace použitím metody Add následujícím způsobem:
Jazyk KLONDAIK:
RadioGroup.Items.Add('aaa');
Jazyk BONANZA:
RadioGroup.Items.Add("aaa")
Pokud potřebujete některé tlačítko ze seznamu zrušit, použijte volání metody Delete
následujícím způsobem:
Jazyk KLONDAIK:
RadioGroup.Items.Delete(2);
Jazyk BONANZA:
RadioGroup.Items.Delete(2)
Potřebujete-li v seznamu vyhledat index tlačítka se zadaným popisem, použijte funkci
IndexOf:
Jazyk KLONDAIK:
ShowMessage(RadioGroup.Items.IndexOf('Tisknout'));
Jazyk BONANZA:
ShowMessage(RadioGroup.Items.IndexOf("Tisknout"))
Obsah seznamu tlačítek můžete uložit na disk do textového souboru metodou SaveToFile,
případně načít textový soubor do seznamu metodou LoadFromFile:
Jazyk KLONDAIK:
RadioGroup.Items.SaveToFile('seznam.txt');
RadioGroup.Items.LoadFromFile('seznam.txt');
Jazyk BONANZA:
RadioGroup.Items.SaveToFile("seznam.txt")
RadioGroup.Items.LoadFromFile("seznam.txt")
Potřebujete-li projít celý seznam tlačítek a provést s každým z nich nějakou akci, použijte
vlastnosti Items.Count. Musíte přitom počítat s tím, že se seznam čísluje od nuly, počet položek
seznamu je však uváděn od jedničky. Od celkového počtu položek v seznamu musíte proto v
cyklu jedničku odečíst:
Jazyk KLONDAIK:
for x := 0 to RadioGroup.Items.Count-1 do
Memo.Lines.Add(RadioGroup.Items[x]);
Jazyk BONANZA:
For x = 0 to RadioGroup.Items.Count-1
Memo.Lines.Add(RadioGroup.Items(x))
Next
Komponenta obsahuje pouze události reagující na zaměření objektu, ztrátu zaměření a samozřejmě také kliknutí na tlačítko. Pro zjištění, které tlačítko bylo nastaveno, použijte vlastnost ItemIndex.