IVsTextView 介面

管理編輯器] 視窗的 [文字] 檢視並管理文字檢視的方式。 檢視是基本上是顯示在使用者介面 (UI) 中 [編輯器] 視窗。

命名空間：  Microsoft.VisualStudio.TextManager.Interop
組件：  Microsoft.VisualStudio.TextManager.Interop (在 Microsoft.VisualStudio.TextManager.Interop.dll 中)

語法

'宣告
<InterfaceTypeAttribute()> _
<GuidAttribute("BB23A14B-7C61-469A-9890-A95648CED5E6")> _
Public Interface IVsTextView

[InterfaceTypeAttribute()]
[GuidAttribute("BB23A14B-7C61-469A-9890-A95648CED5E6")]
public interface IVsTextView

[InterfaceTypeAttribute()]
[GuidAttribute(L"BB23A14B-7C61-469A-9890-A95648CED5E6")]
public interface class IVsTextView

[<InterfaceTypeAttribute()>]
[<GuidAttribute("BB23A14B-7C61-469A-9890-A95648CED5E6")>]
type IVsTextView =  interface end

public interface IVsTextView

IVsTextView 類型會公開下列成員。

方法

	名稱	描述
	AddCommandFilter	指令篩選加入現有的篩選條件鏈結的命令。
	CenterColumns	將指定的資料行的文字放在中心的檢視中。
	CenterLines	指定檢視的置中的文字行的位置。
	ClearSelection	清除目前的選取範圍。
	CloseView	關閉，並檢視管理員] 會移除註冊的檢視。
	EnsureSpanVisible	請確定文字會在檢視中，兩者都垂直和水平。
	GetBuffer	傳回目前文字緩衝區的內容。
	GetCaretPos	傳回游標所在位置的行和資料行的索引。
	GetLineAndColumn	將列和資料行的索引中的文字資料流位置。
	GetLineHeight	傳回一條線的像素高度。
	GetNearestPosition	將文字資料流位置的行和資料行的索引。
	GetPointOfLineColumn	傳回特定的行和資料行的左上角的座標。
	GetScrollInfo	傳回指定的捲軸的核心文字編輯器的捲軸列設定。
	GetSelectedText	傳回所選文字的複本。
	GetSelection	如果有的話，則傳回對應至目前的選取範圍的文字範圍。
	GetSelectionDataObject	傳回選取的文字，在一份IDataObject介面格式。
	GetSelectionMode	傳回目前的選取模式。
	GetSelectionSpan	傳回選取範圍相關聯的文字範圍。
	GetTextStream	傳回指定的文字串，字串中。
	GetWindowHandle	傳回此檢視的視窗控制代碼。
	GetWordExtent	傳回目前的文字範圍。
	HighlightMatchingBrace	會反白顯示對稱的括號中的語言建構。
	Initialize	建立檢視，並可讓用戶端指定一或多個 TextViewInitFlags 選項。
	PositionCaretForEditing	會將插入號置於位置適用於編輯函式。
	RemoveCommandFilter	鏈結的命令的篩選器會移除命令過濾器。
	ReplaceTextOnLine	取代的一行文字。
	RestrictViewRange	未提供方法資訊。未實作方法。
	SendExplicitFocus	傳送給視窗的外顯的焦點。
	SetBuffer	將文字緩衝區關聯進行檢視。
	SetCaretPos	設定選取範圍的結束點的座標。
	SetScrollPosition	將核心文字編輯器的捲軸列設定設為指定的捲軸列。
	SetSelection	選取指定的文字。
	SetSelectionMode	設定選取模式而定。
	SetTopLine	設定比較基準] 檢視中的最上方的線條。
	UpdateCompletionStatus	用於 word 完成控制。
	UpdateTipWindow	更新 [提示] 視窗。
	UpdateViewFrameCaption	強制更新其框架視窗的標題，例如"[Read only]"檢視。

回頁首

備註

IVsTextView的 MDI 子系，但文字的個別視窗不是介面。 分隔器的相關資訊，如果在 MDI 子系可以有多個檢視。 詞彙、 插入號，指的是以文字插入點，來看，同時資料指標，指向滑鼠指標。

警告

這個介面不是安全執行緒。您不應該在這個介面，從任何東西，但主要 UI 執行緒上呼叫的任何項目。

如果您需要從不同的執行緒執行任何作業，對檢視表，您可以：

• 使用介面IVsThreadSafeTextView。

• 呼叫GetWindowHandle方法，並使用PostMessage發佈訊息給主執行緒的方法。

上的某些方法IVsTextView使用 ViewCol 座標 (例如， GetTextStream和GetCaretPos)，有些則會使用 CharIndex 座標 (比方說， GetWordExtent)。 ViewCol 座標 CharIndex 座標是只位移到緩衝區行並不會包含虛擬空間時，可能會包含虛擬空間。

如果您收到 ViewCol 座標中的座標，然後您才應該呼叫採用 CharIndex 座標，請先確定 ViewCol 座標不會不存在於虛擬空間區域的方法。 例如，如果您呼叫下列：

long iLine;

long cCount;

ViewCol iCol;

IVsTextView::SomeMethod(&iLine, &icol);

然後您必須檢查以確定下列條件為真：

IVsTextBuffer::GetLengthOfLine(iLine, &cCount);

iCol < cCount

然後呼叫下列所示：

IVsTextView::SomeOtherMethod(ViewCol(iCol ))

// where SomeOtherMethod takes ViewCol coordinates

實作的圖例和 (或) 在這個範例中，這個介面的電話，請參閱Figures Language Service。

呼叫者注意事項

由用戶端想要管理其檢視呼叫。

請參閱

參考

Microsoft.VisualStudio.TextManager.Interop 命名空間