hhsupp.cpp

一个统计文件大小和程序信息的插件程序(vc或vc.net下使用)

        szHelpFile += '>';
        szHelpFile += pszHelpWndType;
    }

    HtmlHelp(hWnd, szHelpFile, HH_HELP_CONTEXT, helpID);
}

// Finds the program's default .chm file (i.e. MyApp.chm for the
// application MyApp).
static CString& GetHelpFile()
{
    static CString CachedName;

    if (CachedName.IsEmpty())
    {
        CachedName = AfxGetApp()->m_pszHelpFilePath;

        // does the application still think we're using a WinHelp 
        // help file?
        if (CachedName.Right(3) == _T("HLP"))
        {
            // yes - change to HTML help file
            LPTSTR pszHelpFilePath = 
                (LPTSTR)AfxGetApp()->m_pszHelpFilePath;
            _tcscpy(pszHelpFilePath + _tcslen(pszHelpFilePath) - 3, 
                _T("chm"));
            CachedName = pszHelpFilePath;
        }

        HANDLE fh = CreateFile(CachedName, GENERIC_READ, 
            FILE_SHARE_READ, NULL, OPEN_EXISTING, 0, NULL);
    
        if (fh == INVALID_HANDLE_VALUE)  // not found?
        {
            // search for help file on path

            TCHAR path_buffer[2048];
            TCHAR drive[_MAX_DRIVE];
            TCHAR dir[_MAX_DIR];
            TCHAR fname[_MAX_FNAME];
            TCHAR ext[_MAX_EXT];
            LPTSTR p;
            int len;
        
            _tsplitpath(CachedName, drive, dir, fname, ext);
            len = SearchPath(NULL, fname, ext, sizeof(path_buffer), 
                path_buffer, &p);

            if (len == 0)
            {
                CachedName.Empty();
            }
            else
            {
                CachedName = path_buffer;
            }
        }
        else
        {
            CloseHandle(fh);
        }
    }

    // Unlike WinHelp, HTML Help is not smart enough to ask the user
    // for the location of the help file if it can't find it in the
    // program-specified location.  The following code will do just
    // just that.
    if (CachedName.IsEmpty()) // not found? 
    {
        // build message box test
        CString msg, file;
        int p;
        file = AfxGetApp()->m_pszHelpFilePath;
        if ((p = file.ReverseFind('\\')) >= 0) 
        {
            file = file.Mid(p + 1);
        }

        // ask user: will you locate the file?
        msg.Format(FILE_NOT_FOUND, file);
        if (AfxMessageBox(msg, MB_YESNO | MB_ICONEXCLAMATION) 
            == IDYES)
        {
            // yes - activate standard file selection dialog
            CFileDialog dlg(TRUE, _T(".chm"), file, 
                OFN_FILEMUSTEXIST | OFN_PATHMUSTEXIST | 
                OFN_HIDEREADONLY,
                _T("HTML Help Files (*.chm)|*.chm||"));
            if (dlg.DoModal() == IDOK)
            {
                CachedName = dlg.GetFileName();
            }
        }
    }

    return CachedName;
}


#define IMPLEMENT_CLASS(classname, baseclass)                      \
                                                                   \
IMPLEMENT_DYNCREATE(classname, baseclass)                          \
                                                                   \
const DWORD classname::m_dwHelpIDs[] = { 0, 0 };                   \
                                                                   \
BEGIN_MESSAGE_MAP(classname, baseclass)                            \
    ON_WM_CONTEXTMENU()                                            \
    ON_WM_HELPINFO()                                               \
	ON_MESSAGE(WM_COMMANDHELP, OnCommandHelp)                      \
	ON_COMMAND(ID_HELP, OnIDHelp)                                  \
END_MESSAGE_MAP()                                                  \
                                                                   \
void classname::OnIDHelp()                                         \
{                                                                  \
    OnCommandHelp(0, 0);                                           \
}                                                                  \
                                                                   \
LRESULT classname::OnCommandHelp(WPARAM wParam, LPARAM lParam)     \
{                                                                  \
    if (m_iHelpID >= 0)                                            \
    {                                                              \
        ShowHTMLHelp(this->m_hWnd, m_iHelpID);                     \
        return TRUE;                                               \
    }                                                              \
    return FALSE;                                                  \
}                                                                  \
                                                                   \
void classname::OnContextMenu(CWnd *pWnd, CPoint point)            \
{                                                                  \
    DoContextMenu(this, GetHelpIDs(), pWnd, point,                 \
        m_bAllowImplicit);                                         \
}                                                                  \
                                                                   \
BOOL classname::OnHelpInfo(HELPINFO* pHelpInfo)                    \
{                                                                  \
    return DoHelpInfo(this, GetHelpIDs(), pHelpInfo,               \
        m_bAllowImplicit);                                         \
}


IMPLEMENT_CLASS(CHHDialog,   CDialog);
IMPLEMENT_CLASS(CHHPropPage, CPropertyPage);

void CHHPropPage::CommonInit()
{
    if (m_iHelpID >= 0)
        m_psp.dwFlags |= PSP_HASHELP;
    else
        m_psp.dwFlags &= ~PSP_HASHELP;
}


////////////////////////////////////////////////////////////////////
// CHHPropSheet

IMPLEMENT_DYNAMIC(CHHPropSheet, CPropertySheet)

BEGIN_MESSAGE_MAP(CHHPropSheet, CPropertySheet)
    //{{AFX_MSG_MAP(CHHPropSheet)
    //}}AFX_MSG_MAP
END_MESSAGE_MAP()

////////////////////////////////////////////////////////////////////
// CHHPropSheet message handlers

BOOL CHHPropSheet::OnInitDialog()
{
    BOOL bResult = CPropertySheet::OnInitDialog();
    ModifyStyleEx(0, WS_EX_CONTEXTHELP);
    return bResult;
}

int CHHPropSheet::DoModal()
{
    CHHPropPage *pPage;

    m_psh.dwFlags &= ~PSH_HASHELP;

    for (int i = 0; i < GetPageCount(); i++)
    {
        pPage = (CHHPropPage *)GetPage(i);
        ASSERT(pPage->IsKindOf(RUNTIME_CLASS(CHHPropPage)));
        if (pPage->m_iHelpID < 0)
        {
            pPage->m_iHelpID = m_iHelpID;
        }
        if (pPage->m_iHelpID >= 0)
        {
            pPage->m_psp.dwFlags |= PSP_HASHELP;
            m_psh.dwFlags |= PSH_HASHELP;
        }
    }

    return CPropertySheet::DoModal();
}

void CHHPropSheet::AddPage(CHHPropPage* pPage)
{
    if (pPage->m_iHelpID < 0)
    {
        pPage->m_iHelpID = m_iHelpID;
    }

    if (pPage->m_iHelpID >= 0)
    {
        pPage->m_psp.dwFlags |= PSP_HASHELP;
    }

    CPropertySheet::AddPage(pPage);
}


void ShowHTMLHelp(HWND hWnd, DWORD helpID, LPCTSTR pszHelpWndType,
    LPCTSTR pszHelpFile /*=APP_CHM*/)
{
    ShowHelp(hWnd, 0, helpID, pszHelpWndType, pszHelpFile);
}

bool RegisterHHWindowType(int n, LPCTSTR name)
{
    CString val;

    if (s_WinTypeMap.Lookup(n, val) != 0)
        return false;  // already exists

    s_WinTypeMap[n] = name;

    return true;
}


// The following function mimics the HtmlHelp function provided by
// HtmlHelp.lib.  This allows us to call the HTML Help control
// without linking to HtmlHelp.lib.
// "HtmlHelp" is actually a macro alias that is mapped to either 
// HtmlHelpA or HtmlHelpW (depending on whether or not Unicode is 
// used).  Notice the use of LPCTSTR which allows this function to 
// compile correctly as either version.
HWND WINAPI HtmlHelp(HWND hwndCaller, LPCTSTR pszFile, 
                     UINT uCommand, DWORD_PTR dwData)
{
    if (s_pfnHtmlHelp)
    {
        // use program's default .chm?
        if (pszFile == APP_CHM) 
        {
            pszFile = GetHelpFile();
            if (pszFile == NULL  ||  !*pszFile) // not found? 
                return NULL;
        }

        return (*s_pfnHtmlHelp)(hwndCaller, pszFile, uCommand, 
            dwData);
    }
    else
    {
        TRACE(_T("An HTML Help function was called, but the ")
              _T("library isn't loaded."));
    }

    return NULL;
}

void WinHelpToHTMLHelp(CWinApp *pApp, DWORD dwData, UINT nCmd)
{
    HWND hWnd = pApp->GetMainWnd()->m_hWnd;

    // translate WinHelp commands to HTML Help commands

    switch (nCmd)
    {
        case HELP_CONTEXT:
            dwData &= 0xFFFF;  // remove MFC's hi-word addition
            HtmlHelp(hWnd, APP_CHM, HH_HELP_CONTEXT, dwData);
            break;

        case HELP_FINDER:
            dwData &= 0xFFFF;  // remove MFC's hi-word addition
            HtmlHelp(hWnd, APP_CHM, HH_HELP_FINDER, dwData);
            break;

        case HELP_QUIT:
            HtmlHelp(NULL, NULL, HH_CLOSE_ALL, 0);

        case HELP_CONTEXTMENU:
            HtmlHelp(hWnd, APP_CHM, HH_TP_HELP_CONTEXTMENU, dwData);
            break;

        case HELP_WM_HELP:
            HtmlHelp(hWnd, APP_CHM, HH_TP_HELP_WM_HELP, dwData);
            break;

        default:
            ASSERT(0);  // unsupported WinHelp command
    }
}