CoolBasic SDK

FileDialog

Include "cbAPI.cb"

KUVAUS
Tuo ruudulle tiedoston avaus- tai talletusdialogin.

Paluuarvo:
IDOK jos dialog suljettiin Ok-painikkeella.
IDCANCEL jos dialog suljettiin muulla kuin Ok-painikkeella.

KÄYTTÖ
FileDialog(dialogType, defaultExt$, fileName$, filter$)
dialogType - Dialogin tyyppi.
OPEN_FILE_DLG = Tiedoston avausdialogi.
SAVE_FILE_DLG = Tiedoston talletusdialogi.

defaultExt - Tiedostotarkenteen oletusarvo.
Tämä lisätään automaattisesti tiedostonimen loppuun mikäli vain tiedostonimen alkuosa on syötetty.

fileName - Tiedostonimi joka tulee oletuksena dialogin "Tiedostonimi:"-kenttään.

filter - Tiedostojen suodatin.
Tällä tiedolla voidaan määritellä dialogiin näkyväksi vain tietyn tyyppiset tiedostot.
Suodatinelementti koostuu selitteestä ja itse suodattimesta. Tiedot erotellaan toisistaan |-merkillä (pystyviiva/putki).
Eri suodatinelementtejä voi koota peräkkäin.
|-merkki tulee myös jokaisen suodatinelementin loppuun.
Suodatinelementit näkyvät dialogissa "Tiedoston tyyppi"-pudotusvalikossa.
Esimerkkejä:
"All Files|*.*|"
Dialogi tarjoaa valittavaksi kaikentyyppiset tiedostot.

"BMP Files|*.bmp|PNG Files|*.png|All Files|*.*|"
Dialogi tarjoaa valittavaksi erikseen bmp- ja png-tiedostot sekä lisäksi kaikki tiedostot.

"Image Files|*.bmp;*.png|All Files|*.*|"
Dialogi tarjoaa valittavaksi samanaikaisesti sekä bmp- että png-tiedostot sekä lisäksi eri valinnalla kaikki tiedostot.

Katso myös: FileDialogData

ESIMERKKI
If FileDialog(OPEN_FILE_DLG, "bmp", "", "Image Files|*.bmp;*.jpg;*.png;*.tga|") = IDOK Then
    img = LoadImage(FileDialogData(FD_FULLNAME))
EndIf