Salvando um documento padrão
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.
Manipulação dos comandos Salvar, Salvar como e Salvar tudo para um editor padrão
Esse processo é detalhado nas seguintes etapas:
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.
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).
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.
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 Servicepara 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âmetropPersistFile. 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.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.
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
Serviço de consulta para a interface SVsExternalFilesManager.
Um ponteiro para IVsExternalFilesManager2 é retornado.
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.