ITextView 介面

代表 ITextBuffer 中的文字檢視。 它是具有方法可呈現格式化文字的平台專用介面所適用的基底類別。

命名空間：  Microsoft.VisualStudio.Text.Editor
組件：  Microsoft.VisualStudio.Text.UI (在 Microsoft.VisualStudio.Text.UI.dll 中)

語法

'宣告
Public Interface ITextView _
    Inherits IPropertyOwner

public interface ITextView : IPropertyOwner

public interface class ITextView : IPropertyOwner

type ITextView =  
    interface 
        interface IPropertyOwner 
    end

public interface ITextView extends IPropertyOwner

ITextView 類型會公開下列成員。

屬性

	名稱	描述
	BufferGraph	取得 IBufferGraph，其包含構成此檢視的來源緩衝區集合。
	Caret	取得插入號項目。
	HasAggregateFocus	判斷檢視或其任何裝飾是否具有焦點。
	InLayout	判斷是否正在配置檢視。
	IsClosed	判斷這個文字檢視是否已關閉。
	IsMouseOverViewOrAdornments	判斷滑鼠是否位於檢視或其任何裝飾上方。
	LineHeight	取得檢視中的一行文字的表面的高度。
	MaxTextRightCoordinate	取得最長行的右方座標 (以邏輯像素為單位)，無論該行目前是否可見。
	Options	取得此文字檢視的選項。
	Properties	取得由房屋擁有者控制的屬性集合。 (繼承自 IPropertyOwner)。
	ProvisionalTextHighlight	取得暫時性文字反白所涵蓋的文字延伸。
	Roles	此檢視扮演的角色。要為檢視執行個體化的延伸，部分取決於這些角色。
	Selection	取得選取項目。
	TextBuffer	取得在此檢視中呈現文字的 ITextBuffer。
	TextDataModel	取得此文字檢視的 ITextDataModel。
	TextSnapshot	取得目前呈現於檢視中之文字的 ITextSnapshot。
	TextViewLines	取得呈現於此檢視中之 ITextViewLine 物件的唯讀清單。
	TextViewModel	取得此文字檢視的 ITextViewModel。
	ViewportBottom	取得檢視區在文字呈現座標系統中的下邊緣位置。
	ViewportHeight	取得可見內容視窗的高度 (包含邊界，以邏輯像素為單位)。
	ViewportLeft	取得或設定檢視區在文字呈現座標系統中的左邊緣位置。
	ViewportRight	取得檢視區在文字呈現座標系統中的右邊緣位置。
	ViewportTop	取得檢視區在文字呈現座標系統中的上邊緣位置。
	ViewportWidth	取得可見內容視窗的寬度 (包含邊界，以邏輯像素為單位)。
	ViewScroller	取得可提供不同方法以捲動或管理檢視的 Helper。
	VisualSnapshot	取得要呈現之視覺緩衝區的 ITextSnapshot。

回頁首

方法

	名稱	描述
	Close	關閉文字檢視主應用程式和其檢視。
	DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition)	將格式設定，並顯示文字緩衝區的內容，讓ITextViewLine包含緩衝區位置會顯示在想要的位置。
	DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition, Nullable<Double>, Nullable<Double>)	將格式設定，並顯示文字緩衝區的內容，讓ITextViewLine包含指定的緩衝區位置會顯示在想要的位置。
	GetTextElementSpan	取得在指定的 SnapshotPoint 上構成文字項目 (單一視覺表示) 之文字的 SnapshotSpan。
	GetTextViewLineContainingBufferPosition	取得 ITextViewLine，其包含指定的文字緩衝區位置。
	QueueSpaceReservationStackRefresh	要求重新整理空間保留堆疊。

回頁首

事件

	名稱	描述
	Closed	在文字檢視關閉後隨即發生。
	GotAggregateFocus	在鍵盤焦點切換至檢視或其裝飾之一時發生。
	LayoutChanged	在文字編輯器執行文字行配置時發生。
	LostAggregateFocus	在鍵盤焦點從檢視或其任一裝飾切走時發生。
	MouseHover	發生於滑鼠具有停留一個字元。
	ViewportHeightChanged	變更檢視區高度時發生。已取代。
	ViewportLeftChanged	變更檢視區左邊緣的位置時，就會發生。已取代
	ViewportWidthChanged	變更檢視區寬度時，就會發生。已取代。

回頁首

備註

文字檢視是留給表示連續文字區塊的格式化和裝飾。 文字可以透過TextViewLines屬性。

如需有關文字檢視的詳細資訊，請參閱"文字檢視"在在 [編輯器]。

文字檢視也具現化的執行個體IEditorOperations元件的情況下，讓它可以執行各種命令。

設定文字格式根據附加至基礎的類別器ITextBuffer。

大部分的屬性和參數的雙精度浮點數相對於座標或中文字呈現距離座標系統。 在此座標系統中，x = 0.0 會對應到此處呈現的文字在繪圖介面的左邊緣 (x = view.ViewportLeft相對於檢視區的左邊緣)，和 y = view.ViewportTop相對於檢視區的上邊緣。 X 座標會增加從左到右，與 y 座標會增加從上到下。 檢視表的水平及垂直軸的行為有所不同。 在檢視中的文字格式化時，只看得見的線條格式。 如此一來，檢視區無法捲動水平或垂直方式相同。 檢視區是藉由變更檢視區的左方的座標，這樣它就會移到的繪圖介面的水平捲動。 檢視表可以垂直捲動，只能藉由執行新的版面配置。 若選取的版面配置檢視中可能會導致ViewportTop的檢視中，以變更的屬性。

舉例來講，向下移一行捲動將不會轉譯任何看得見的行數。 相反地它只需要變更ViewportTop屬性，而造成的程式碼列移到螢幕的即使其 y 軸，以維持不變。 文字呈現的座標系統中的距離會對應到邏輯像素。 如果沒有任何縮放轉換顯示文字的呈現介面，則文字呈現的座標系統中的一個單位就相當於 [顯示] 中的一個像素。

請參閱

參考

Microsoft.VisualStudio.Text.Editor 命名空間