COleClientItem

COleClien COleClien COleClien

COleClientItem類定義了OLE項的包容器界面。OLE項代表由伺服器套用建立並維護的數據,它可以“無縫地”和文檔合成一體,成為“複合文檔”,而在用戶看來就如同一個單一的文檔一樣。“複合文檔”由OLE項和一包含文檔組成。
OLE項可以嵌入或者是連結到複合文檔中。當嵌入時,它作為複合文檔的一部分進行存儲。如果是連結的,數據存儲在由伺服器套用建立的分離的檔案中,而僅把指向它的一個連結存到複合文檔中。所有的OLE項包含有說明被調用來編輯它們的伺服器套用的信息。
COleClientItem定義了一些可重載的函式,用以回響從伺服器套用發出的請求;它們以通知的形式發生作用。這使得伺服器套用能將用戶編輯OLE項所作的修改通知包容器,或在用戶編輯的同時獲取相關的信息。COleClientItem能同 COleDocument, COleLinkingDoc或COleServerDoc等類一起使用。使用COleClientItem時, 從COleClientItem 派生一個類,執行OnChange成員函式,定義怎樣將對項的修改通知包容器。若要支持就地激活的功能,得重載OnGetItemPosition 成員函式。該函式提供了OLE項的顯示位置的有關信息。
注意:
OLE文檔中,“對象(objects)”指的是嵌入或連結項本身;而“類(classes)”則指的是項的類型。
#include
COleClientItem成員函式
構造函式
COleClientItem構造一個COleClientItem對象

創建
CreateFromClipboard從剪貼簿中創建一個嵌入項
CreateFromData從一個數據對象創建一個嵌入項
CanCreateFromData指示一個包容器套用是否能創建一個嵌入對象
CreateFromFile從一個檔案創建一個嵌入項
CreateStaticFromClipboard從剪貼簿創建一個靜態項
CreateStaticFromData從一個數據對象創建一個靜態項
CreateLinkFromClipboard從剪貼簿創建一個連結項
CreateLinkFromData從一個數據對象創建一個連結項
CanCreateLinkFromData指示一個包容器套用是否能創建一個嵌入對象
CreateLinkFromFile從一個檔案創建一個連結項
CreateNewItem啟動伺服器套用創建一個新的嵌入項
CreateCloneFrom創建一個已經存在的項的拷貝

狀態
GetLastStatus返回上一次OLE操作的狀態
GetIconFromRegistry檢索與特定CLSID伺服器相關的圖示的句柄
gettype返回OLE項的類型(嵌入、連結或靜態)
GetExtent返回OLE項的矩形邊界
GetCachedExtent返回OLE項的矩形邊界
GetClassID獲取給定項的類標識
GetUserType獲取描述項類型的字元串
GetIconicMetafile獲取用以描繪項的圖示的元檔案
SetIconicMetafile將用以描繪項的圖示的元檔案存入快取
GetDrawAspect獲取顯示項的當前視圖
SetDrawAspect設定顯示項的當前視圖
GetItemState獲取項的當前狀態
GetActiveView獲取項被就地激活的視圖
IsModified如果項在上次保存後被修改了,則返回TRUE
IsRunning如果項的伺服器套用正在運行,則返回TRUE
IsInPlaceActive如果項處於就地激活狀態,則返回TRUE
IsOpen如果項在伺服器套用中處於打開狀態,則返回TRUE

數據存取
GetDocument返回包含給定項的COleDocument對象
AttachDataObject存取OLE對象中的數據

對象轉換
ConvertTo轉換項到另一類型
ActivateAs激活項為另一類型
Reload在調用ActivateAs後重載項

剪貼簿操作
CanPaste指示剪貼簿中是否包含有可重載或靜態的OLE項
CanPasteLink指示剪貼簿中是否包含有可連結的OLE項
DoDragDrop執行一次拖放操作
CopyToClipboard將OLE項複製到剪貼簿中
GetClipboardData獲取剪貼簿中的數據。這些數據可能是調用CopyToClipboard成員函式後放置在剪貼簿中的

一般操作
Close關閉OLE項指向伺服器的一個連結,但不銷毀OLE項本身
Release釋放OLE連結項的連結,如果處於打開狀態則關閉它。釋放操作也不銷毀客戶項本身
Delete如果是一個連結的OLE項,則刪除或關閉它
Draw繪製OLE項
Run運行和項相關的套用
SetPrintDevice設定該客戶項的列印目標設備

激活
Activate打開OLE項進行操作,並執行指定的動作
DoVerb執行指定動作
deactivate釋放激活項
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當項位置改變時,由框架調用

相關詞條

相關搜尋

熱門詞條

聯絡我們