Komponenta FileListBox


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.


OZOGAN, 1 Máje 97, 460 01 Liberec
tel.,fax: (048) 52 28 338, e-mail: info@ozogan.cz