ITextRange：：Copy 方法 (tom.h)

發行項
03/03/2024

將文字複製到資料物件。

語法

HRESULT Copy(
  VARIANT *pVar
);

參數

pVar

類型： VARIANT*

複製的文字。 pVar-ppunkVal> 是 IDataObject 的 out 參數，前提是有下列條件：

pVar-vt> = (VT_UNKNOWN |VT_BYREF)
pVar 不是 Null
pVar-ppunkVal> 不是 Null

否則，會使用剪貼簿。

傳回值

類型： HRESULT

這個方法會傳回 HRESULT 值。如果成功，它會傳回 S_OK。否則會 傳回E_OUTOFMEMORY。

備註

ITextRange：：Cut、ITextRange：：Copy 和 ITextRange：:P aste 方法可讓您使用 IDataObject 在範圍物件上執行一般的 Cut、Copy 和 Paste 作業，藉此不會變更剪貼簿的內容。通常支援剪貼簿格式CF_TEXT和CF_RTF。此外，私人剪貼簿格式可用來參考文字解決方案自己的內部 RTF 格式。

若要複製和取代純文本，您可以使用 ITextRange：：GetText 和 ITextRange：：SetText 方法。若要將格式化文字從範圍 r1 複製到範圍 r2 而不使用剪貼簿，您可以使用 Copy 和 Paste ，也可以使用 ITextRange：：GetFormattedText 和 ITextRange：：SetFormattedText 方法，如下列 Microsoft Visual Basic 範例所示：

r2.GetFormattedText = r1.GetFormattedText

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	tom.h
Dll	Msftedit.dll