ScriptForge.FileSystem zerbitzua

FileSystem zerbitzuak fitxategiak eta karpetak maneiatzeko errutinak ditu. Ondoren, zerbitzu honek eskaintzen dituen zenbait eginbide erakusten dira:

note

FileSystem zerbitzuko metodoak XSimpleFileAccess UNO interfazean daude oinarrituta batez ere.


Definizioak

Beheko taulak FileSystem zerbitzuan erabilitako metodo gehienen parametro nagusiak zerrendatzen ditu.

Parametroa

Deskribapena

FileName

Fitxategiaren izen osoa, bide-izena barne, amaieran bide-izenen bereizlerik gabe.

FolderName

Bide-izena duen karpetaren izen osoa. Bide-izenen amaierako bereizlea eduki dezake edo ez.

Name

Karpeta-izenaren edo fitxategi-izenaren azken osagaia, luzapena barne. Parametro hau sistema eragilearen jatorrizko formatua erabilita adierazten da beti.

BaseName

Karpeta-izenaren edo fitxategi-izenaren azken osagaia, luzapena kenduta.

NamePattern

Goiko izenetako edozein, azken osagaian komodinak sartuta. Onartutako komodinak honakoak dira:

  • "?" ikurrak edozein karaktere bakun adierazten du

  • "*" ikurrak zero, bat edo zenbait karaktere adierazten ditu


tip

FileSystem zerbitzua erabilita, fitxategi anitzen gaineko eragiketak aldi berean gauzatzea ahalbidetzen du. Izen-ereduak erabilita, erabiltzaile-scriptek fitxategi anitz kopiatu, lekuz aldatu edo ezabatu ditzakete. Basic-en metodo integratuek, berriz, fitxategi bakarrak soilik maneiatu ditzakete.


Fitxategi-izenen notazioa

Fitxategien eta karpeten izenak, bai argumentuetan bai itzulitako balioetan, adierazteko notazioa, FileSystem zerbitzuaren FileNaming propietateak definitutakoa da.

Laburbilduta, balizko irudikapen motak "URL" (URL fitxategi-notazioa), "SYS" (sistema eragilearen notazioa) eta "ANY" (lehenetsia) dira. Ikusi informazio gehiago behean.

tip

URL notazioaren adibide bat file:///C:/Dokumentuak/nire_fitxategia.odt izan daiteke. Posible bada, erabili URL notazioa, aukera eramangarriagoa baita.


warning

The use of the shortcut "~" (tilde), which is common in Linux-based operating systems, is not supported to express a path to a folder and file name. Instead of using "~/Documents/my_file.odt" use the full path "/home/user/Documents/my_file.odt".


Zerbitzuari deitzea

Hurrengo kode-zatiak FileSystem zerbitzuari deitzen dio. BuildPath metodoa adibide modura erabili da.

Basic lengoaian

      GlobalScope.BasicLibraries.LoadLibrary("ScriptForge")
      Dim FSO As Object
      Set FSO = CreateScriptService("FileSystem")
      FSO.BuildPath(...)
    
Python lengoaian

      from scriptforge import CreateScriptService
      fso = CreateScriptService("FileSystem")
      fso.BuildPath(...)
    

Propietateak

Izena

Irakurtzeko soilik

Mota

Deskribapena

FileNaming

Ez

String

Fitxategien eta karpeten uneko notazioa, "ANY", "URL" edo "SYS", ezartzen edo itzultzen du:

  • "ANY": (lehenetsia) FileSystem zerbitzuaren metodoek URLen zein uneko sistema eragilearen notazioa onartzen du sarrerako argumentuetan, baina beti URL kateak itzultzen ditu.

  • "URL": FileSystem zerbitzuaren metodoek URL notazioa espero dute sarrerako argumentuetan, eta URL kateak itzultzen dituzte.

  • "SYS": FileSystem zerbitzuaren metodoek uneko sistema eragilearen notazioa espero dute bai sarrerako argumentuetan bai itzulitako kateetan.

Ezarri ondoren, FileNaming propietatea ez da aldatuko LibreOffice saioa amaitu arte edo berriro ezartzen den arte.

ConfigFolder

Bai

String

LibreOffice aplikazioaren konfigurazio-karpeta itzultzen du.

ExtensionsFolder

Bai

String

Hedapenak instalatuta dauden karpeta itzultzen du.

HomeFolder

Bai

String

Erabiltzailearen karpeta nagusia itzultzen du.

InstallFolder

Bai

String

LibreOffice aplikazioaren instalazio-karpeta itzultzen du.

TemplatesFolder

Bai

String

Sistemaren txantiloi-fitxategiak dituen karpeta itzultzen du.

TemporaryFolder

Bai

String

LibreOffice bide-izenen ezarpenetan aldi baterako fitxategietarako definitu den karpeta itzultzen du.

UserTemplatesFolder

Bai

String

Erabiltzaileak definitutako txantiloi-fitxategiak dituen karpeta itzultzen du.


FileSystem zerbitzuaren metodoen zerrenda

BuildPath
CompareFiles
CopyFile
CopyFolder
CreateFolder
CreateTextFile
DeleteFile
DeleteFolder
FileExists

Files
FolderExists
GetBaseName
GetExtension
GetFileLen
GetFileModified
GetName
GetParentFolderName

GetTempName
HashFile
MoveFile
MoveFolder
OpenTextFile
PickFile
PickFolder
SubFolders


BuildPath

Karpeta baten bide-izena eta fitxategi baten izena elkartzen ditu eta fitxategi-izen osoa itzultzen du baliozko bereizle batekin. Bide-izenaren bereizlea beharrezkoa bada soilik gehituko da.

Sintaxia:

svc.BuildPath(foldername: str, name: str): str

Parametroak:

foldername: The path with which name will be combined. The specified path does not need to be an existing folder.

name: The name of the file to be appended to foldername. This parameter uses the notation of the current operating system.

Adibidea:

Basic lengoaian

      Dim FSO as Object
      Set FSO = CreateScriptService("FileSystem")
      Dim aFileName as String
      FSO.FileNaming = "URL"
      aFileName = FSO.BuildPath("file:///home/user", "sample file.odt")
      ' file:///home/user/sample%20file.odt
    
Python lengoaian

      fso = CreateScriptService("FileSystem")
      fso.FileNaming = "URL"
      aFileName = fso.BuildPath("file:///home/user", "sample file.odt")
      # file:///home/user/sample%20file.odt
    

CompareFiles

Bi fitxategi konparatzen ditu eta True itzultzen du berdinak badirudite.

Depending on the value of the comparecontents argument, the comparison between both files can be either based only on file attributes (such as the last modified date), or based on the file contents.

Sintaxia:

svc.CompareFiles(filename1: str, filename2: str, comparecontents: bool = False): bool

Parametroak:

filename1, filename2: The files to compare.

comparecontents: When True, the contents of the files are compared (default = False).

Adibidea:

Basic lengoaian

      FSO.FileNaming = "SYS"
      If FSO.CompareFiles("C:\myFile1.txt", "C:\myFile2.txt", CompareContents := False) Then
          ' ...
      End If
    
Python lengoaian

      fso.FileNaming = "SYS"
      if fso.CompareFiles(r"C:\myFile1.txt", r"C:\myFile2.txt", comparecontents = False):
          # ...
    

CopyFile

Fitxategi bat edo batzuk kokaleku batetik beste batera kopiatzen ditu. True itzultzen du gutxienez fitxategi bat kopiatu bada, eta False errore bat gertatu bada.

An error will also occur if the source parameter uses wildcard characters and does not match any files.

Metodoa berehala geldituko da errore bat aurkitu ondoren. Metodoak ez ditu atzera botatzen edo desegiten errorea gertatu baino lehenagoko aldaketak.

Sintaxia:

svc.CopyFile(source: str, destination: str, overwrite: bool = True): bool

Parametroak:

source: It can be a FileName or a NamePattern indicating one or more files to be copied.

destination: It can be either a FileName specifying where the single source file is to be copied, or a FolderName into which the multiple files from source are to be copied.

overwrite: If True (default), files may be overwritten. The method will fail if destination is readonly, regardless of the value specified in overwrite.

Adibidea:

In the examples below the first line copies a single file whereas the second line copies multiple files using wildcards.

Basic lengoaian

      FSO.CopyFile("C:\Documents\my_file.odt", "C:\Temp\copied_file.odt")
      FSO.CopyFile("C:\Documents\*.*", "C:\Temp\", Overwrite := False)
    
Python lengoaian

      fso.CopyFile(r"C:\Documents\my_file.odt", r"C:\Temp\copied_file.odt")
      fso.CopyFile(r"C:\Documents\*.*", r"C:\Temp", overwrite = False)
    
note

Beware that subfolders and their contents are not copied when wildcards are used in the source argument.


CopyFolder

Karpeta bat edo gehiago kopiatzen du kokaleku batetik beste batera. True itzultzen du karpeta bat gutxienez kopiatu bada, eta False errore bat gertatu bada.

An error will also occur if the source parameter uses wildcard characters and does not match any folders.

Metodoa berehala geldituko da errore bat aurkitu ondoren. Metodoak ez ditu errorea gertatu baino lehen izandako aldaketak desegingo.

Sintaxia:

svc.CopyFolder(source: str, destination: str, overwrite: bool = True): bool

Parametroak:

source: It can be a FolderName or a NamePattern indicating one or more folders to be copied.

destination: Specifies the FolderName into which the single or multiple folders defined in source are to be copied.

overwrite: If True (default), files may be overwritten. The method will fail if destination is readonly, regardless of the value specified in overwrite.

Adibidea:

In the examples below all files, folders and subfolders are copied.


      ' Basic
      FSO.CopyFolder("C:\Documents\*", "C:\Temp\", Overwrite := False)
    

      # Python
      fso.CopyFolder(r"C:\Documents\*", r"C:\Temp", overwrite = False)
    

CreateFolder

Zehaztutako FolderName sortzen du. True itzultzen du karpeta ongi sortu bada.

Zehaztutako karpetak lehendik ez dagoen karpeta guraso bat badu, sortu egingo da.

Sintaxia:

svc.CreateFolder(foldername: str): bool

Parametroak:

foldername: A string representing the folder to be created. If the folder already exists, an exception will be raised.

Adibidea:


      ' Basic
      FSO.CreateFolder("C:\NewFolder")
    

      # Python
      fso.CreateFolder(r"C:\NewFolder")
    

CreateTextFile

Creates a specified file and returns a TextStream service instance that can be used to write to the file.

Metodoak Null objektu bat itzuliko du errore bat gertatzen bada.

Sintaxia:

svc.CreateTextFile(filename: str, overwrite: bool = True, encoding: str = 'UTF-8'): svc

Parametroak:

filename: The name of the file to be created.

overwrite: Boolean value that determines if filename can be overwritten (default = True).

encoding: The character set to be used. The default encoding is "UTF-8".

Adibidea:

Basic lengoaian

      Dim myFile As Object
      FSO.FileNaming = "SYS"
      Set myFile = FSO.CreateTextFile("C:\Temp\ThisFile.txt", Overwrite := True)
    
Python lengoaian

      fso.FileNaming = "SYS"
      myFile = fso.CreateTextFile(r"C:\Temp\ThisFile.txt", overwrite = True)
    
note

Karaktere-jokoen izenei buruz gehiago jakiteko, begiratu IANAk karaktere-jokoei buruz duen orria. Kontuan izan LibreOffice aplikazioak ez dituela dauden karaktere-joko guztiak inplementatu.


DeleteFile

Fitxategi bat edo batzuk ezabatzen ditu. True itzultzen du gutxienez fitxategi bat ezabatu bada, edo False errore bat gertatu bada.

An error will also occur if the filename parameter uses wildcard characters and does not match any files.

Ezabatuko diren fitxategiek ez dute irakurtzeko soilik izan behar.

Metodoa berehala geldituko da errore bat aurkitu ondoren. Metodoak ez ditu errorea gertatu baino lehen izandako aldaketak desegingo.

Sintaxia:

svc.DeleteFile(filename: str): bool

Parametroak:

filename: It can be a FileName or a NamePattern indicating one or more files to be deleted.

Adibidea:

In the examples below only files are deleted, subfolders are not deleted.


      ' Basic
      FSO.DeleteFile("C:\Temp\*.docx")
    

      # Python
      fso.DeleteFile(r"C:\Temp\*.docx")
    

DeleteFolder

Karpeta bat edo batzuk ezabatzen ditu. True itzultzen du gutxienez karpeta bat ezabatu bada, eta False errore bat gertatu bada.

An error will also occur if the foldername parameter uses wildcard characters and does not match any folders.

Ezabatuko diren karpetek ez dute irakurtzeko soilik izan behar.

Metodoa berehala geldituko da errore bat aurkitu ondoren. Metodoak ez ditu errorea gertatu baino lehen izandako aldaketak desegingo.

Sintaxia:

svc.DeleteFolder(foldername: str): bool

Parametroak:

foldername: It can be a FolderName or a NamePattern indicating one or more folders to be deleted.

Adibidea:

In the examples below only folders and their contents are deleted. Files in the parent folder "C:\Temp" are not deleted.


      ' Basic
      FSO.DeleteFolder("C:\Temp\*")
    

      # Python
      fso.DeleteFolder(r"C:\Temp\*")
    

FileExists

True itzultzen du emandako fitxategi-izen bat baliozkoa bada eta existitzen bada, bestela metodoak False itzultzen du.

If the filename parameter is actually an existing folder name, the method returns False.

Sintaxia:

svc.FileExists(filename: str): bool

Parametroak:

filename: A string representing the file to be tested.

Adibidea:

Basic lengoaian

      FSO.FileNaming = "SYS"
      If FSO.FileExists("C:\Documents\my_file.odt") Then
          '...
      End If
    
Python lengoaian

      fso.FileNaming = "SYS"
      if fso.FileExists(r"C:\Documents\my_file.odt"):
          # ...
    

Files

Zeron oinarritutako matrize bat itzultzen du emandako karpeta batean biltegiratutako fitxategi guztiekin. Matrizeko sarrera bakoitza bide-izen osoa eta fitxategi-izena duen kate bat da.

If the argument foldername specifies a folder that does not exist, an exception is raised.

Emaitza gisa sortutako zerrenda komodinen bidez iragazi daiteke.

Sintaxia:

svc.Files(foldername: str, filter: str = ''): str[0..*]

Parametroak:

foldername: A string representing a folder. The folder must exist. This argument must not designate a file.

filter: A string containing wildcards ("?" and "*") that will be applied to the resulting list of files (default = "").

Adibidea:

Basic lengoaian

      Dim filesList As Variant, file As String
      FSO.FileNaming = "SYS"
      filesList = FSO.Files("/home/user/", "*.txt")
      For Each file In filesList
          ' ...
      Next file
    
Python lengoaian

      fso.FileNaming = "SYS"
      filesList = fso.Files("/home/user/", "*.txt")
      for file in fileList:
          # ...
    

FolderExists

True itzultzen du zehaztutako FolderName baliozkoa bada eta existitzen bada, bestela metodoak False itzultzen du.

If the foldername parameter is actually an existing file name, the method returns False.

Sintaxia:

svc.FolderExists(foldername: str): bool

Parametroak:

foldername: A string representing the folder to be tested.

Adibidea:

Basic lengoaian

      FSO.FileNaming = "SYS"
      If FSO.FolderExists("C:\Documents\Thesis") Then
          '...
      End If
    
Python lengoaian

      fso.FileNaming = "SYS"
      if fso.FolderExists(r"C:\Documents\Thesis")
          # ...
    

GetBaseName

Karpeta- edo fitxategi-izen baten BaseName parametroa (azken osagaiaren berdina) itzultzen du, luzapenik gabe.

Metodoak ez du egiaztatzen zehaztutako fitxategia edo karpeta badagoen.

Sintaxia:

svc.GetBaseName(filename: str): str

Parametroak:

filename: A string representing the file name and its path.

Adibidea:

In the examples below, the first GetBaseName method call corresponds to a folder, so the function returns the last component of the path. The second call receives a file name as input, so the name of the file is returned without its extension.

Basic lengoaian

      MsgBox FSO.GetBaseName("/home/user/Documents") ' "Documents"
      MsgBox FSO.GetBaseName("/home/user/Documents/my_file.ods") ' "my_file"
    
Python lengoaian

      bas = CreateScriptService("Basic")
      bas.MsgBox(fso.GetBaseName("/home/user/Documents")) # "Documents"
      bas.MsgBox(fso.GetBaseName("/home/user/Documents/my_file.ods")) # "my_file"
    

GetExtension

Fitxategi edo karpeta baten izenaren luzapena itzultzen du puntuaren "." karaktererik gabe.

Metodoak ez du egiaztatzen zehaztutako fitxategia edo karpeta badagoen.

Metodo hau karpeta-izen bati edo luzapenik gabeko fitxategi bati aplikatzen bazaio, kate huts bat itzuliko da.

Sintaxia:

svc.GetExtension(filename: str): str

Parametroak:

filename: A string representing the file name and its path.

Adibidea:


      ' Basic
      ext = FSO.GetExtension("C:\Windows\Notepad.exe")  ' "exe"
    

      # Python
      ext = fso.GetExtension(r"C:\Windows\Notepad.exe")  # "exe"
    

GetFileLen

FileLen Basic funtzio integratuaren xedea fitxategi batek duen byte kopurua itzultzea da Long balio gisa, 2GB arte.

GetFileLen metodoak tamaina askoz handiagoko fitxategiak maneiatu ditzake, horretarako Currency balio bat itzultzen du.

Sintaxia:

svc.GetFileLen(filename: str): num

Parametroak:

filename: A string representing an existing file.

Adibidea:

Basic lengoaian

      Dim fLen As Currency
      FSO.FileNaming = "SYS"
      fLen = FSO.GetFileLen("C:\pagefile.sys")
    
Python lengoaian

      fso.FileNaming = "SYS"
      fLen = fso.GetFileLen(r"C:\pagefile.sys")
    

GetFileModified

Emandako fitxategi bat azken aldian aldatu den data itzultzen du.

Sintaxia:

svc.GetFileModified(filename: str): datetime

Parametroak:

filename: A string representing an existing file.

Adibidea:

Basic lengoaian

      Dim aDate As Date
      FSO.FileNaming = "SYS"
      aDate = FSO.GetFileModified("C:\Documents\my_file.odt")
    
Python lengoaian

      fso.FileNaming = "SYS"
      aDate = FSO.GetFileModified(r"C:\Documents\my_file.odt")
    

GetName

Fitxategi edo karpeta-izen baten azken osagaia itzultzen du sistema eragilearen jatorrizko formatuan.

Metodo honek ez du egiaztatzen zehaztutako fitxategia edo karpeta badagoen ala ez.

Sintaxia:

svc.GetName(filename: str): str

Parametroak:

filename: A string representing the file name and its path.

Adibidea:


      ' Basic
      a = FSO.GetName("C:\Windows\Notepad.exe")  ' Notepad.exe
    

      # Python
      a = fso.GetName(r"C:\Windows\Notepad.exe")  # Notepad.exe
    

GetParentFolderName

Zehaztutako fitxategi edo karpeta-izen baten karpeta gurasoaren izena duen kate bat itzultzen du.

Metodo honek ez du egiaztatzen zehaztutako fitxategia edo karpeta badagoen ala ez.

Sintaxia:

svc.GetParentFolderName(filename: str): str

Parametroak:

filename: A string with the file or folder name to be analyzed.

Adibidea:


      ' Basic
      a = FSO.GetParentFolderName("C:\Windows\Notepad.exe")  ' C:\Windows\
    

      # Python
      a = fso.GetParentFolderName(r"C:\Windows\Notepad.exe")  # C:\Windows\
    

GetTempName

Ausaz sortutako aldi baterako fitxategi-izen bat itzultzen du, aldi baterako fitxategi bat behar duten eragiketak gauzatu ahal izateko.

Itzulitako fitxategi-izenak ez du atzizkirik. Itzulitako katean karpetari dagokion zatia sistemaren aldi baterako karpeta izango da.

Metodoak ez du aldi baterako fitxategia sortzen.

Sintaxia:

svc.GetTempName(): str

Adibidea:

Basic lengoaian

      Dim fName As String
      FSO.FileNaming = "SYS"
      fName = FSO.GetTempName() & ".txt"
      ' "/tmp/SF_574068.txt"
    
Python lengoaian

      fso.FileNaming = "SYS"
      fName = FSO.GetTempName() + ".txt"
      # "/tmp/SF_574068.txt"
    

HashFile

Hash funtzioak hainbat tokitan erabiltzen dira: zifratze-algoritmoetan, sinadura digitaletan, mezuak autentifikatzeko kodeetan, iruzurren detekzioan, hatz-marketan, kontroleko baturetan (mezuen osotasunaren egiaztatzeetan), hash tauletan, pasahitzen biltegietan eta beste hainbatetan.

HashFile metodoak hash funtzio baten emaitza itzultzen du, emandako fitxategi bati aplikatuta eta algoritmo jakin bat erabilita. Itzulitako balioa digitu hamaseitar minuskulez osatutako kate bat da.

Onartutako algoritmoak: MD5, SHA1, SHA224, SHA256, SHA384 eta SHA512.

Sintaxia:

svc.HashFile(filename: str, algorithm: str): str

Parametroak:

filename: A string representing an existing file.

algorithm: One of the supported algorithms.

Adibidea:


      ' Basic
      sHash = FSO.HashFile("C:\pagefile.sys", "MD5")
    

      # Python
      sHash = FSO.HashFile(r"C:\pagefile.sys", "MD5")
    

MoveFile

Fitxategi bat edo gehiago kokaleku batetik beste batera aldatzen du. True itzultzen du gutxienez fitxategi bat lekuz aldatu bada, edo False errore bat gertatu bada.

An error will also occur if the source parameter uses wildcard characters and does not match any files.

Metodoa berehala geldituko da errore bat aurkitu ondoren. Metodoak ez ditu errorea gertatu baino lehen izandako aldaketak desegingo.

Sintaxia:

svc.MoveFile(source: str, destination: str): bool

Parametroak:

source: It can be a FileName or NamePattern to designate one or more files to be moved.

destination: If source is a FileName then this parameter indicates the new path and file name of the moved file.

If the move operation involves multiple files, then destination must be a folder name. If it does not exist, it is created.

If source and destination have the same parent folder, the method will rename the source.

Wildcard characters are not allowed in destination.

Adibidea:

In the following examples only files are moved, subfolders are not.


      ' Basic
      FSO.MoveFile("C:\Temp1\*.*", "C:\Temp2")
    

      # Python
      fso.MoveFile(r"C:\Temp1\*.*", r"C:\Temp2")
    

MoveFolder

Karpeta bat edo batzuk kokaleku batetik beste batera aldatzen du. True itzultzen du karpeta bat gutxienez lekuz aldatu bada edo False errore bat gertatu bada.

An error will also occur if the source parameter uses wildcard characters and does not match any folders.

Metodoa berehala geldituko da errore bat aurkitu ondoren. Metodoak ez ditu errorea gertatu baino lehen izandako aldaketak desegingo.

Sintaxia:

svc.MoveFolder(source: str, destination: str): bool

Parametroak:

source: It can be a FolderName or NamePattern to designate one or more folders to be moved.

destination: If the move operation involves a single folder, then destination is the name and path of the moved folder and it must not exist.

If multiple folders are being moved, then destination designates where the folders in source will be moved into. If destination does not exist, it is created.

Wildcard characters are not allowed in destination.

Adibidea:


      ' Basic
      FSO.MoveFolder("C:\Temp1\*", "C:\Temp2")
    

      # Python
      fso.MoveFolder(r"C:\Temp1\*", r"C:\Temp2")
    

OpenTextFile

Fitxategi bat irekitzen du eta TextStream objektu bat itzultzen du. Objektu hori fitxategian irakurtzeko, idazteko edo eransteko erabili daiteke.

Kontuan izan metodoak ez duela egiaztatzen emandako fitxategia benetan testu-fitxategia den ala ez.

The method returns a Null object (in Basic) or None (in Python) if an error occurred.

Sintaxia:

svc.OpenTextFile(filename: str, iomode: int = 1, create: bool = False, encoding: str = 'UTF-8'): svc

Parametroak:

filename: Identifies the file to open.

iomode: Indicates the input/output mode. It can be one of three constants: svc.ForReading (default), svc.ForWriting, or svc.ForAppending.

create: Boolean value that indicates whether a new file can be created if the specified filename doesn't exist:

encoding: The character set to be used. The default encoding is "UTF-8".

Adibidea:

Basic lengoaian

      Dim myFile As Object
      FSO.FileNaming = "SYS"
      Set myFile = FSO.OpenTextFile("C:\Temp\ThisFile.txt", FSO.ForReading)
      If Not IsNull(myFile) Then
          ' ...
      End If
    
Python lengoaian

      fso.FileNaming = "SYS"
      myFile = fso.OpenTextFile(r"C:\Temp\ThisFile.txt", fso.ForReading)
      if myFile is not None:
          # ...
    

PickFile

Fitxategiak irekitzeko edo gordetzeko elkarrizketa-koadro bat irekitzen du.

SAVE modua ezarrita badago eta aukeratutako fitxategia lehendik badago, abisu-mezu bat bistaratuko da.

Sintaxia:

svc.PickFile(defaultfile: str ='', mode: str = 'OPEN', filter: str = ''): str

Parametroak:

defaultfile: This argument is a string composed of a folder and file name:

mode: A string value that can be either "OPEN" (for input files) or "SAVE" (for output files). The default value is "OPEN".

filter: The extension of the files displayed when the dialog is opened (default = no filter).

Adibidea:

The examples below open a file picker with the "txt" filter applied.


      ' Basic
      aFile = FSO.PickFile("C:\Documents", "OPEN", "txt")
    

      # Python
      aFile = fso.PickFile(r"C:\Documents", "OPEN", "txt")
    

PickFolder

Elkarrizketa-koadro bat irekitzen du karpeta bat hautatzeko.

Sintaxia:

svc.PickFolder(defaultfolder: str = '', freetext: str = ''): str

Parametroak:

defaultfolder: A string containing the folder name that will be displayed when the dialog is opened (default = the last selected folder).

freetext: Text to display in the dialog (default = "").

Adibidea:


      ' Basic
      aFolder = FSO.PickFolder("C:\Documents", "Choose a folder or press Cancel")
    

      # Python
      aFolder = fso.PickFolder(r"C:\Documents", "Choose a folder or press Cancel")
    

SubFolders

Returns a zero-based array of strings corresponding to the folders stored in a given foldername.

Zerrenda komodinekin iragazi daiteke.

Sintaxia:

svc.SubFolders(foldername: str, filter: str = ''): str[0..*]

Parametroak:

foldername: A string representing a folder. The folder must exist. foldername must not designate a file.

filter: A string containing wildcards ("?" and "*") that will be applied to the resulting list of folders (default = "").

Adibidea:

Basic lengoaian

      Dim folderList As Variant, folder As String
      FSO.FileNaming = "SYS"
      folderList = FSO.SubFolders("/home/user/")
      For Each folder In folderList
          ' ...
      Next folder
    
Python lengoaian

      fso.FileNaming = "SYS"
      folderList = fso.SubFolders("/home/user/")
      for folder in folderList:
          # ...
    
warning

Azpimarraren karaktere bat, "_", aurrizki gisa duten ScriptForge Basic errutina edo identifikatzaile guztiak barneko erabilerarako erreserbatuta daude. Ez dira Basic makroetan edo Python scriptetan erabili behar.