FileDialog Interface

Definição

Namespace:
Microsoft.Office.Core
Assembly:
office.dll

Fornece funcionalidade de caixa de diálogo de arquivo parecida com a das caixas de diálogo padrão Abrir e Salvar encontradas nos aplicativos do Microsoft Office.

public interface class FileDialog : Microsoft::Office::Core::_IMsoDispObj
[System.Runtime.InteropServices.Guid("000C0362-0000-0000-C000-000000000046")]
public interface FileDialog : Microsoft.Office.Core._IMsoDispObj
[<System.Runtime.InteropServices.Guid("000C0362-0000-0000-C000-000000000046")>]
type FileDialog = interface
    interface _IMsoDispObj
Public Interface FileDialog
Implements _IMsoDispObj
Atributos
GuidAttribute
Implementações
_IMsoDispObj

Comentários

Com as caixas de diálogo que esse objeto fornece, os usuários de suas soluções podem especificar facilmente os arquivos e pastas que sua solução deve usar.

Use a propriedade FileDialog para retornar um objeto FileDialog. A propriedade FileDialog está localizada no objeto de aplicativo de cada aplicativo individual do Office. A propriedade usa um único argumento, DialogType, que determina o tipo de objeto FileDialog que a propriedade retorna. Há quatro tipos de objetos FileDialog :

  • Abrir caixa de diálogo - Permite que os usuários selecionem um ou mais arquivos que você pode abrir no aplicativo host usando o método Execute .

  • Caixa de diálogo SalvarComo - Permite que os usuários selecionem um único arquivo que você pode salvar o arquivo atual usando o método Execute .

  • Caixa de diálogo Seletor de Arquivos - Permite que os usuários selecionem um ou mais arquivos. Os caminhos de arquivo que o usuário seleciona são capturados FileDialogSelectedItems na coleção.

  • Caixa de diálogo Seletor de Pasta - Permite que os usuários selecionem um caminho. O caminho em que o usuário seleciona é capturado na coleção FileDialogSelectedItems.

Cada aplicativo host só pode instanciar uma única instância do objeto FileDialog . Portanto, muitas das propriedades do objeto FileDialog persistem mesmo quando você criar vários objetos FileDialog. Portanto, certifique-se de definir todas as propriedades adequadamente para sua finalidade antes de exibir a caixa de diálogo.

Para exibir uma caixa de diálogo de arquivo usando o objeto FileDialog , você deve usar o Show() método. Depois que uma caixa de diálogo for exibida, nenhum código será executado até que o usuário a descarte.

Propriedades

Nome Description
AllowMultiSelect

Determina se o usuário tem permissão para selecionar vários arquivos de uma caixa de diálogo de arquivo.
Application

Retorna um objeto Application que representa o aplicativo contêiner para o objeto.
ButtonName

Retorna ou define uma String que representa o texto exibido no botão de ação de uma caixa de diálogo de arquivo.
Creator

Retorna um inteiro de 32 bits que indica o aplicativo no qual o objeto especificado foi criado.
DialogType

Retorna uma MsoFileDialogType constante que representa o tipo de caixa de diálogo de arquivo que o FileDialog objeto está definido para exibir.
FilterIndex

Retorna ou define um Integer indicando o filtro de arquivo padrão de uma caixa de diálogo de arquivo.
Filters

Retorna uma FileDialogFilters coleção.
InitialFileName

Retorna ou define uma String que representa o caminho e/ou o nome do arquivo que é exibido inicialmente em uma caixa de diálogo de arquivo.
InitialView

Retorna ou define uma MsoFileDialogView constante que representa a apresentação inicial de arquivos e pastas em uma caixa de diálogo de arquivo.
Item

Retorna o texto associado a um objeto.
Parent

Retorna o objeto pai para o objeto especificado.
SelectedItems

Retorna uma FileDialogSelectedItems coleção.
Title

Retorna ou define o título de uma caixa de diálogo de arquivo exibida usando o FileDialog objeto.

Métodos

Nome Description
Execute()

Executa o procedimento ou o comando interno atribuído ao controle de barra de comandos especificado.
Show()

Exibe uma caixa de diálogo de arquivo e retorna um Integer indicando se o usuário pressionou o botão de ação (-1) ou o botão cancelar (0).

Aplica-se a