Dialog.OpenFile (gb.form.dialog)

Static Function OpenFile ( [ Multi As Boolean ] ) As Boolean

Chama o dialog padrão de arquivo para obter o nome de um arquivo para abrir.

  • Se Multi é FALSE (o padrão), então, o usuário pode selecionar apenas um arquivo, e o caminho do arquivo selecionado é retornado na propriedade Path.

  • Se Multi é TRUE, então, o usuário pode selecionar vários arquivos, e o caminho dos arquivos selecionados é retornado como uma matriz de string na propriedade Paths.

Este método retorna TRUE se o usuário clicar no botão Cancelar, e FALSE se o usuário clicou no botão OK.

Exemplos

Dialog.Title = "Choose a file"
Dialog.Filter = ["*.txt", "Text Files", "*", "All files"]
Dialog.Path = "."
IF Dialog.OpenFile() THEN
  RETURN ' User pressed Cancel -
ENDIF

Este exemplo mostra como você pode selecionar vários arquivos com o diálogo OpenFile. Como o Dialog.Path foi definido, quando o aplicativo é iniciado pela primeira vez, e a caixa de diálogo for aberta, ela vai mostrar o diretório home do usuário.

PUBLIC SUB Form_Open()
  Dialog.Path = User.Home
END

PUBLIC SUB ButtonOpenMultiple_Click()
  DIM imageFile AS String
  Dialog.Filter = ["*.png", "Portable Network Graphics"]
  IF Dialog.OpenFile(TRUE) THEN RETURN
  FOR EACH imageFile IN Dialog.Paths
    PRINT imageFile
  NEXT
CATCH
  Message.Info(Error.Text)
END