Condividi tramite


Aprire gli editor per i documenti aperti

Prima che un progetto apra una finestra di documento, il progetto deve prima determinare se il file è già aperto nella finestra del documento per un altro editor. Il file può essere aperto in un editor specifico del progetto o in uno degli editor standard registrati in Visual Studio.

Aprire un editor specifico del progetto

Utilizzare la procedura seguente per aprire un editor specifico del progetto per un file già aperto.

Per aprire un editor specifico del progetto per un file aperto

  1. Chiamare il metodo IsDocumentOpen .

    Questa chiamata restituisce puntatori alla gerarchia, all'elemento gerarchia e alla cornice della finestra del documento, se appropriato.

  2. Se il documento è aperto, il progetto deve verificare se esiste solo un oggetto dati documento o se è presente anche un oggetto visualizzazione documento.

    • Se esiste un oggetto visualizzazione documento e questa vista si trova per una gerarchia o un elemento gerarchico diverso, il progetto usa il puntatore alla cornice della finestra della visualizzazione per riaccesare la finestra esistente.

    • Se esiste un oggetto visualizzazione documento e questa vista si trova per la stessa gerarchia e lo stesso elemento della gerarchia, il progetto può aprire una seconda visualizzazione se può collegarsi all'oggetto dati del documento sottostante. In caso contrario, il progetto deve usare il puntatore alla cornice della finestra della visualizzazione per riassurgere la finestra esistente.

    • Se esiste solo l'oggetto dati del documento, il progetto deve determinare se può utilizzare l'oggetto dati del documento per la relativa visualizzazione. Se l'oggetto dati del documento è compatibile, completare i passaggi descritti in Aprire un editor specifico del progetto.

      Se l'oggetto dati del documento non è compatibile, dovrebbe essere visualizzato un errore all'utente che indica che il file è attualmente in uso. Questo errore deve essere visualizzato solo in casi temporanei, ad esempio quando un file viene compilato contemporaneamente all'utente che sta tentando di aprire il file usando un editor diverso dall'editor di testo principale di Visual Studio. L'editor di testo principale può condividere l'oggetto dati del documento con il compilatore.

  3. Se il documento non è aperto perché non è presente alcun oggetto dati documento o oggetto visualizzazione documento, completare i passaggi in Aprire un editor specifico del progetto.

Aprire un editor standard

Utilizzare la procedura seguente per aprire un editor standard per un file già aperto.

Per aprire un editor standard per un file aperto

  1. Chiamare OpenStandardEditor.

    Questo metodo verifica innanzitutto che il documento non sia già aperto chiamando IsDocumentOpen. Se il documento è già aperto, viene visualizzata nuovamente la finestra dell'editor.

  2. Se il documento non è aperto, completare i passaggi descritti in Procedura: Aprire editor standard.