Přehled vlastností, metod a událostí objektu:
--------------------------------------------------------------
Align (RW) Color (RW) Ctl3D (RW)
Cursor (RW) Directory (*RW) Drive (*RW)
Enabled (RW) ExtendedSelect (RW) FileEdit (RW)
FileName (*RW) FileType Font (RW)
Height (RW) HelpContext (RW) Hint (RW)
IntegralHeight (RW) ItemHeight (RW) ItemIndex (*RW)
Items (*RW) Left (RW) Mask (RW)
MultiSelect (RW) Name (R) ParentColor (RW)
ParentCtl3D (RW) ParentFont (RW) ParentShowHint (RW)
PopupMenu (RW) Selected (*RW) ShowGlyphs (RW)
ShowHint (RW) TabOrder (RW) TabStop (RW)
Tag (RW) Top (RW) Visible (RW)
Width (RW)
--------------------------------------------------------------
ApplyFilePath Clear SetFocus
Update
--------------------------------------------------------------
OnChange OnClick OnDblClick
OnEnter OnExit OnKeyDown
OnKeyPress OnKeyUp OnMouseDown
OnMouseMove OnMouseUp
--------------------------------------------------------------
Legenda: * -> pouze z programu, R -> lze číst, W -> lze zadat
Komponenta FileListBox slouží pro zobrazování seznamu souborů obsažených v zadaném adresáři. Konkrétní adresář je zadán ve vlastnostech Drive a Directory .
Seznam souborů je přístupný pouze z programu a 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ů. POZOR !!! U objektu typu FileListBox lze však použít pouze vlastnost Count a metodu SaveToFile.
Jednotlivé položky jsou v seznamu řetězců přístupné svým indexem, to je pořadovým číslem.
Položky 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:
Jazyk KLONDAIK:
ShowMessage(FileListBox.Items[0]);
Jazyk BONANZA:
ShowMessage(FileListBox.Items(0))
Obsah seznamu můžete uložit na disk do textového souboru:
Jazyk KLONDAIK:
FileListBox.Items.SaveToFile('seznam.txt');
Jazyk BONANZA:
FileListBox.Items.SaveToFile("seznam.txt")
Potřebujete-li projít celý seznam a provést s každou položkou seznamu nějakou akci, použijte
vlastnost 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 seznamu musíte proto v cyklu jedničku odečíst:
Jazyk KLONDAIK:
for x:= 0 to FileListBox.Items.Count-1 do
Memo.Lines.Add(FileListBox.Items[x]);
Jazyk BONANZA:
For x = 0 to FileListBox.Items.Count-1
Memo1.Lines.Add(FileListBox.Items(x))
Next
Jak již bylo uvedeno, slouží komponenta FileListBox pro uživatelský výběr souboru z adresáře. Možnost výběru pouze jednoho souboru, případně většího počtu souborů se zadává ve vlastnosti MultiSelect. Podle nastavení vlastnosti ExtendedSelect lze provádět buď nezávislý výběr souborů, případně sekvenční výběr souborů dle rozsahu od až do.
Máte-li nastavenu možnost vícenásobného výběru ve vlastnosti MultiSelect, máte možnost z
programu pomocí vlastnosti Selected kontrolovat, zda je určitý soubor z adresáře vybrán:
Jazyk KLONDAIK:
if FileListBox.Selected[1] then
Memo.Lines.Add(FileListBox.Items[1]);
Jazyk BONANZA:
If FileListBox.Selected(1) then
Memo.Lines.Add(FileListBox.Items(1))
End If
Komponenta obsahuje metodu Clear, kterou se provede výmaz obsahu seznamu souborů. Metoda Update aktualizuje seznam souborů, například při výmazu obsaženého souboru. Pro nové načtení obsahu adresáře se změnou disku, adresáře a vyhledávací masky lze použít vlastnost ApplyFilePath.