EditPoint 介面

可以讓您以資料的方式操作文字緩衝區裡的文字。

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

語法

'宣告
<GuidAttribute("C1FFE800-028B-4475-A907-14F51F19BB7D")> _
Public Interface EditPoint _
    Inherits TextPoint

[GuidAttribute("C1FFE800-028B-4475-A907-14F51F19BB7D")]
public interface EditPoint : TextPoint

[GuidAttribute(L"C1FFE800-028B-4475-A907-14F51F19BB7D")]
public interface class EditPoint : TextPoint

[<GuidAttribute("C1FFE800-028B-4475-A907-14F51F19BB7D")>]
type EditPoint =  
    interface
        interface TextPoint
    end

public interface EditPoint extends TextPoint

EditPoint 型別會公開下列成員。

屬性

	名稱	說明
	AbsoluteCharOffset	取得 EditPoint 物件的字元位移 (Offset)，以 1 起始。
	AbsoluteCharOffset	取得從文件開頭到 TextPoint 物件的字元位移 (Offset)，以 1 起始。 (繼承自 TextPoint)。
	AtEndOfDocument	取得值，指出物件是否在文件結尾。
	AtEndOfDocument	取得是否物件在文件的結尾。 (繼承自 TextPoint)。
	AtEndOfLine	取得值，指出物件是否在行的結尾。
	AtEndOfLine	取得是否物件位於行的結尾。 (繼承自 TextPoint)。
	AtStartOfDocument	取得值，指出物件是否在文件開頭。
	AtStartOfDocument	取得是否物件在文件的開頭。 (繼承自 TextPoint)。
	AtStartOfLine	取得值，指出是否 EditPoint 物件在行的開頭。
	AtStartOfLine	取得是否物件在行的開頭。 (繼承自 TextPoint)。
	CodeElement[vsCMElement]	取得在 EditPoint 位置的程式碼項目。
	CodeElement[vsCMElement]	傳回在 TextPoint 位置的程式碼項目。 (繼承自 TextPoint)。
	DisplayColumn	取得 EditPoint 物件的資料行數目。
	DisplayColumn	取得包含 TextPoint 物件的目前顯示資料行數目。 (繼承自 TextPoint)。
	DTE	取得最上層的擴充性物件。
	DTE	取得最上層擴充性物件。 (繼承自 TextPoint)。
	Line	取得 EditPoint 物件的行號。
	Line	取得物件的行號。 (繼承自 TextPoint)。
	LineCharOffset	取得 EditPoint 物件的字元位移。
	LineCharOffset	取得物件的字元位移。 (繼承自 TextPoint)。
	LineLength	取得一行中的字元數目。
	LineLength	傳回一個包含物件的行之字元數，不包含換行字元。 (繼承自 TextPoint)。
	Parent	取得 EditPoint 物件的直接上層父物件。
	Parent	取得 TextPoint 物件的直接上層父物件。 (繼承自 TextPoint)。

回頁首

方法

	名稱	說明
	ChangeCase	變更選取文字的大小寫。
	CharLeft	將編輯點向左移動指定的字元數目。
	CharRight	將編輯點向右移動指定的字元數目。
	ClearBookmark	清除目前文字緩衝區行裡任何未命名的書籤。
	Copy	將指定的文字範圍複製到剪貼簿。
	CreateEditPoint()	在進行呼叫之物件的所在位置建立並傳回 EditPoint 物件。
	CreateEditPoint()	在進行呼叫之物件的所在位置建立並傳回 EditPoint 物件。 (繼承自 TextPoint)。
	Cut	將指定的文字範圍複製到剪貼簿，並從文件中將其刪除。
	Delete	刪除指定的文字範圍。
	DeleteWhitespace	刪除水平或垂直環繞於文字緩衝區中目前位置的空字元 (空白字元)。
	EndOfDocument	將編輯點移動至文件的結尾。
	EndOfLine	將編輯點移動至緩衝區中目前行的結尾。
	EqualTo(TextPoint)	傳回數值，指出指定點物件與呼叫之 EditPoint 物件的 AbsoluteCharOffset 值是否相等。
	EqualTo(TextPoint)	傳回是否指定點物件的 AbsoluteCharOffset 屬性值與呼叫 TextPoint 物件的屬性值相同。 (繼承自 TextPoint)。
	FindPattern	在選取的文字中尋找指定的比對模式。
	GetLines	取得表示兩個指定行之間文字的字串。
	GetText	取得緩衝區中介於目前位置與指定位置之間的文字。
	GreaterThan(TextPoint)	傳回 EditPoint 物件的 AbsoluteCharOffset 屬性值是否大於指定 TextPoint 物件屬性的值。
	GreaterThan(TextPoint)	指示是否呼叫物件的 AbsoluteCharOffset 屬性值大於指定點物件的屬性值。 (繼承自 TextPoint)。
	Indent	以指定的縮排層次數目縮排選取各行。
	Insert	在緩衝區中編輯點的目前位置插入指定的字串。
	InsertFromFile	在緩衝區中的目前位置插入指定檔案的內容。
	LessThan(TextPoint)	傳回是否呼叫 EditPoint 物件的 AbsoluteCharOffset 值小於指定 TextPoint 物件的值。
	LessThan(TextPoint)	指示是否呼叫物件的 AbsoluteCharOffset 屬性值小於指定物件的屬性值。 (繼承自 TextPoint)。
	LineDown	將編輯點向下移動指定的行數。
	LineUp	將編輯點向上移動指定的行數。
	MoveToAbsoluteOffset	將作用點移至指定的以 1 起始的絕對字元位移數。
	MoveToLineAndOffset	將文件移動至指定的行及該行中字元位移的位置。
	MoveToPoint	將作用點移至指定的位置。
	NextBookmark	移至文件中下一個書籤的位置。
	OutlineSection	依據編輯點和指定的文字點或值建立外框區域。
	PadToColumn	以空白字元 (White Space) 填入緩衝區中目前的行一直到指定的欄為止。
	Paste	在目前位置插入剪貼簿內容。
	PreviousBookmark	將編輯點移至文件中前一個書籤的位置。
	ReadOnly	傳回指出在任一指定範圍中是否有唯讀文字的值。
	ReplacePattern	在指定的文字範圍中尋找比對模式，並以指定的文字取代它。
	ReplaceText	以指定的文字取代選取的文字。
	SetBookmark	在緩衝區中的目前行設定一個未命名的書籤。
	SmartFormat	依據目前的語言格式化指定的文字範圍。
	StartOfDocument	將物件移至文件的開頭。
	StartOfLine	將編輯點移動至緩衝區中目前行的開頭。
	TryToShow(vsPaneShowHow, Object)	嘗試顯示文字點的位置。
	TryToShow(vsPaneShowHow, Object)	嘗試顯示文字點的位置。 (繼承自 TextPoint)。
	Unindent	以指定的縮排層次數目從選取行移除縮排字元。
	WordLeft	將物件向左移動指定的文字數。
	WordRight	將物件向右移動指定的文字數。

回頁首

備註

EditPoint 物件與 TextSelection 物件相似，不過，前者適用於文字緩衝區內的資料，後者則適用於以程式碼編輯器顯示的文字。 兩者的差異在於緩衝區裡的文字不會受全域編輯器狀態 (例如自動換行和虛擬空間) 的影響。

任何嘗試修改文字文件的作業，如果會影響唯讀區塊內所含的任何字元，或者文件本身是唯讀，那麼作業便會失敗。

範例

Sub EditPointExample()
  ' Before running this example, open a text document.
  Dim objTD As TextDocument
  Dim objEP As EditPoint

  objTD = DTE.ActiveDocument.Object("TextDocument")
  objEP = objTD.StartPoint.CreateEditPoint
  objEP.Insert "Hello"
End Sub

請參閱

參考

EnvDTE 命名空間