ActiveX komponenta PicExplorer je prehliadač obrázkov, resp. súborov vo formáte obrázkov, ktoré je možné zobraziť v ovládacom prvku PictureBox. Užívateľské rozhranie komponenty pripomína Explorer - Prieskumník Windows. Na ľavej strane sa nachádza stromová štruktúra disku a na strane pravej sa zobrazujú obrázky so súborov, ktoré sa nachádzajú vo zvolenej zložke podľa zvoleného filtru. Tento obrázok je možné zobraziť v náhľade, kde je možné zmenšiť alebo zväčšiť náhľad na obrázok. Komponenta obsahuje aj základné funkcie pre prácu so súbormi ako je kopírovanie súborov, odstránenie a premiestnenie. Taktiež si je možné zvoliť masku - filter zobrazovaných súborov s podporovaných formátov súborov. Obrázok ako taký je možné kopírovať do schránky. Pomocou nastavenia vlastností komponenty pred jej samotným zobrazením je možné niektoré z jej funkcií potlačiť a tak zabrániť užívateľovi napr. prácu so súbormi a pod. Návratovými hodnotami je úplná cesta ku súboru zvoleného užívateľom a objekt Picture, ktorý reprezentuje obrázok tohto súboru. Komponenta umožňuje zobraziť nasledovné formáty súborov: bmp, jpg, gif, dib, emf, wmf, cur, ico .
Popis vlastností:
|
vlastnosť |
hodnota |
popis |
|
Zobrazenie |
1 - úplné |
pri spustení prehliadača sa zobrazí so svojimi všetkými :) funkciami - možnosťami práce so súbormi. Tak sa dáva možnosť užívateľovi aj odstrániť, premiestniť alebo prekopírovať súbor s obrázkom |
|
|
2-len_prehliadanie |
Prehliadač sa zobrazí bez ponuky a možností práce so súbormi (kopírovanie, premiestnenie a odstránenie). Týmto sa neumožní užívateľovi priamo zasahovať do súborov, ku ktorým má prístup, aby nedošlo k ich zničeniu a pod. |
|
InitPath |
STRING (reťazec) |
pred spustením prehliadača sa do tejto vlastnosti zapíše hodnota typu String - reťazec, v ktorom sa nachádza cesta ku zložke, ktorá sa zobrazuje pri prvom spustení prehliadača. Ak táto hodnota nebude nastavená (bude NULL alebo prázdny reťazec) tak sa nastaví automaticky hodnota z funkcie CurDir - aktuálna zložka. Po prvom spustení prehliadača sa v stromovej štruktúre zobrazí zložka nastavená v tejto hodnote. Takto môžeme priamo užívateľovi navrhnúť, odkiaľ má začať prehliadanie obrázkov. Napr. je v niektorých prípadoch sem uložiť cestu k zložke "Moje Dokumenty" alebo cestu k pracovnej zložke Vašej aplikácie. |
|
Titulok |
STRING (reťazec) |
do tejto vlastnosti sa zapíše hodnota String - reťazec ako titulok formulára prehliadača. Ak táto nebude správne zadaná (hodnota NULL alebo prázdny reťazec) bude ako východzí titulok okna formulára prehliadača vypísané "Otvoriť obrázok". Sem je možné zadať napr. názov Vašej aplikácie a pod. Toto je v podstate vlastnosť, ktorá je adekvátna vlastnosti Caption. |
|
PicturePath |
STRING (reťazec) |
Toto je vlastnosť len na čítanie, nie je možné do nej ukladať hodnoty. Toto je návratová hodnota z komponenty, kde sa ukladá v dátovom type String - reťazec úplná cesta ku súboru obrázku, ktorý si zvolil - vybral užívateľ. Ak je hodnota prázdny reťazec (""), tak užívateľ pravdepodobne stornoval výber, alebo došlo k vnútornej chybe. |
|
Picture |
PICTURE (obrázok) |
Toto je vlastnosť len na čítanie, nie je možné do nej zapisovať. Vracia hodnotu typu Picture - obrázok, ktorá reprezentuje samotný obrázok súboru, ktorý si užívateľ vybral - zvolil v prehliadači. Ak je hodnota Nothing, došlo zo strany užívateľa k stornovaniu výberu alebo ku vnútornej chybe. Takouto chybou môže byť načítanie súboru s obrázkom, ktorý je poškodený, alebo v inom formáte. |
Popis metód
|
metóda |
argument |
popis |
|
ZobraziťPrehliadač |
nie je |
táto metóda vyvolá okno formulára prehliadača. Pred touto metódou je potrebné nastaviť vlastnosti hore uvedené, ak chcete, aby sa prehliadač zobrazil odlišne od prednastavených hodnôt. |
|
Zavrieť |
nie je |
táto metóda vynúti uzavriete prehliadača. Je možné, že na základe podnetov užívateľa alebo programového kódu bude na mieste zavrieť všetky okná prehliadača a neumožniť tým užívateľovi ďalej pehliadať súbory s obrázkami. Táto situácia môže nastať napr. v prípade, kedy užívateľ začne prehliadať obrázky na miestach, kde nechcete, aby mu to bolo umožnené (napr. CD, server a pod.) alebo po uplynutí určitého časového limitu, kedy je pravdepodobné, že užívateľ zabudol okno zavrieť... Taktiež bude potrebné túto metódu umiestniť do kódu udalosti formulára Unload, pretože som zatiaľ nevyriešil, ako uzavrieť okná formulárov prehliadača pri uzavretí kontainera - formulára, na ktorom bude komponenta umiestnená. Sorry ... |
Popis udalostí
|
udalosť |
argument |
popis |
|
Koniec |
nie je |
táto udalosť nastane pri uzavretí prehliadača bez výberu obrázku - súboru. Táto udalosť nastane v prípade, že užívateľ stornuje výber, alebo sa vynúti uzavriete prehliadača |
|
PathChange |
New_Path as String (reťazec) |
udalosť, ktorá vracia hodnotu typu String - reťazec v premenne New_Path. Táto udalosť nastane, keď užívateľ v okne so stromovou štruktúrou zložiek prejde na inú zložku, napr. bliknutí na konkrétnu zložku alebo rozbalením podzložiek inej zložky. Otvorením - prezeraním zložky pri vyvolaná tejto udalosti sa do premennej New_Path uloží úplná cesta k novootvorenej zložke. Ak ju budete ďalej využívať v porovnávaní s inými hodnotami, doporučujem, aby ste tieto hodnoty zmenili do rovnakého formátu reťazca, napr. všetky písmená zmeniť na malé príkazom Lcase. Túto udalosť môžete využiť k vynútenému uzavretiu prehliadača, ak sa užívateľ dostane na zakázané zložky - miesta (napr. CD, disketová mechanika, "Moje dokumenty" a pod.) |
|
PicSelected |
nie je |
táto udalosť sa vyvolá v prípade, že užívateľ zvolí - vyberie niektorý z obrázkov, resp. súborov. V tom prípade sa cesta k súboru bude nachádzať vo vlastnosti PicturePath a obrázok vo vlastnosti Picture. V prípade, že užívateľ stornuje výber sa táto udalosť nevyvolá, ale sa vyvolá udalosť Koniec. |
Príklady syntaxu:
PicExplorer1.InitPath = " F:\Visual Basic\The
Bozena\Images"
PicExplorer1.Titulok = "Načítať obrázok so súboru ..."
PicExplorer1.Zobrazenie = len_prehliadanie
PicExplorer1.ZobraziťPrehliadač
Private Sub PicExplorer1_PicSelected()
Me.Picture =
PicExplorer1.Picture
Msgbox "Vybral si súbor:" + PicExplorer1.PicturePath
End Sub
Zde si můžete stáhnout rar archív (cca 120 KB), který obsahuje kompletní zdrojové kódy k prvku a demo projekt.
Poznámky: Táto komponenta je FREEWARE. Pri komerčnom použití budem však dotknutý, že chce niekto zarobiť a ja nie :)) To nekladie však prekážku, že finančné, vecné a kvetinové dary môžete zasielať na adresu autora, ktorú Vám zašle po kontaktovaní na e-mail: majoname@stonline.sk. Svoje postrehy, námety a žiadosti vybavuje autor tiež na tejto e-mailovej adrese. Podrobné vysvetlivky sa nachádzajú v samotnom kóde. Zdrojové kódy sú tiež FreeWare a tak ak sa rozhodne využiť túto komponentu vo Vašom projekte, môžete si zmeniť vzhľad a titulky prvkov (napr. počeštenie a pod.)