您现在的位置：程式碼之家 >> 編程語言 > >> C語言 >> VC >> 關於VC++

Windows Band 對象完整指南：Explorer Bar、Tool Band、Desk Band 建立與註冊

編輯：關於VC++

三種 Band 類型

類型	容器	引入版本	典型用途
Explorer Bar (垂直/水平)	IE / 總管	IE4	搜尋、收藏夾、歷史、自訂資訊面板
Tool Band	IE ReBar	IE5	單選工具列、自訂工具列
Desk Band	Shell (工作列)	IE4	桌面浮動視窗、工作列工具列

必須實作的 COM 介面

IUnknown, IClassFactory
IDeskBand (繼承 IDockingWindow → IOleWindow)
IObjectWithSite
IPersistStream
可選：IInputObject (接受輸入焦點)、IContextMenu (右鍵選單)

關鍵註冊差異：CATID 決定類型與容器

Band 類型	CATID
垂直 Explorer Bar	CATID_InfoBand
水平 Explorer Bar	CATID_CommBand
Desk Band	CATID_DeskBand

Tool Band 不需 CATID，改在 HKLM\Software\Microsoft\Internet Explorer\Toolbar\{CLSID} 註冊。

CATID 註冊代碼

BOOL RegisterCat(CLSID clsid, CATID catid) {
    ICatRegister* pcr;
    CoCreateInstance(CLSID_StdComponentCategoriesMgr, nullptr,
        CLSCTX_INPROC_SERVER, IID_ICatRegister, (void**)&pcr);
    HRESULT hr = pcr->RegisterClassImplCategories(clsid, 1, &catid);
    pcr->Release();
    return SUCCEEDED(hr);
}

IObjectWithSite::SetSite 關鍵流程

STDMETHODIMP SetSite(IUnknown* punkSite) {
    if (m_pSite) m_pSite->Release(), m_pSite = nullptr;
    if (!punkSite) return S_OK;

    IOleWindow* pWin;
    if (SUCCEEDED(punkSite->QueryInterface(IID_IOleWindow, (void**)&pWin))) {
        pWin->GetWindow(&m_hwndParent);
        pWin->Release();
    }
    if (!m_hwndParent) return E_FAIL;

    // 建立子視窗
    CreateChildWindow();

    // 取得 IInputObjectSite
    punkSite->QueryInterface(IID_IInputObjectSite, (void**)&m_pSite);
    return S_OK;
}

IDeskBand::GetBandInfo 回應容器查詢

STDMETHODIMP GetBandInfo(DWORD dwBandID, DWORD dwViewMode, DESKBANDINFO* pdbi) {
    m_dwBandID = dwBandID; m_dwViewMode = dwViewMode;
    if (pdbi->dwMask & DBIM_MINSIZE) { pdbi->ptMinSize = {30, 30}; }
    if (pdbi->dwMask & DBIM_MAXSIZE) { pdbi->ptMaxSize = {-1, -1}; }
    if (pdbi->dwMask & DBIM_TITLE)   { lstrcpyW(pdbi->wszTitle, L"My Band"); }
    if (pdbi->dwMask & DBIM_MODEFLAGS) { pdbi->dwModeFlags = DBIMF_VARIABLEHEIGHT; }
    return S_OK;
}