萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML 腳本教學

Windows Mobile 開發:嵌入 HTML 控件(DHTML 控件)完整實作指南

適用場景

在 Windows Mobile/CE 應用程式中需要內嵌類 IE 瀏覽功能、顯示 HTML 內容、支援基本腳本與圖片渲染時,可使用 HTML 控件(MSHTML / DHTML 控件)。

注意:不完全支援 WAP 協議,實際上由 IE 核心解析渲染。

核心步驟(MFC C++ 範例)

1. 註冊控件

#include <Htmlctrl.h>

// 在 OnInitDialog 或初始化函式中
VERIFY(InitHTMLControl(AfxGetInstanceHandle()));

2. 建立控件視窗

DWORD dwStyle = WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS;
RECT rect;
GetClientRect(&rect);

m_hHtmlWnd = ::CreateWindow(
    DISPLAYCLASS, NULL, dwStyle,
    rect.left, rect.top, rect.right, rect.bottom,
    m_hWnd, 0, AfxGetInstanceHandle(), NULL);

::SetWindowLong(m_hHtmlWnd, GWL_ID, 12321);
::SetFocus(m_hHtmlWnd);
::SendMessage(m_hHtmlWnd, WM_SETTEXT, 0, (LPARAM)(LPCTSTR)_T(""));

m_hHtmlWnd 為 Dialog 的 HWND 成員變數。

3. 處理通知訊息(WM_NOTIFY)

switch (message) {
  case WM_NOTIFY: {
    NM_HTMLVIEW* pnm = (NM_HTMLVIEW*)lParam;
    switch (pnm->hdr.code) {
      case NM_HOTSPOT:      // 使用者點擊連結
        // pnm->szTarget 取得目標 URL
        break;
      case NM_DOCUMENTCOMPLETE: // 文件載入完成
        break;
      case NM_INLINE_IMAGE: // 需顯示圖片
        return TRUE; // 表示自行處理圖片
    }
  } break;
}

4. 載入 HTML 內容

// 取得 HTML 字串後
::SendMessage(m_hHtmlWnd, WM_SETTEXT, 0, (LPARAM)(LPCTSTR)htmlContent);

控件會自動解析 HTML 元素。

5. 處理圖片顯示(NM_INLINE_IMAGE)

// 取得圖片位圖 hBitmap 後
INLINEIMAGEINFO imageInfo = {0};
imageInfo.dwCookie = pnm->dwCookie;
imageInfo.bOwnBitmap = FALSE;
imageInfo.hbm = hBitmap;

BITMAP bmInfo;
GetObject(hBitmap, sizeof(BITMAP), (LPBYTE)&bmInfo);
imageInfo.iOrigWidth = bmInfo.bmWidth;
imageInfo.iOrigHeight = bmInfo.bmHeight;

::SendMessage(pnm->hdr.hwndFrom, DTM_SETIMAGE, 0, (LPARAM)&imageInfo);
  • 若圖片載入失敗,改送 DTM_IMAGEFAIL 顯示預設叉叉圖示
  • 使用 SHLoadImageFile 載入圖片後,必須呼叫 DeleteObject 釋放位圖,否則記憶體洩漏(MSDN 未明確說明)

6. 重要:訊息處理後必須返回 TRUE/FALSE

若處理了 NM_HOTSPOT 或 NM_INLINE_IMAGE,必須返回 TRUE 或 FALSE,否則控件會再重複處理一次。

關鍵結構體

  • NM_HTMLVIEW:包含 hdr(標準 NMHDR)、szTarget(目標 URL/圖片路徑)、dwCookie(圖片識別碼)
  • INLINEIMAGEINFO:圖片資訊結構,含 hbm、尺寸、Cookie

開發提醒

  • HTML 控件功能有限,不支援完整 CSS/JS,複雜頁面渲染可能異常
  • 記憶體管理需謹慎,特別是位圖物件
  • 考慮改用 WebView2 (Chromium) 或 Edge WebView 取得現代 Web 相容性
copyright © 萬盛學電腦網 all rights reserved