enumeração _FILEOPENDIALOGOPTIONS (shobjidl_core.h)

  • Artigo

Define o conjunto de opções disponíveis para uma caixa de diálogo Abrir ou Salvar.

Syntax

typedef enum _FILEOPENDIALOGOPTIONS {
  FOS_OVERWRITEPROMPT = 0x2,
  FOS_STRICTFILETYPES = 0x4,
  FOS_NOCHANGEDIR = 0x8,
  FOS_PICKFOLDERS = 0x20,
  FOS_FORCEFILESYSTEM = 0x40,
  FOS_ALLNONSTORAGEITEMS = 0x80,
  FOS_NOVALIDATE = 0x100,
  FOS_ALLOWMULTISELECT = 0x200,
  FOS_PATHMUSTEXIST = 0x800,
  FOS_FILEMUSTEXIST = 0x1000,
  FOS_CREATEPROMPT = 0x2000,
  FOS_SHAREAWARE = 0x4000,
  FOS_NOREADONLYRETURN = 0x8000,
  FOS_NOTESTFILECREATE = 0x10000,
  FOS_HIDEMRUPLACES = 0x20000,
  FOS_HIDEPINNEDPLACES = 0x40000,
  FOS_NODEREFERENCELINKS = 0x100000,
  FOS_OKBUTTONNEEDSINTERACTION = 0x200000,
  FOS_DONTADDTORECENT = 0x2000000,
  FOS_FORCESHOWHIDDEN = 0x10000000,
  FOS_DEFAULTNOMINIMODE = 0x20000000,
  FOS_FORCEPREVIEWPANEON = 0x40000000,
  FOS_SUPPORTSTREAMABLEITEMS = 0x80000000
} ;

Constantes

 
FOS_OVERWRITEPROMPT
Valor: 0x2
Ao salvar um arquivo, solicite antes de substituir um arquivo existente com o mesmo nome. Esse é um valor padrão para a caixa de diálogo Salvar.
FOS_STRICTFILETYPES
Valor: 0x4
Na caixa de diálogo Salvar, permita que o usuário escolha apenas um arquivo que tenha uma das extensões de nome de arquivo especificadas por meio de IFileDialog::SetFileTypes.
FOS_NOCHANGEDIR
Valor: 0x8
Não altere o diretório de trabalho atual.
FOS_PICKFOLDERS
Valor: 0x20
Apresentar uma caixa de diálogo Abrir que oferece uma opção de pastas em vez de arquivos.
FOS_FORCEFILESYSTEM
Valor: 0x40
Garante que os itens retornados sejam itens do sistema de arquivos (SFGAO_FILESYSTEM). Observe que isso não se aplica a itens retornados por IFileDialog::GetCurrentSelection.
FOS_ALLNONSTORAGEITEMS
Valor: 0x80
Permite que o usuário escolha qualquer item no namespace shell, não apenas aqueles com atributos SFGAO_STREAM ou SFAGO_FILESYSTEM . Esse sinalizador não pode ser combinado com FOS_FORCEFILESYSTEM.
FOS_NOVALIDATE
Valor: 0x100
Não verifique se há situações que impeçam um aplicativo de abrir o arquivo selecionado, como compartilhamento de violações ou erros de acesso negado.
FOS_ALLOWMULTISELECT
Valor: 0x200
Permite que o usuário selecione vários itens na caixa de diálogo aberta. Observe que, quando esse sinalizador é definido, a interface IFileOpenDialog deve ser usada para recuperar esses itens.
FOS_PATHMUSTEXIST
Valor: 0x800
O item retornado deve estar em uma pasta existente. Esse é um valor padrão.
FOS_FILEMUSTEXIST
Valor: 0x1000
O item retornado deve existir. Esse é um valor padrão para a caixa de diálogo Abrir.
FOS_CREATEPROMPT
Valor: 0x2000
Solicite a criação se o item retornado na caixa de diálogo aberta não existir. Observe que isso não realmente cria o item.
FOS_SHAREAWARE
Valor: 0x4000
No caso de uma violação de compartilhamento quando um aplicativo estiver abrindo um arquivo, chame o aplicativo novamente por meio de OnShareViolation para obter diretrizes. Esse sinalizador é substituído por FOS_NOVALIDATE.
FOS_NOREADONLYRETURN
Valor: 0x8000
Não retorne itens somente leitura. Esse é um valor padrão para a caixa de diálogo Salvar.
FOS_NOTESTFILECREATE
Valor: 0x10000
Não teste se a criação do item conforme especificado na caixa de diálogo Salvar será bem-sucedida. Se esse sinalizador não estiver definido, o aplicativo de chamada deverá tratar erros, como negação de acesso, descobertos quando o item é criado.
FOS_HIDEMRUPLACES
Valor: 0x20000
Ocultar a lista de locais dos quais o usuário abriu ou salvou itens recentemente. Não há suporte para esse valor a partir do Windows 7.
FOS_HIDEPINNEDPLACES
Valor: 0x40000
Ocultar itens mostrados por padrão no painel de navegação do modo de exibição. Esse sinalizador geralmente é usado em conjunto com o método IFileDialog::AddPlace , para ocultar locais padrão e substituí-los por locais personalizados.

Windows 7 e posterior. Ocultar todos os locais de namespace padrão (como Favoritos, Bibliotecas, Computador e Rede) mostrados no painel de navegação.

Windows Vista. Oculte o conteúdo da árvore Links Favoritos no painel de navegação. Observe que a categoria em si ainda é exibida, mas mostrada como vazia.
FOS_NODEREFERENCELINKS
Valor: 0x100000
Os atalhos não devem ser tratados como seus itens de destino. Isso permite que um aplicativo abra um arquivo .lnk em vez do que esse arquivo é um atalho.
FOS_OKBUTTONNEEDSINTERACTION
Valor: 0x200000
O botão OK será desabilitado até que o usuário navegue pela exibição ou edite o nome do arquivo (se aplicável). Observação: desabilitar o botão OK não impede que a caixa de diálogo seja enviada pela tecla Enter.
FOS_DONTADDTORECENT
Valor: 0x2000000
Não adicione o item que está sendo aberto ou salvo na lista de documentos recentes (SHAddToRecentDocs).
FOS_FORCESHOWHIDDEN
Valor: 0x10000000
Inclua itens ocultos e do sistema.
FOS_DEFAULTNOMINIMODE
Valor: 0x20000000
Indica à caixa de diálogo Salvar como que ela deve ser aberta no modo expandido. O modo expandido é o modo definido e não definido clicando no botão no canto inferior esquerdo da caixa de diálogo Salvar como que alterna entre Procurar Pastas e Ocultar Pastas quando clicado. Não há suporte para esse valor a partir do Windows 7.
FOS_FORCEPREVIEWPANEON
Valor: 0x40000000
Indica à caixa de diálogo Abrir que o painel de visualização sempre deve ser exibido.
FOS_SUPPORTSTREAMABLEITEMS
Valor: 0x80000000
Indica que o chamador está abrindo um arquivo como um fluxo (BHID_Stream), portanto, não há necessidade de baixar esse arquivo.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)

Confira também

IFileDialog::GetOptions

IFileDialog::SetOptions

IFileSaveDialog::GetOptions

IFileSaveDialog::SetOptions