閱讀英文

共用方式為


使用拖放和剪貼簿傳輸 Shell 物件

許多應用程式可讓使用者使用滑鼠拖放資料,或使用剪貼簿將資料傳輸到另一個應用程式。 許多可以傳輸的資料類型包括 Shell 物件,例如檔案或資料夾。 殼層資料傳輸可以在兩個應用程式之間進行,但使用者也可以從桌面或 Windows 檔案總管來回傳輸 Shell 資料。

雖然檔案是最常傳輸的 Shell 物件,但殼層資料傳輸可能會牽涉到 Shell 命名空間中找到的任何各種物件。 例如,您的應用程式可能需要將檔案傳送至虛擬資料夾,例如回收站,或接受來自非 Microsoft 命名空間副檔名的物件。 如果您要實作命名空間延伸模組,它必須能夠正常作為卸載來源和目標。

本檔討論應用程式如何使用 Shell 物件實作拖放和剪貼簿資料傳輸。

拖放如何與殼層物件搭配運作

應用程式通常需要為使用者提供傳輸殼層資料的方式。 部份範例如下:

  • 從 Windows 檔案總管或桌面拖曳檔案,並將它放在應用程式上。
  • 將檔案複製到 Windows 檔案總管中的剪貼簿,並將其貼到應用程式中。
  • 將檔案從應用程式拖曳至回收站。

如需如何處理這些案例和其他案例的詳細討論,請參閱 處理殼層資料傳輸案例。 本檔著重于 Shell 資料傳輸背後的一般原則。

Windows 提供兩種標準方式,讓應用程式傳輸殼層資料:

  • 使用者剪下或複製 Shell 資料,例如一或多個檔案至剪貼簿。 另一個應用程式會從剪貼簿擷取資料。
  • 使用者拖曳代表來源應用程式資料的圖示,並將圖示放在目標擁有的視窗上。

在這兩種情況下,傳輸的資料會包含在 資料物件中。 資料物件是元件物件模型 (COM) 公開 IDataObject 介面的物件。 實際上,所有 Shell 資料傳輸都必須遵循三個基本步驟:

  1. 來源會建立代表要傳送之資料的資料物件。
  2. 目標會接收資料物件的 IDataObject 介面指標。
  3. 目標會呼叫 IDataObject 介面,以從中擷取資料。

剪貼簿和拖放資料傳輸之間的差異主要在於 如何將 IDataObject 指標從來源傳輸到目標。

剪貼簿資料傳輸

剪貼簿是傳輸 Shell 資料最簡單的方式。 基本程式類似于標準剪貼簿資料傳輸。 不過,因為您要傳送資料物件的指標,而不是資料本身,所以您必須使用 OLE 剪貼簿 API,而不是標準剪貼簿 API。 下列程式概述如何使用 OLE 剪貼簿 API,透過剪貼簿傳輸殼層資料:

  1. 資料來源會建立資料物件來包含資料。
  2. 資料來源會呼叫 OleSetClipboard,將指標放在剪貼簿上的資料物件的 IDataObject 介面。
  3. 目標會呼叫 OleGetClipboard 來擷取資料物件的 IDataObject 介面指標。
  4. 目標會藉由呼叫 IDataObject::GetData 方法來擷取資料。
  5. 使用某些 Shell 資料傳輸時,目標可能也需要呼叫資料物件的 IDataObject::SetData 方法,以針對資料傳輸結果提供資料物件的意見反應。 如需這類作業的範例,請參閱 處理優化移動作業

拖放資料傳輸

雖然實作較為複雜,但拖放資料傳輸對於剪貼簿有一些顯著的優點:

  • 拖放傳輸可以透過簡單的滑鼠移動來完成,讓作業比剪貼簿更有彈性且直覺。
  • 拖放可為使用者提供作業的視覺標記法。 使用者可以遵循圖示,因為它從來源移至目標。
  • 拖放功能會在資料可用時通知目標。

拖放作業也會使用資料物件來傳輸資料。 不過,卸載來源必須提供剪貼簿傳輸所需的功能:

  • 卸載來源也必須建立公開 IDropSource 介面的物件。 當作業正在進行時,系統會使用 IDropSource 與來源通訊。
  • 拖放資料物件負責追蹤資料指標移動,並顯示圖示來代表資料物件。

卸載目標也必須提供比處理剪貼簿傳輸所需的功能更多:

  • 卸載目標必須公開 IDropTarget 介面。 當游標位於目標視窗上方時,系統會使用 IDropTarget 來提供目標,並提供資料指標位置等資訊,並在卸載資料時通知它。
  • 卸載目標必須藉由呼叫 RegisterDragDrop向系統註冊本身。 此函式會為系統提供目標視窗的控制碼,以及目標應用程式的 IDropTarget 介面指標。

注意

針對拖放作業,您的應用程式必須使用 OleInitialize初始化 COM,而不是 CoInitialize

 

下列程式概述通常用來以拖放方式傳輸殼層資料的基本步驟:

  1. 目標會呼叫 RegisterDragDrop ,為系統提供其 IDropTarget 介面的指標,並將視窗註冊為置放目標。
  2. 當使用者啟動拖放作業時,來源會建立資料物件,並藉由呼叫DoDragDrop來起始拖曳迴圈
  3. 當游標位於目標視窗上方時,系統會呼叫其中一個目標的 IDropTarget 方法來通知目標。 當游標進入目標視窗時,系統會呼叫 IDropTarget::D ragEnter ,並在游標通過目標視窗時呼叫 IDropTarget::D ragOver 。 這兩種方法都會提供目前游標位置的置放目標,以及鍵盤輔助按鍵的狀態,例如 CTRL 或 ALT。 當游標離開目標視窗時,系統會呼叫 IDropTarget::D ragLeave來通知目標。 當上述任一方法傳回時,系統會呼叫 IDropSource 介面,以將傳回值傳遞至來源。
  4. 當使用者放開滑鼠按鍵以卸載資料時,系統會呼叫目標的 IDropTarget::D rop 方法。 方法的參數中是資料物件的 IDataObject 介面指標。
  5. 目標會呼叫資料物件的 IDataObject::GetData 方法來擷取資料。
  6. 透過某些殼層資料傳輸,目標可能也需要呼叫資料物件的 IDataObject::SetData 方法,以針對資料傳輸的結果提供意見反應給來源。
  7. 當目標完成資料物件時,它會從 IDropTarget::D rop傳回。 系統會傳回來源的 DoDragDrop 呼叫,以通知來來源資料傳輸已完成。
  8. 根據特定的 資料傳輸案例,來源可能需要根據 DoDragDrop 傳回的值,以及目標傳遞給資料物件的值,採取其他動作。 例如,移動檔案時,來源必須檢查這些值,以判斷它是否必須刪除原始檔案。
  9. 來源會釋放資料物件。

雖然上述程式提供良好的殼層資料傳輸一般模型,但殼層資料物件中有許多不同類型的資料可以包含在 Shell 資料物件中。 您的應用程式可能需要處理的一些不同資料傳輸案例。 每個資料類型和案例都需要稍微不同的方法,才能執行程式中的三個主要步驟:

  • 來源如何建構資料物件以包含 Shell 資料。
  • 目標如何從資料物件擷取 Shell 資料。
  • 來源如何完成資料傳輸作業。

Shell Data Object提供來源如何建構 Shell 資料物件的一般討論,以及如何由目標處理該資料物件。 處理殼層資料傳輸案例 會詳細討論如何處理一些常見的殼層資料傳輸案例。