ITextView 介面
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示中的 ITextBuffer文字檢視。 它是平臺特定介面的基類，其具有方法可允許轉譯格式化的文字。
public interface class ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwnerpublic interface class ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwner__interface ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwnerpublic interface ITextView : Microsoft.VisualStudio.Utilities.IPropertyOwnertype ITextView = interface
interface IPropertyOwnerPublic Interface ITextView
Implements IPropertyOwner- 衍生
- 實作
備註
文字檢視是連續區塊的平台獨立表示法，可透過 TextViewLines 屬性存取格式化和裝飾文字。 它也會具現化 IEditorOperations 元件元件的實例，以便執行各種命令。
文字會根據附加至基礎 ITextBuffer的分類器格式化。
大部分是雙精度浮點數的屬性和參數，都會對應到文字轉譯座標系統中的座標或距離。 在此座標系統中，x = 0.0 會對應至繪圖介面的左邊緣，其中文字轉譯 (x = 檢視。ViewportLeft 會對應至檢視區) 的左邊緣，而 y = 檢視。ViewportTop 會對應至檢視區的上邊緣。 x 座標會從左到右增加，而 Y 座標會從上到下增加。
檢視的水準和垂直軸的行為不同。 當檢視中的文字格式化時，只會格式化可見的行。 因此，檢視區不能以相同方式水準和垂直捲動。
檢視區會透過變更檢視區的左座標水平捲動，使其相對於繪圖介面移動。
只有執行新的版面配置，才能垂直捲動檢視。
在檢視中執行版面配置可能會導致檢視的 ViewportTop 屬性變更。 例如，向下捲動一行並不會轉譯任何可見的行。 相反地，它只會變更檢視的 ViewportTop 屬性， (導致線條在畫面上移動，即使其 y 坐標尚未變更) 也一樣。
文字轉譯座標系統中的距離會對應至邏輯圖元。 如果文字轉譯介面在未顯示任何縮放轉換的情況下顯示，則文字轉譯座標系統中的1個單位會對應到顯示器上的一個圖元。
屬性
| 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 |
取得協助程式，提供各種方法來捲動或操作檢視。 |
| VisualSnapshot |
ITextSnapshot取得正在轉譯之視覺緩衝區的 。 |
方法
| Close() |
關閉文字檢視及其檢視。 |
| DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition) |
格式化並顯示文字緩衝區的內容， ITextViewLine 以便將包含 |
| DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition, Nullable<Double>, Nullable<Double>) |
格式化並顯示文字緩衝區的內容， ITextViewLine 以便將包含 |
| GetTextElementSpan(SnapshotPoint) |
取得構成文字專案的 ， SnapshotSpan (指定 SnapshotPoint之的單一視覺表示法) 。 |
| GetTextViewLineContainingBufferPosition(SnapshotPoint) |
ITextViewLine取得 ，其中包含指定的文字緩衝區位置。 |
| QueueSpaceReservationStackRefresh() |
要求重新整理空間保留堆疊。 |
事件
| Closed |
在關閉文字檢視之後立即發生。 |
| GotAggregateFocus |
當鍵盤焦點切換至檢視或其中一個裝飾項目時發生。 |
| LayoutChanged |
每當檢視中顯示的文字變更時就會發生。 |
| LostAggregateFocus |
當鍵盤焦點離開檢視及其任何裝飾時發生。 |
| MouseHover |
發生於滑鼠停留在同一個字元上時。 |
| ViewportHeightChanged |
發生於檢視區的高度變更時。 |
| ViewportLeftChanged |
發生於檢視區左邊緣的位置變更時。 (例如，當檢視水平捲動) |
| ViewportWidthChanged |
發生於檢視區的寬度變更時。 |