TextSelection 介面

提供對檢視架構編輯作業和選取文字的存取。

命名空間：  EnvDTE
組件：  EnvDTE (在 EnvDTE.dll 中)

語法

'宣告
<GuidAttribute("1FA0E135-399A-4D2C-A4FE-D21E2480F921")> _
Public Interface TextSelection

[GuidAttribute("1FA0E135-399A-4D2C-A4FE-D21E2480F921")]
public interface TextSelection

[GuidAttribute(L"1FA0E135-399A-4D2C-A4FE-D21E2480F921")]
public interface class TextSelection

[<GuidAttribute("1FA0E135-399A-4D2C-A4FE-D21E2480F921")>]
type TextSelection =  interface end

public interface TextSelection

TextSelection 類型會公開下列成員。

屬性

	名稱	描述
	ActivePoint	取得目前選取範圍的結束點。
	AnchorColumn	基礎架構。 僅限 Microsoft 內部使用。
	AnchorPoint	取得選取範圍的原點。
	BottomLine	基礎架構。 僅限 Microsoft 內部使用。
	BottomPoint	取得位於選取範圍結尾的點。
	CurrentColumn	基礎架構。 僅限 Microsoft 內部使用。
	CurrentLine	基礎架構。 僅限 Microsoft 內部使用。
	DTE	取得最上層的擴充性物件。
	IsActiveEndGreater	取得作用點是否等於下緣點。
	IsEmpty	取得錨點是否等於作用點。
	Mode	設定或取得判斷拖曳滑鼠是以資料流模式選取或以區塊模式選取的值。
	Parent	取得 TextSelection 物件的直屬父物件。
	Text	設定或取得文字選取範圍。
	TextPane	取得包含文字選取範圍的文字窗格。
	TextRanges	在選擇範圍中，取得每一行或部分行以 TextRange 物件的 TextRanges 集合。
	TopLine	基礎架構。 僅限 Microsoft 內部使用。
	TopPoint	取得選取範圍的頂端。

回頁首

方法

	名稱	描述
	Backspace	基礎架構。 僅限 Microsoft 內部使用。
	Cancel	基礎架構。 僅限 Microsoft 內部使用。
	ChangeCase	變更選取文字的大小寫。
	CharLeft	將物件向左移動指定的字元數。
	CharRight	將物件向右移動指定的字元數。
	ClearBookmark	清除目前文字緩衝區行裡任何未命名的書籤。
	Collapse	摺疊文字選取範圍至現用點。
	Copy	將文字複製選取範圍至剪貼簿。
	Cut	將文字複製選取範圍至剪貼簿和刪除它從原始位置。
	Delete	刪除文字選取範圍。
	DeleteLeft	刪除指定的字元數至現用點的左邊。
	DeleteWhitespace	刪除水平或垂直環繞於文字緩衝區中目前位置的空字元 (空白字元)。
	DestructiveInsert	插入文字，覆寫現有的文字。
	EndOfDocument	移動物件至文件的結尾。
	EndOfLine	移動物件至目前行的結尾。
	FindPattern	從現用點至檔案結尾搜尋指定的模式。
	FindText	從作用點到文件結尾搜尋指定的文字。
	GotoLine	移至指示行的開頭並於請求時選取行。
	Indent	以指定的縮排層次數目縮排選取各行。
	Insert	在目前的插入點插入指定的字串。
	InsertFromFile	在緩衝區中的目前位置插入指定檔案的內容。
	LineDown	將文字選取範圍的插入點向下移動指定的行數。
	LineUp	將文字選取範圍的插入點向上移動指定的行數。
	MoveTo	基礎架構。 僅限 Microsoft 內部使用。
	MoveToAbsoluteOffset	移動現用點至指定的以 1 起始的絕對字元位移。
	MoveToDisplayColumn	移動現用點至指示的顯示資料行。
	MoveToLineAndOffset	移動現用點至指定的位置。
	MoveToPoint	移動現用點至指定的位置。
	NewLine	在作用點插入一個分行符號字元。
	NextBookmark	移動至文件中下一個書籤的位置。
	OutlineSection	基於目前的選擇建立大綱區段。
	PadToColumn	以空白字元 (White Space) 填入緩衝區中目前的行一直到指定的欄為止。
	PageDown	移動文件中的現用點往下指定的頁數，捲動檢視。
	PageUp	移動文件中的現用點往上指定的頁數，捲動檢視。
	Paste	在目前位置插入剪貼簿內容。
	PreviousBookmark	將文字選取範圍移至文件中前一個書籤的位置。
	ReplacePattern	取代整個文字文件中符合的文字。
	ReplaceText	基礎架構。 僅限 Microsoft 內部使用。
	SelectAll	選取整個文件。
	SelectLine	選擇包含現用點的行。
	SetBookmark	在緩衝區中的目前行設定一個未命名的書籤。
	SmartFormat	依據目前的語言格式化選取的文字行。
	StartOfDocument	將插入點移至文件的開頭。
	StartOfLine	移動物件至目前行的開頭。
	SwapAnchor	交換作用點與錨點的位置。
	Tabify	依據您的定位點設定，將空格轉換為選擇中的定位點。
	Unindent	從文字選取範圍移除縮排的縮排層次數目指定的。
	Untabify	根據使用者的定位點設定值，將選取範圍中的定位點轉換成空格。
	WordLeft	移動文字選取範圍以指定的文字數。
	WordRight	移動文字選取範圍權限指定的位元數。

回頁首

備註

TextSelection 物件的屬性和方法會直接反映 Visual Studio 整合開發環境 (IDE) 中的編輯器命令。 像環境一樣，文字選取作業也會受編輯器的全域狀態所影響，例如它是否是在覆寫模式或虛擬空白字元 (White Space) 模式。

如果任何嘗試修改文字文件的作業會影響唯讀區塊中包含的任何字元，或者文件本身呈現唯讀屬性，作業便會失敗。

如果相關聯的文件是 HTML 文件，TextSelection 物件的一些屬性和方法可能會失敗。 可能導致失敗的原因為：顯示 HTML 文件的視窗不在原始碼檢視中，或是已鎖定文字文件背後的資料。

範例

Sub TextSelectionExample()
   ' Before running this example, open a text document.
   Dim objSel As TextSelection = DTE.ActiveDocument.Selection
   Dim objActive As VirtualPoint = objSel.ActivePoint
   ' Collapse the selection to the beginning of the line.
   objSel.StartOfLine()
   ' objActive is "live", tied to the position of the actual selection, 
   ' so it will reflect the new position.
   Dim iCol As Long = objActive.DisplayColumn
   ' Move the selection to the end of the line.
   objSel.EndOfLine()

   MsgBox("The length of the insertion point line is " & (objActive.DisplayColumn - iCol) & " display characters.")
End Sub

請參閱

參考

EnvDTE 命名空間