複製鏈接
請複製以下鏈接發送給好友

COleClientItem

鎖定
COleClientItem類定義了OLE項的包容器界面。OLE項代表由服務器應用建立並維護的數據,它可以“無縫地”和文檔合成一體,成為“複合文檔”,而在用户看來就如同一個單一的文檔一樣。“複合文檔”由OLE項和一包含文檔組成。
中文名
COleClientItem
正    文
OLE項可以嵌入或者是鏈接到
注    意
OLE文檔中,“對象(objects
創    建
從剪貼板中創建一個嵌

目錄

COleClientItem簡介

OLE項可以嵌入或者是鏈接到複合文檔中。當嵌入時,它作為複合文檔的一部分進行存儲。如果是鏈接的,數據存儲在由服務器應用建立的分離的文件中,而僅把指向它的一個鏈接存到複合文檔中。所有的OLE項包含有説明被調用來編輯它們的服務器應用的信息。
COleClientItem定義了一些可重載的函數,用以響應從服務器應用發出的請求;它們以通知的形式發生作用。這使得服務器應用能將用户編輯OLE項所作的修改通知包容器,或在用户編輯的同時獲取相關的信息。COleClientItem能同COleDocument, COleLinkingDoc或COleServerDoc等類一起使用。使用COleClientItem時, 從COleClientItem 派生一個類,執行OnChange成員函數,定義怎樣將對項的修改通知包容器。若要支持就地激活的功能,得重載OnGetItemPosition 成員函數。該函數提供了OLE項的顯示位置的有關信息。

COleClientItem注意

OLE文檔中,“對象(objects)”指的是嵌入或鏈接項本身;而“類(classes)”則指的是項的類型。
#include <afxole.h>
COleClientItem成員函數

COleClientItem構造函數

構造一個COleClientItem對象
創建
CreateFromClipboard
從剪貼板中創建一個嵌入項
CreateFromData
從一個數據對象創建一個嵌入項
CanCreateFromData
指示一個包容器應用是否能創建一個嵌入對象
CreateFromFile
從一個文件創建一個嵌入項
CreateStaticFromClipboard
從剪貼板創建一個靜態項
CreateStaticFromData
從一個數據對象創建一個靜態項
CreateLinkFromClipboard
從剪貼板創建一個鏈接項
CreateLinkFromData
從一個數據對象創建一個鏈接項
CanCreateLinkFromData
指示一個包容器應用是否能創建一個嵌入對象
CreateLinkFromFile
從一個文件創建一個鏈接項
CreateNewItem
啓動服務器應用創建一個新的嵌入項
CreateCloneFrom
創建一個已經存在的項的拷貝
狀態
GetLastStatus
返回上一次OLE操作的狀態
GetIconFromRegistry
檢索與特定CLSID服務器相關的圖標的句柄
返回OLE項的類型(嵌入、鏈接或靜態)
GetExtent
返回OLE項的矩形邊界
GetCachedExtent
返回OLE項的矩形邊界
GetClassID
獲取給定項的類標識
GetUserType
獲取描述項類型的字符串
GetIconicMetafile
獲取用以描繪項的圖標的元文件
SetIconicMetafile
將用以描繪項的圖標的元文件存入緩存
GetDrawAspect
獲取顯示項的當前視圖
SetDrawAspect
設置顯示項的當前視圖
GetItemState
獲取項的當前狀態
獲取項被就地激活的視圖
IsModified
如果項在上次保存後被修改了,則返回TRUE
IsRunning
如果項的服務器應用正在運行,則返回TRUE
IsInPlaceActive
如果項處於就地激活狀態,則返回TRUE
IsOpen
如果項在服務器應用中處於打開狀態,則返回TRUE
數據存取
GetDocument
返回包含給定項的COleDocument對象
AttachDataObject
存取OLE對象中的數據
對象轉換
ConvertTo
轉換項到另一類型
ActivateAs
激活項為另一類型
在調用ActivateAs後重載項
剪貼板操作
CanPaste
指示剪貼板中是否包含有可重載或靜態的OLE項
CanPasteLink
指示剪貼板中是否包含有可鏈接的OLE項
DoDragDrop
執行一次拖放操作
CopyToClipboard
將OLE項複製到剪貼板中
獲取剪貼板中的數據。這些數據可能是調用CopyToClipboard成員函數後放置在剪貼板中的
一般操作
關閉OLE項指向服務器的一個鏈接,但不銷燬OLE項本身
釋放OLE鏈接項的鏈接,如果處於打開狀態則關閉它。釋放操作也不銷燬客户項本身
如果是一個鏈接的OLE項,則刪除或關閉它
繪製OLE項
運行和項相關的應用
SetPrintDevice
設置該客户項的打印目標設備
激活
打開OLE項進行操作,並執行指定的動作
DoVerb
執行指定動作
釋放激活項
DeactivateUI
恢復包容器應用的用户界面到初始狀態
ReactivateAndUndo
重新激活項,並撤消上次的就地編輯操作
SetItemRects
設置項的矩形邊界
GetInPlaceWindow
返回項的就地編輯窗口的指針
嵌入對象操作
SetHostNames
編輯OLE項,設置服務器顯示的名字
SetExtent
設置OLE項的邊界矩形
鏈接對象操作和狀態
GetLinkUpdateOptions
返回鏈接項的更新模式 (高級特性)
SetLinkUpdateOptions
設置鏈接項的更新模式 (高級特性)
UpdateLink
更新項的描述緩存
IsLinkUpToDate
如果一個鏈接項和它的資源文檔是最新的,則返回TRUE
OnChange
服務器改變OLE項時調用。要求重實現
OnGetClipboardData
框架調用以獲取複製到剪貼板的數據
OnInsertMenus
框架調用以創建一個混合菜單條
OnSetMenu
框架調用以安裝和刪除一個混合菜單
OnRemoveMenus
框架調用以從一個混合菜單中刪除包容器菜單
OnUpdateFrameTitle
框架調用以更新框架窗口的標題欄
OnShowControlBars
框架調用以顯示或隱藏控件條
OnGetItemPosition
框架調用以項的相對視圖的位置
OnScrollBy
框架調用以滾動項到視圖內
OnDeactivateUI
當服務器刪除用户界面時,由框架調用
OnDiscardUndoState
框架調用以丟棄項的撤消操作狀態信息
OnDeactivateAndUndo
框架調用以在激活後進行撤消操作
OnShowItem
框架調用以顯示OLE項
CanActivate
框架調用以判定是否允許就地激活
OnActivate
框架調用以通知已經激活的項
OnActivateUI
框架調用以通知已經激活的並且需要顯示用户界面的項
OnGetClipRect
框架調用以取得項的剪切矩形座標
OnGetWindowContext
當項就地激活時,由框架調用
OnDeactivate
當項取消時,由框架調用
OnChangeItemPosition
當項位置改變時,由框架調用