Condividi tramite

Dati documento e visualizzazione documento in editor personalizzati

  • Articolo

Un editor personalizzato è costituito da due parti: un oggetto dati documento e un oggetto visualizzazione documento. Come suggerisce i nomi, l'oggetto dati del documento rappresenta i dati di testo da visualizzare. Analogamente, l'oggetto visualizzazione documento (o "view") rappresenta una o più finestre in cui visualizzare l'oggetto dati del documento.

Oggetto dati documento

Un oggetto dati del documento è una rappresentazione dei dati di testo nel buffer di testo. Si tratta di un oggetto COM che archivia il testo del documento e altre informazioni. L'oggetto dati del documento gestisce anche la persistenza dei documenti e consente più visualizzazioni dei dati. Per altre informazioni, vedere

DocumentData[] e Finestre documento.

Gli editor personalizzati e le finestre di progettazione possono scegliere di usare l'oggetto VsTextBuffer o il proprio buffer personalizzato. VsTextBuffer segue il modello di incorporamento semplificato per un editor standard, supporta più visualizzazioni e fornisce interfacce evento usate per gestire più visualizzazioni.

Oggetto visualizzazione documento

Una finestra che visualizza codice e altro testo è nota come visualizzazione o vista documento. Quando si crea un editor, è possibile scegliere una singola visualizzazione, in cui il testo viene visualizzato in una singola finestra. In alternativa, è possibile scegliere una visualizzazione multipla, in cui il testo viene visualizzato in più finestre. La scelta dipende dall'applicazione. Ad esempio, se è necessaria una modifica side-by-side, è possibile scegliere più visualizzazioni. Ogni visualizzazione è associata a una voce nell'IDE (Integrated Development Environment) che esegue la tabella dei documenti (RDT). Le finestre di visualizzazione appartengono a un progetto o a un IVsHierarchy oggetto .

Se l'editor supporta più visualizzazioni di un oggetto dati documento, i dati del documento e gli oggetti visualizzazione documento devono essere separati. In caso contrario, possono essere raggruppati. Per altre informazioni, vedere Supportare più visualizzazioni documento.

L'IDE invia una notifica alle visualizzazioni degli eventi( ad esempio, quando una soluzione contenente un documento viene chiusa) associando un identificatore di elemento (ItemID) per ogni voce della tabella dei documenti in esecuzione. Per altre informazioni, vedere Tabella dei documenti in esecuzione.

Sono disponibili due opzioni per la creazione di una visualizzazione per un editor personalizzato. Uno è il modello di attivazione sul posto, in cui la visualizzazione è ospitata in una finestra usando un controllo ActiveX o un oggetto dati documento. Il secondo è il modello di incorporamento semplificato, in cui la visualizzazione è ospitata da Visual Studio e IVsWindowPane viene implementata per gestire i comandi della finestra. Per informazioni sul modello di attivazione sul posto, vedere Attivazione sul posto. Per informazioni sul modello di incorporamento semplificato, vedere Incorporamento semplificato.

Contenuto correlato