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 命名空間