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	将缓冲区中的当前行到给定列用空字符（空白）填充。
	PageDown	将活动点在文档中下移指定的页数以滚动视图。
	PageUp	滚动视图，在文档中将活动点上移指定的页数。
	Paste	在当前位置插入剪贴板内容。
	PreviousBookmark	将选定文本移动到文档中的上一个书签位置。
	ReplacePattern	在整个文本文档中替换匹配的文本。
	ReplaceText	基础结构。仅由 Microsoft 内部使用。
	SelectAll	选择整个文档。
	SelectLine	选择包含活动点的行。
	SetBookmark	在缓冲区中的当前行上设置未命名的书签。
	SmartFormat	根据当前语言格式化选定行的文本。
	StartOfDocument	将插入点移动到文档开头。
	StartOfLine	将对象移到当前行的开头。
	SwapAnchor	交换活动点和定位点的位置。
	Tabify	根据选项卡设置，将选定内容中的空格转换为制表符。
	Unindent	按照给定的缩进级别数从选定的文本中移除缩进。
	Untabify	根据用户的选项卡设置，将行开头的制表符转换为空格。发现出现在行中的选项卡不会转换为空格。
	WordLeft	将选定文本左移指定的字数。
	WordRight	将选定文本右移指定的字数。

页首

备注

TextSelection 对象的属性和方法直接反映了 Visual Studio 集成开发环境 (IDE) 中的编辑器命令。 像环境一样，文本选定操作受编辑器全局状态的影响，比如编辑器是处于覆盖模式还是处于虚拟空白模式。

如果影响了只读块中包含的任何字符，或者文本文档本身是只读的，则任何尝试修改该文本文档的操作都将失败。

如果关联文档为 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 命名空间