Partilhar via


Exibindo arquivos usando o comando Abrir arquivo

As etapas a seguir descrevem como o IDE manipula o Abrir arquivo de comando, que está disponível no arquivo menu no Visual Studio. As etapas também descrevem como os projetos devem responder às chamadas originadas deste comando.

Quando um usuário clica o Abrir arquivo no arquivo menu e seleciona um arquivo a partir do Abrir arquivo caixa de diálogo, o processo a seguir ocorre.

  1. Usando a tabela do documento em execução, o IDE determina se o arquivo já está aberto em um projeto.

    • Se o arquivo estiver aberto, o IDE resurfaces a janela.

    • Se o arquivo não estiver aberto, o IDE chama IsDocumentInProject para consultar cada projeto para determinar qual projeto pode abri-lo.

      Dica

      Na implementação do projeto de IsDocumentInProject, fornecer um valor de prioridade que indica o nível em que o seu projeto abre o arquivo.Os valores de prioridade são fornecidos na VSDOCUMENTPRIORITY enumeração.

  2. Cada projeto responde com um nível de prioridade indica a importância ele impõe ao sendo o projeto para abrir o arquivo.

  3. O IDE usa os seguintes critérios para determinar qual projeto abre o arquivo:

    • O projeto que responde com a prioridade mais alta (DP_Intrinsic) abre o arquivo. Se mais de um projeto responde com essa prioridade, o primeiro projeto responder abre o arquivo.

    • Se nenhum responde de projeto com a prioridade mais alta (DP_Intrinsic), mas responder de todos os projetos com a mesma e de menor prioridade, o projeto ativo abre o arquivo. Se nenhum projeto estiver ativo, o primeiro projeto responder abre o arquivo.

    • Se nenhum projeto queixe-se propriedade do arquivo (DP_Unsupported), o projeto arquivos diversos abre o arquivo.

      Se uma instância do projeto arquivos diversos for criada, o projeto sempre responde com o valor DP_CanAddAsExternal. Esse valor indica que o project pode abrir o arquivo. Este projeto é usado para armazenar os arquivos abertos que não estão em qualquer outro projeto. A lista de itens neste projeto não é persistente; Este projeto está visível no Solution Explorer somente quando ele é usado para abrir um arquivo.

      Se o projeto arquivos diversos não indicar que ele pode abrir o arquivo, uma instância do projeto não foi criada. Nesse caso, o IDE cria uma instância do projeto arquivos diversos e informa o projeto para abrir o arquivo.

  4. Assim que o IDE determina qual projeto abre o arquivo, ele chama o OpenItem método neste projeto.

  5. O projeto, em seguida, tem a opção de abrir o arquivo usando um editor específico do projeto ou um editor padrão. Para obter mais informações, consulte Como: abrir editores específicas do projeto e Como: abrir editores padrão, respectivamente.

Consulte também

Tarefas

Como: abrir editores específicas do projeto

Como: abrir editores padrão

Conceitos

Exibindo arquivos usando a abri-la com o comando

Outros recursos

Abrir e salvar os itens de projeto