Compartilhar via

Salvando um documento padrão

  • Artigo

O ambiente manipula os comandos Salvar, Salvar como e Salvar tudo. Quando um usuário seleciona Salvar, Salvar como ou Salvar tudo no menu Arquivo ou fecha a solução, resultando em um Salvar tudo, ocorre o seguinte processo.

Editor padrão

Manipulação dos comandos Salvar, Salvar como e Salvar tudo para um editor padrão

Esse processo é detalhado nas seguintes etapas:

  1. Quando os comandos Salvar e Salvar como são selecionados, o ambiente usa o serviço SVsShellMonitorSelection para determinar a janela do documento ativo e, portanto, quais itens devem ser salvos. Assim que a janela do documento ativo for conhecida, o ambiente localiza o ponteiro da hierarquia e o identificador de item (itemID) do documento na tabela de documentos em execução. Para obter mais informações, confira a Tabela de documento em execução.

    Quando o comando Salvar tudo é selecionado, o ambiente usa as informações na tabela de documentos em execução para compilar a lista de todos os itens a serem salvos.

  2. Quando a solução recebe uma chamada de QueryStatus, ela itera pelo conjunto de itens selecionados (ou seja, as seleções múltiplas expostas pelo serviço SVsShellMonitorSelection).

  3. Em cada item da seleção, a solução usa o ponteiro de hierarquia para chamar o método IsItemDirty e determinar se o comando de menu Salvar deve ser habilitado. Se um ou mais itens estiverem sujos, o comando Salvar estará habilitado. Se a hierarquia usar um editor padrão, ela delega a consulta de status sujo ao editor chamando o método IsDocDataDirty.

  4. Em cada item selecionado que estiver sujo, a solução usa o ponteiro de hierarquia para chamar o método SaveItem nas hierarquias apropriadas.

    É comum que a hierarquia use um editor padrão para editar o documento. Nesse caso, o objeto de dados do documento para esse editor deve oferecer suporte à interface IVsPersistDocData2. Ao receber a chamada de método SaveItem, o projeto deve informar ao editor que o documento está sendo salvo chamando o método SaveDocData no objeto de dados do documento. O editor pode permitir que o ambiente manipule a caixa de diálogo Salvar como, chamando Query Service para a interface SVsUIShell. Isso retorna um ponteiro para a interface IVsUIShell. O editor deve então chamar o método SaveDocDataToFile, informando um ponteiro para a implementação IPersistFileFormat do editor por meio do parâmetro pPersistFile. Em seguida, o ambiente executa a operação Salvar e fornece a caixa de diálogo Salvar como para o editor. O ambiente então chama de volta ao editor com IPersistFileFormat.

  5. Se o usuário estiver tentando salvar um documento sem título (ou seja, um documento não salvo anteriormente), um comando Salvar como será realmente executado.

  6. Para o comando Salvar como, o ambiente exibe a caixa de diálogo Salvar como, solicitando ao usuário um nome de arquivo.

    Se o nome do arquivo tiver sido alterado, a hierarquia será responsável por atualizar as informações armazenadas em cache do quadro do documento chamando SetProperty(VSFPROPID_MkDocument).

    Se o comando Salvar como mover o local do documento e a hierarquia for sensível ao local do documento, a hierarquia será responsável por transferir a propriedade da janela do documento aberta para outra hierarquia. Por exemplo, isso ocorre quando o projeto controla se o arquivo é interno ou externo (Arquivo diverso) em relação ao projeto. Use o procedimento a seguir para alterar a propriedade de um arquivo para o projeto Arquivos diversos.

Alterar a propriedade do Arquivo

Para alterar a propriedade do arquivo para o projeto Arquivos diversos

  1. Serviço de consulta para a interface SVsExternalFilesManager.

    Um ponteiro para IVsExternalFilesManager2 é retornado.

  2. Chame o método TransferDocument (pszMkDocumentNew, punkWindowFrame) para transferir o documento para a nova hierarquia. A hierarquia que executa o comando Salvar como chama esse método.

Conteúdo relacionado