Přehled vlastností, metod a událostí objektu:
--------------------------------------------------------------
Count (R)
--------------------------------------------------------------
Add Delete Exchange
IndexOf Insert LoadFromFile
Move SaveToFile
--------------------------------------------------------------
Legenda: * -> pouze z programu, R -> lze číst, W -> lze zadat
Jedna z mála komponent, která není umístěna na paletě komponent, přesto má však velký význam. Nepoužívá se nikdy přímo, je však obsažena v dalších komponentách jako jedna z vlastností. Jedná se například o vlastnost Lines u komponent Memo, DataMemo a RichEdit, vlastnost Items u komponent ComboBox, ListBox, CheckListBox a RadioGroup nebo vlastnost Tabs u vlastnosti TabControl.
Ke komponentě se z programu přistupuje vždy přes jméno rodičovského (nadřazeného)
objektu na formuláři, které se uvádí vždy včetně vlastnosti nebo metody typu StrArray. Objekty
jsou přitom odděleny tečkou. Pro přidání nového řetězce do textu komponenty Memo (vlastnost
Lines) se proto při použití metody Add použije následující zápis:
Jazyk KLONDAIK:
Memo.Lines.Add('aaa');
Jazyk BONANZA:
Memo.Lines.Add("aaa")
Vnitřně je možné si komponentu typu StrArray představit jako seskupení samostatných
řetězců, které jsou z programu přístupné svým indexem, to je pořadovým číslem řetězce.
Indexy jsou číslovány od nuly. První řetězec v seznamu má proto index nula, pátý řetězec má
index 4. Pokud potřebujete zjistit obsah řetězce, musíte zadat jeho pořadový index, který se
zadává v hranatých závorkách. Obsah prvního řádku textu komponenty Memo proto zobrazíte:
Jazyk KLONDAIK:
ShowMessage(Memo.Lines[0]);
Jazyk BONANZA:
ShowMessage(Memo.Lines(0))
Podobným způsobem můžete změnit obsah řetězce, kdy opět zadáváte přístupový index a
nový obsah. Pro druhý řádek textu komponenty Memo proto zadáte:
Jazyk KLONDAIK:
Memo.Lines[1]:='druhý řádek';
Jazyk BONANZA:
Memo.Lines(1) = "druhý řádek"
Novou položku zadáte do seznamu řetězců z programu použitím metody Add následujícím
způsobem:
Jazyk KLONDAIK:
Memo.Lines.Add('aaa');
Jazyk BONANZA:
Memo.Lines.Add("aaa")
Pokud potřebujete zrušit některou položku ze seznamu řetězců, použijte volání metody
Delete následujícím způsobem:
Jazyk KLONDAIK:
Memo.Lines.Delete(2);
Jazyk BONANZA:
Memo.Lines.Delete(2)
Potřebujete-li v seznamu řetězců vyhledat index položky se známým obsahem, použijte
funkci IndexOf následujícím způsobem:
Jazyk KLONDAIK:
ShowMessage(Memo.Lines.IndexOf('aaa'));
Jazyk BONANZA:
ShowMessage(Memo.Lines.IndexOf("aaa"))
Seznamu řetězců můžete uložit na disk do textového souboru metodou SaveToFile, případně
načít textový soubor do seznamu řetězců metodou LoadFromFile:
Jazyk KLONDAIK:
Memo.Lines.SaveToFile('seznam.txt');
Memo.Lines.LoadFromFile('seznam.txt');
Jazyk BONANZA:
Memo.Lines.SaveToFile("seznam.txt")
Memo.Lines.LoadFromFile("seznam.txt")
Potřebujete-li projít celý seznam řetězců a provést s každou položkou seznamu nějakou akci,
použijte vlastnosti Count. Musíte přitom počítat s tím, že se položky seznamu číslují od nuly,
počet položek seznamu je však uváděn od jedničky. Od počtu položek řetězců musíte proto v
cyklu jedničku odečíst:
Jazyk KLONDAIK:
for x:= 0 to Memo.Lines.Count-1 do
Memo.Lines[x] := CsWinToLat(Memo.Lines[x]);
Jazyk BONANZA:
For x = 0 to Memo.Lines.Count-1
Memo.Lines(x) = CsWinToLat(Memo.Lines(x))
Next
Konkrétní příklady použití jsou uvedeny vždy u popisu vlastnosti, která je typu StrArray.