Windows Dev Center

Guia de início rápido: integração com contratos de seletor de arquivos (aplicativos do tempo de Execução do Windows)

Forneça acesso ao conteúdo do aplicativo, um local de salvamento ou atualizações de arquivos por meio do seletor de arquivos integrando seu aplicativo com o contrato do Seletor de Abertura de Arquivos, o contrato do Seletor de Salvamento de Arquivos ou com o contrato do Atualizador de Arquivos em Cache.

Pré-requisitos

Decida quais serviços o seu aplicativo oferecerá em janelas do seletor de arquivos

Seu aplicativo pode fornecer os seguintes serviços para outros aplicativos por meio da integração com o contrato de aplicativo associado. Para participar de um contrato, você deve declarar o contrato no manifesto do seu aplicativo, responder ao evento ativado correspondente e criar uma exibição de aplicativo especializada.

Fornecer acesso a arquivos

Torne os arquivos acessíveis de uma seleção de arquivos se o seu aplicativo tiver uma exibição exclusiva e/ou valiosa desses arquivos ou se os usuários não puderem acessar facilmente os arquivos de outra maneira.

Contrato de aplicativo: Contrato do seletor de abertura de arquivo

Informações do evento ativado: fileOpenPickerActivatedEventArgs

Fornecer um local de gravação

Forneça um local de salvamento por meio de um seletor de arquivos se esperar que seus usuários queiram salvar arquivos a fim de abrir e trabalhar com eles em seu aplicativo posteriormente.

Contrato de aplicativo: Contrato do seletor de salvamento de arquivos

Informações do evento ativado: fileSavePickerActivatedEventArgs

Fornecer atualizações em tempo real para arquivos

Controle e atualize os arquivos por meio de um seletor de arquivos se você espera que os usuários usem seu aplicativo como um repositório central de arquivos a que seu aplicativo permite o acesso, ou que são salvos com o aplicativo como o local de salvamento.

Contrato de aplicativo: contrato do Atualizador de arquivos em cache:

Informações do evento ativado: cachedFileUpdaterActivatedEventArgs

Saiba mais sobre os serviços que o seu aplicativo pode fornecer através de um seletor de arquivos em Acessando arquivos com seletores de arquivos.

Declare o contrato no manifesto do seu arquivo

Com o projeto aberto no Microsoft Visual Studio, siga estas etapas para adicionar um contrato de aplicativo ao seu manifesto:

  1. Adicione um contrato de aplicativo abrindo a janela Adicionar novo item ao seu projeto, selecionando o contrato do painel central e, então, clicando no botão Adicionar.

    Há várias maneiras de abrir a janela Adicionar Novo Item no Visual Studio:

    • Selecionando a opção de menu Projeto > Adicionar novo item...
    • Selecionando a opção de menu Adicionar > Novo item... a partir do menu de contexto do projeto.
    • Usando o atalho de teclado Crtl+Shift+A
    Dica  Quando você adiciona esses contratos, o Visual Studio atualiza automaticamente o arquivo de manifesto "package.appmanifest" e adiciona arquivos ao projeto. Você usará esses arquivos para definir o layout e o comportamento da exibição que será hospedada na janela do seletor de arquivos quando o serviço do aplicativo for chamado.
  2. Personalize as configurações do contrato no Visual Studio se as configurações padrão não forem adequadas ao seu aplicativo.

    1. Abra "package.appmanifest".
    2. Abra a guia Declarações.
    3. Selecione o nome do seu contrato na lista Declarações suportadas.
    4. Adicione suporte para tipos específicos de arquivos.

      Na caixa Tipos de arquivos suportados, desmarque a caixa de seleção SupportsAnyFileType.

      Adicione um novo campo FileType para cada arquivo que você deseja suportar com as seguintes etapas:

      1. Clique no botão Adicionar novo.
      2. Insira a extensão de um tipo de arquivo que você queira suportar no campo FileType da seguinte forma: *.ext
      Dica  Adicione apenas os tipos de arquivos que são diretamente relevantes para o seu aplicativo, para seus usuários e para o seu contrato. Limitar tipos de arquivos dessa maneira pode ajudar a manter a exibição do seletor de arquivos organizada e fácil de usar.

    Você também pode remover o suporte para um tipo de arquivo seguindo as etapas anteriores e clicando no botão Remover do tipo que você deseja remover. O botão Remover fica diretamente acima do campo Tipo de arquivo.

O seu arquivo de manifesto é atualizado com a marcação do contrato que você adicionou. Um elemento que representa o contrato que você adicionou é inserido na marcação em XML do manifesto como filho do elementoExtensions. Por exemplo, a marcação para um Seletor de abertura de arquivos com suporte a todos os tipos de arquivos tem a seguinte aparência:



  <Extension Category="windows.filePicker" StartPage="filePicker.html">
    <FileOpenPicker>
      <SupportedFileTypes SupportsAnyFileType="true" />
    </FileOpenPicker>
  </Extension>


Responda quando o seu aplicativo é ativado por um seletor de arquivos

Adicione código ao seu manipulador de eventos ativados que testa se o objeto passado para o seu manipulador está associado ao contrato que você declarou no seu manifesto e, então, exibe o arquivo do seu aplicativo na exibição do seletor de arquivos.

Cada contrato é associado a um objeto que fornece informações sobre um evento ativado que é disparado quando um dos serviços fornecidos pelo seu aplicativo é chamado de um seletor de arquivos.

Contrato do seletor de abertura de arquivos - fileOpenPickerActivatedEventArgs

Contrato do seletor de salvamento de arquivos - fileSavePickerActivatedEventArgs

Contrato do atualizador de arquivos em cache - cachedFileUpdaterActivatedEventArgs

Criar uma exibição especializada do seu aplicativo que será hospedada no seletor de arquivos

As orientações das Diretrizes e lista de verificação dos seletores de arquivos devem ajudá-lo a projetar a exibição aplicativo que estará hospedado no seletor de arquivos.

Em última análise, sua exibição deve ser composta de:

  • Um código que personaliza a letterbox do seletor de arquivos de forma adequada

  • Uma marcação e estilos que definem a disposição da área delimitada do seletor de arquivos (onde os arquivos são exibidos)

  • Um código que conecta a fonte de dados para marcação para que os arquivos sejam exibidos na área delimitada

Testar os serviços fornecidos pelo seu aplicativo a partir de um seletor de arquivos chamado por outro aplicativo

Para testar os serviços fornecidos pelo seu aplicativo através de um seletor de arquivos, você deve disparar o evento ativado correspondente ao serviço fornecido pelo seu aplicativo. Você não pode disparar esse evento executando diretamente o seu aplicativo.

Em vez disso, use estas etapas para disparar o evento ativado correspondente a cada contrato.

Para testar a participação do seu aplicativo no contrato do Seletor de abertura de arquivos:

  1. Inicie um aplicativo outro que não o seu.

  2. Use a interface do usuário para chamar uma janela do seletor de arquivos para acessar arquivos.

  3. Selecione o seu aplicativo na lista de locais do seletor de arquivos para ver o seu aplicativo hospedado no seletor de arquivos.

Para testar a participação do seu aplicativo no contrato do Seletor de salvamento de arquivos:

  1. Inicie um aplicativo outro que não o seu.

  2. Use a interface do usuário para chamar uma janela do seletor de arquivos para salvar um arquivo.

  3. Selecione o seu aplicativo na lista de locais do seletor de arquivos para ver o seu aplicativo hospedado no seletor de arquivos.

Para testar a participação do seu aplicativo no contrato do Atualizador de arquivos em cache:

  1. Inicie um aplicativo outro que não o seu.

  2. Use a interface do usuário desse outro aplicativo para chamar uma janela de seleção de arquivos ou salve um arquivo que você marcou para ser atualizado.

Resumo

O seu aplicativo pode fornecer serviços a outros aplicativos participando de um contrato de aplicativo. Para participar de um contrato, você deve declarar o contrato no manifesto do seu aplicativo, responder ao evento ativado correspondente e criar uma exibição de aplicativo especializada.

Tópicos relacionados

Acessando dados e arquivos
Integrando contratos de seletor de arquivos
exemplo de contratos de seletor de arquivos
Diretrizes e lista de verificação de contratos de seletor de arquivos
Como ativar um aplicativo
Contratos de aplicativos do Windows
Referência
Windows.Storage.Pickers.Provider namespace
Windows.ApplicationModel.Activation.fileOpenPickerActivatedEventArgs class
Windows.ApplicationModel.Activation.fileSavePickerActivatedEventArgs class
Windows.ApplicationModel.Activation.cachedFileUpdaterActivatedEventArgs class
Usando seletores de arquivos
Guia de início rápido: acessando arquivos com seletores de arquivos
Como salvar arquivos usando seletores de arquivos
Diretrizes e lista de verificação dos seletores de arquivos

 

 

Mostrar:
© 2015 Microsoft