Dati del documento e visualizzazione del documento nell'editor personalizzati

Articolo
05/17/2015

Un editor personalizzato è costituita da due parti: un oggetto dati del documento e un oggetto visualizzazione del documento. Mentre i nomi riportate, l'oggetto dati del documento rappresenta i dati del testo da visualizzare e l'oggetto visualizzato del documento (o “visualizzazione„) rappresenta una o più finestre in cui visualizzare l'oggetto dati del documento.

Oggetto dati del documento

Un oggetto dati del documento è una rappresentazione dei dati di testo nel buffer di testo. È un oggetto COM che il testo del documento agli archivi e altre informazioni, un handle descrivono la persistenza e consente più visualizzazioni dei dati. Per ulteriori informazioni, vedere

DocumentData e Finestre di documento.

Editor personalizzati e le finestre di progettazione possono scegliere di utilizzare l'oggetto di VsTextBuffer o il relativo buffer personalizzato. VsTextBuffer segue il modello includendo semplificato per un editor standard, visualizzazioni multiple e fornisce le interfacce eventi che consentono di gestire più visualizzazioni.

Oggetto visualizzazione del documento

Una finestra che visualizza codice e altro testo è nota come una visualizzazione del documento o la visualizzazione. Quando si crea un editor, è possibile scegliere uno un'unica visualizzazione, in cui visualizzare il testo in una singola finestra, o una visualizzazione più, in cui visualizzare il testo in più finestre. La scelta dipende dall'applicazione. Ad esempio, se è necessaria la modifica affiancata, scegliereste la visualizzazione di più processi. Ogni visualizzazione è associata a una voce nella tabella (RDT) del documento (IDE) dell'ambiente di sviluppo integrato. Le finestre di visualizzazione appartengono a un progetto o a un oggetto di IVsHierarchy .

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

L'ide notifica le visualizzazioni su eventi, ad esempio quando una soluzione che contiene un documento viene chiusa) corrispondente a un identificatore dell'elemento (ID voce) per ogni voce della tabella in esecuzione il documento. Per ulteriori informazioni, vedere Tabella di esecuzione del documento.

Sono disponibili due opzioni per creare una visualizzazione per un editor personalizzato. Uno è il modello di attivazione sul posto, in cui la visualizzazione viene inserita in una finestra utilizzando un controllo ActiveX o di un oggetto dati del documento. Il secondo il modello includendo semplificato, in cui la visualizzazione è ospitata da Visual Studio e IVsWindowPane viene implementato per gestire i comandi della finestra. Per informazioni sul modello di attivazione sul posto, vedere Attivazione sul posto. Per informazioni sul modello che utilizza semplificato, vedere incorporare semplificato.