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 起始。
	AtEndOfDocument	取得值，指出物件是否位於文件的結尾。
	AtEndOfLine	取得值，指出物件是否位於行的結尾。
	AtStartOfDocument	取得值，指出物件是否位於文件的開頭。
	AtStartOfLine	取得值，指出 EditPoint 物件是否位於行的開頭。
	CodeElement	取得在 EditPoint 位置的程式碼項目。
	DisplayColumn	取得 EditPoint 物件的資料行數目。
	DTE	取得最上層的擴充性物件。
	Line	取得 EditPoint 物件的行號。
	LineCharOffset	取得 EditPoint 物件的字元位移。
	LineLength	取得一行中的字元數目。
	Parent	取得 EditPoint 物件的直接上層父物件。

回頁首

方法

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