IMAGE 範例：建立非同步下載的 ActiveX 控制項

更新：2007 年 11 月

IMAGE 範例將示範如何使用 MFC 來建置 (Build) 可非同步下載資料的 ActiveX 控制項。這個控制項的屬性是根據 CDataPathProperty 類別建立的。

IMAGE 控制項可以顯示 BMP 檔案中的點陣圖影像 (但不支援色彩深度大於 8 位元的 BMP 檔案，因此無法顯示包含 256 色以上的檔案)。這個控制項的 ImagePath 屬性會提供影像的路徑。如果這個影像很大而且是經由慢速連結下載，則內建在能夠管理路徑的 CDataPathProperty 物件中的非同步支援，會在不封鎖其他處理的狀況下變成作用中，並將資料呈現至控制項的圖片程式碼。

這個控制項的特色在於有一個可以提供對 ImagePath 屬性和 AutoSize 屬性的存取權的簡單屬性頁。AutoSize 屬性在設定為 TRUE 時，會自動將控制項的大小嵌入為控制項所包含的影像的大小。如果 AutoSize 屬性為 FALSE，就會停用自動縮放。

影像控制項也會實作名為 ReadyState 的唯讀布林 (Boolean) 屬性。如果控制項已成功讀取並顯示影像資料流中的所有資料，ReadyState 就會為 TRUE。而在控制項完全初始化之前，ReadyState 為 FALSE。

如需將控制項加入工具箱、手動登錄控制項和使用 ActiveX 控制項測試容器的詳細資訊，請參閱控制項範例。

注意事項：
部分範例 (包括本範例) 尚未經過改寫，無法反映出目前在 Visual C++ 精靈、程式庫以及編譯器方面的變更，不過還是可以示範如何完成您要進行的工作。

安全性注意事項：
這個程式碼範例僅供概念說明之用，同時因為範例中的程式碼撰寫並沒有周全的顧及所有安全性問題，所以本範例不適用於實際執行的應用程式或網站中。如果使用者擅自將範例程式碼用於其他意圖而導致連帶事件或重大損害時，Microsoft 將不承擔任何責任。

若要取得範例和指示以便進行安裝：

• 按一下 Visual Studio [說明] 功能表上的 [範例]。

  如需詳細資訊，請參閱尋找範例檔案。

• 最新版的完整範例清單可從 Visual Studio 2008 範例網頁 (英文) 取得。

• 您也可以將範例置於電腦硬碟中。根據預設，範例和讀我檔案都會複製到 \Program Files\Visual Studio 9.0\Samples\ 下的資料夾中。對於所有的 Visual Studio Express 版，所有範例都可在線上找到。

請參閱

其他資源

MFC 範例