SharpDevelop IDE IViewContent.cs类
文件位置：IViewContent.cs
/// <summary>/// IViewContent is the base interface for "windows" in the document area of SharpDevelop./// A view content is a view onto multiple files, or other content that opens like a document/// (e.g. the start page)./// </summary>public interface IViewContent : IDisposable, ICanBeDirty, IServiceProvider{/// <summary>/// This is the UI element for the view./// You can use both Windows.Forms and WPF controls./// </summary>object Control {get;}/// <summary>/// Gets the control which has focus initially./// </summary>object InitiallyFocusedControl {get;}/// <summary>/// The workbench window in which this view is displayed./// </summary>IWorkbenchWindow WorkbenchWindow {get;set;}/// <summary>/// Is raised when the value of the TabPageText property changes./// </summary>event EventHandler TabPageTextChanged;/// <summary>/// The text on the tab page when more than one view content/// is attached to a single window./// </summary>string TabPageText {get;}/// <summary>/// The title of the view content. This normally is the title of the primary file being edited./// </summary>string TitleName {get;}/// <summary>/// Is called each time the name for the content has changed./// </summary>event EventHandler TitleNameChanged;/// <summary>/// The tooltip that will be shown when you hover the mouse over the title/// </summary>string InfoTip {get;}/// <summary>/// Is called each time the info tip for the content has changed./// </summary>event EventHandler InfoTipChanged;/// <summary>/// Saves the content to the location <code>fileName</code>/// </summary>/// <remarks>/// When the user switches between multiple views editing the same file, a view/// change will trigger one view content to save that file into a memory stream/// and the other view content will load the file from that memory stream./// </remarks>void Save(OpenedFile file, Stream stream);/// <summary>/// Load or reload the content of the specified file from the stream./// </summary>/// <remarks>/// When the user switches between multiple views editing the same file, a view/// change will trigger one view content to save that file into a memory stream/// and the other view content will load the file from that memory stream./// </remarks>void Load(OpenedFile file, Stream stream);/// <summary>/// Gets the list of files that are being edited using this view content./// The returned collection usually is read-only./// </summary>IList<OpenedFile> Files { get; }/// <summary>/// Gets the primary file being edited. Might return null if no file is edited./// </summary>OpenedFile PrimaryFile { get; }/// <summary>/// Gets the name of the primary file being edited. Might return null if no file is edited./// </summary>FileName PrimaryFileName { get; }/// <summary>/// Builds an <see cref="INavigationPoint"/> for the current position./// </summary>INavigationPoint BuildNavPoint();bool IsDisposed { get; }event EventHandler Disposed;/// <summary>/// Gets if the view content is read-only (can be saved only when choosing another file name)./// </summary>bool IsReadOnly { get; }/// <summary>/// Gets if the view content is view-only (cannot be saved at all)./// </summary>bool IsViewOnly { get; }/// <summary>/// Gets whether this view content should be closed when the solution is closed./// </summary>bool CloseWithSolution { get; }#region Secondary view content support/// <summary>/// Gets the collection that stores the secondary view contents./// </summary>ICollection<IViewContent> SecondaryViewContents { get; }/// <summary>/// Gets switching without a Save/Load cycle for <paramref name="file"/> is supported/// when switching from this view content to <paramref name="newView"/>./// </summary>bool SupportsSwitchFromThisWithoutSaveLoad(OpenedFile file, IViewContent newView);/// <summary>/// Gets switching without a Save/Load cycle for <paramref name="file"/> is supported/// when switching from <paramref name="oldView"/> to this view content./// </summary>bool SupportsSwitchToThisWithoutSaveLoad(OpenedFile file, IViewContent oldView);/// <summary>/// Executes an action before switching from this view content to the new view content./// </summary>void SwitchFromThisWithoutSaveLoad(OpenedFile file, IViewContent newView);/// <summary>/// Executes an action before switching from the old view content to this view content./// </summary>void SwitchToThisWithoutSaveLoad(OpenedFile file, IViewContent oldView);#endregion}
IViewContent 是一个接口，定义了视图内容的基本行为和属性。在 SharpDevelop IDE 中，视图内容是文档区域中的“窗口”，可以是一个编辑器窗口，也可以是其他类型的窗口，如起始页。
以下是 IViewContent 接口的主要功能：
-
获取和设置视图内容的 UI 元素：通过
Control属性，可以获取和设置视图内容的 UI 元素。这个 UI 元素可以是 Windows.Forms 控件，也可以是 WPF 控件。 -
获取和设置视图内容的标题：通过
TitleName属性，可以获取和设置视图内容的标题。这个标题通常是正在编辑的主要文件的标题。 -
获取和设置视图内容的标签页文本：通过
TabPageText属性，可以获取和设置视图内容的标签页文本。这个文本在多个视图内容附加到同一个窗口时使用。 -
保存和加载视图内容：通过
Save和Load方法，可以保存和加载视图内容。这些方法接受一个OpenedFile对象和一个Stream对象，用于保存和加载文件。 -
获取正在编辑的文件列表：通过
Files属性，可以获取正在编辑的文件列表。这个列表通常是一个只读的集合。 -
获取正在编辑的主要文件：通过
PrimaryFile属性，可以获取正在编辑的主要文件。如果没有任何文件正在编辑，这个属性可能返回null。 -
获取正在编辑的主要文件的名称：通过
PrimaryFileName属性，可以获取正在编辑的主要文件的名称。如果没有任何文件正在编辑，这个属性可能返回null。 -
构建导航点：通过
BuildNavPoint方法，可以构建一个导航点，用于表示当前的位置。 -
获取视图内容的关闭行为：通过
CloseWithSolution属性，可以获取视图内容的关闭行为。这个属性表示当解决方案关闭时，视图内容是否应该关闭。 -
获取视图内容的只读和只读状态：通过
IsReadOnly和IsViewOnly属性，可以获取视图内容的只读和只读状态。如果视图内容是只读的，那么它只能保存到另一个文件名，不能保存到原始文件。如果视图内容是只读的，那么它不能保存到任何文件。 -
获取和设置视图内容的上下文帮助提供者：通过
ContextHelpProvider属性，可以获取和设置视图内容的上下文帮助提供者。上下文帮助提供者用于提供上下文相关的帮助信息。 -
获取和设置视图内容的工具宿主：通过
ToolsHost属性，可以获取和设置视图内容的工具宿主。工具宿主用于显示和管理工具。 -
获取和设置视图内容的属性容器：通过
PropertyContainer属性，可以获取和设置视图内容的属性容器。属性容器用于存储和显示对象的属性。 -
获取和设置视图内容的剪贴板处理程序：通过
ClipboardHandler属性，可以获取和设置视图内容的剪贴板处理程序。剪贴板处理程序用于处理剪贴板操作，如复制、粘贴、剪切等。 -
获取和设置视图内容的撤销处理程序：通过
UndoHandler属性，可以获取和设置视图内容的撤销处理程序。撤销处理程序用于处理撤销和重做操作。 -
获取和设置视图内容的文件文档提供程序：通过
FileDocumentProvider属性，可以获取和设置视图内容的文件文档提供程序。文件文档提供程序用于提供文件文档。 -
获取和设置视图内容的组件变更服务：通过
ComponentChangeService属性，可以获取和设置视图内容的组件变更服务。组件变更服务用于通知组件的变更。 -
**获取和设置视图内容的