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