Source code of Windows XP (NT5)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

293 lines
10 KiB

// Copyright 1995-1997 Microsoft Corporation. All Rights Reserved.
#if _MSC_VER > 1000
#pragma once
#endif
#ifndef _HHCTRL_H_
#define _HHCTRL_H_
#include "IPServer.H"
#include "CtrlObj.H"
#ifndef __IHHCtrl_FWD_DEFINED__
#include "hhIfc.H"
#endif
#include "Dispids.H"
#include "internet.h"
#include <commctrl.h>
#include "sitemap.h"
#include "hhamsgs.h"
#include "cindex.h"
#include "ctoc.h"
#include "prthook.h"
#include <mshtml.h>
typedef struct tagHHCtrlCTLSTATE
{
char *bmpPath;
DATE endDate;
} HHCTRLCTLSTATE;
enum BMP_DOWNLOAD_STATES
{
bdsNoBitsYet,
bdsGotFileHeader,
bdsGotBitmapInfo,
bdsGettingBits,
bdsBitsAreDone
};
class CHtmlHelpControl; // forward reference
class IWebBrowserAppImpl; // forward reference
HWND JumpToUrl(IUnknown* pUnkOuter, HWND hwndParent, SITEMAP_ENTRY* pSiteMapEntry, CInfoType *pInfoType, CSiteMap* pSiteMap, SITE_ENTRY_URL* pUrl, IWebBrowserAppImpl* pWebApp = NULL);
#if 0 //enable for subset filtering
BOOL ChooseInformationTypes(CInfoType *pInfoType, CSiteMap* pSiteMap, HWND hwndParent, CHtmlHelpControl* phhctrl, CHHWinType* m_phh);
#else
BOOL ChooseInformationTypes(CInfoType *pInfoType, CSiteMap* pSiteMap, HWND hwndParent, CHtmlHelpControl* phhctrl);
#endif
void DisplayAuthorInfo(CInfoType *pInfoType, CSiteMap* pSiteMap, SITEMAP_ENTRY* pSiteMapEntry, HWND hwndParent, CHtmlHelpControl* phhctrl);
HRESULT OnWordWheelLookup( PSTR pszKeywords, CExCollection* pExCollection,
PCSTR pszDefaultTopic = NULL,
POINT* ppt = NULL, HWND hWndParent = NULL,
BOOL bDialog = TRUE, BOOL bKLink = TRUE,
BOOL bTestMode = FALSE, BOOL bSkipCurrent = FALSE,
BOOL bAlwaysShowList = FALSE,
BOOL bAlphaSortHits = TRUE,
PCSTR pszWindow = NULL);
class CHtmlHelpControl : public CInternetControl, public IHHCtrl,
public ISupportErrorInfo MI2_COUNT( CHtmlHelpControl )
{
public:
// IUnknown methods
DECLARE_STANDARD_UNKNOWN();
// IDispatch methods
DECLARE_STANDARD_DISPATCH();
// ISupportErrorInfo methods
DECLARE_STANDARD_SUPPORTERRORINFO();
// IHHCtrl methods
// OLE Control stuff follows:
STDMETHOD(SetObjectRects)(LPCRECT lprcPosRect,LPCRECT lprcClipRect) ;
CHtmlHelpControl(IUnknown *pUnkOuter);
virtual ~CHtmlHelpControl();
#ifndef PPGS
STDMETHOD(DoVerb)(LONG iVerb, LPMSG lpmsg, IOleClientSite *pActiveSite, LONG lindex,
HWND hwndParent, LPCRECT lprcPosRect);
#endif
STDMETHOD_(void, OnClick)(THIS);
// static creation function. all controls must have one of these!
static IUnknown *Create(IUnknown *);
private:
// overridables that the control must implement.
STDMETHOD(LoadBinaryState)(IStream *pStream);
STDMETHOD(SaveBinaryState)(IStream *pStream);
STDMETHOD(LoadTextState)(IPropertyBag *pPropertyBag, IErrorLog *pErrorLog);
STDMETHOD(SaveTextState)(IPropertyBag *pPropertyBag, BOOL fWriteDefault);
STDMETHOD(OnDraw)(DWORD dvaspect, HDC hdcDraw, LPCRECTL prcBounds, LPCRECTL prcWBounds, HDC hicTargetDev, BOOL fOptimize);
STDMETHOD(SetClientSite)(IOleClientSite *pClientSite);
// Exposed methods
STDMETHOD(Click)();
STDMETHOD(HHClick)();
STDMETHOD(Print)();
STDMETHOD(syncURL)(BSTR pszUrl);
STDMETHOD(TCard)(WPARAM wParam, LPARAM lParam);
STDMETHOD(get_Image) (THIS_ BSTR* path);
STDMETHOD(put_Image)(BSTR path);
STDMETHOD(TextPopup)(BSTR pszText, BSTR pszFont, int horzMargins, int vertMargins, COLORREF clrForeground, COLORREF clrBackground);
LRESULT WindowProc(UINT msg, WPARAM wParam, LPARAM lParam);
void JumpToUrl(SITEMAP_ENTRY* pSiteMapEntry, CSiteMap* pSiteMap, SITE_ENTRY_URL* pUrl = NULL);
void OnLButton(WPARAM wParam, LPARAM lParam);
BOOL OnSetExtent(const SIZE *pSize);
void ProcessPadding(PCSTR psz);
BOOL RegisterClassData(void);
void SetActionData(PCSTR psz);
BOOL AfterCreateWindow(void);
BOOL BeforeCreateWindow(DWORD *pdwWindowStyle, DWORD *pdwExWindowStyle, LPSTR pszWindowTitle);
HRESULT InternalQueryInterface(REFIID, void **);
HRESULT OnData( DISPID id, DWORD grfBSCF,IStream * bitstrm, DWORD amount );
BOOL OnSpecialKey(LPMSG);
BOOL ShouldCreateWindow();
public:
void doAboutBox();
BOOL ConvertToCacheFile(PCSTR pszSrc, PSTR pszDst);
void FillGeneralInformation(HHA_GEN_INFO* pgetInfo);
// BOOL ChooseInformationTypes(CSiteMap* pSiteMap, HWND hwndParent) { return ::ChooseInformationTypes(pSiteMap, hwndParent, this); }
void DisplayAuthorInfo(CSiteMap* pSiteMap, SITEMAP_ENTRY* pSiteMapEntry) { ::DisplayAuthorInfo(m_pInfoType, pSiteMap, pSiteMapEntry, m_hwnd, this); }
void OnKeywordSearch(int idCommand);
BOOL OnCopySample(void);
BOOL LocateSFLFile(PCSTR *,PCSTR *, BOOL);
void AuthorMsg(UINT idStringFormatResource, PCSTR pszSubString = "") { ::AuthorMsg(idStringFormatResource, pszSubString, m_hwndParent, this); }
_inline IUnknown* GetIUnknown() { return m_pUnkOuter; }
HRESULT SendEvent(LPCTSTR pszEventString);
BOOL OnAKLink(BOOL fKLink = TRUE, BOOL bTestMode = FALSE );
HWND GetHtmlHelpFrameWindow() ; // Tunnels from the ActiveX control through IE to get to the HWND of HHCTRL.
UINT GetCodePage(void) { return m_CodePage; }
INT GetCharset(void) { return m_Charset; }
HFONT GetContentFont(void) { return m_hfont; }
// TOC functions
BOOL LoadContentsFile(PCSTR pszMasterFile);
void OnHelpTopics(void);
// Index functions
BOOL LoadIndexFile(PCSTR pszMasterFile);
void OnSizeIndex(LPRECT prc);
HRESULT UpdateImage();
// Related Topics functions
void OnRelatedMenu();
void OnRelatedCommand(int idCommand);
// Splash functions
void CreateSplash(void);
// Button and Static text funcions
void OnDrawStaticText(DRAWITEMSTRUCT* pdis);
BOOL CreateOnClickButton(void);
// private state information.
HRESULT SetBmpPath(IStream *);
CTRL_ACTION m_action;
IMAGE_TYPE m_imgType;
PCSTR m_pszActionData;
int m_idBitmap; // bitmap to display
PCSTR m_pszBitmap; // bitmap parameter
PCSTR m_pszWebMap; // webmap file
DWORD m_flags[MAX_FLAGS]; // author-specified flags
HBRUSH m_hbrBackGround; // background brush
COLORREF m_clrFont; // Font color
BOOL m_fBuiltInImage;
HGDIOBJ m_hImage;
int m_hpadding; // horizontal padding around index, contents, and find
int m_vpadding; // vertical padding around index, contents, and find
HWND m_hwndHelp; // HTML Help window
HWND m_hwndDisplayButton; // regular button handle
PCSTR m_pszEventString; // string to send to event handler
PCSTR m_pszFrame; // frame to display jump in
PCSTR m_pszWindow; // window to display jump in
PCSTR m_pszDefaultTopic; // where to jump if alink/klink fails
class IWebBrowserAppImpl* m_pWebBrowserApp; // Pointer the IE object model
CTable* m_ptblItems; // for A/KLinks
CTable* m_ptblTitles; // for A/KLinks
CTable* m_ptblURLs; // for A/KLinks
CTable* m_ptblLocations; // for A/KLinks
CSiteMap* m_pSiteMap; // used by Related Topics and Keyword Search
CInfoType* m_pInfoType;
IFont* m_pIFont;
// REVIEW: using BOOLs increases data size, bitflags would increase
// code size. Which is better (multiple data seg, single code seg)?
BOOL m_fButton;
BOOL m_fWinHelpPopup;
BOOL m_fPopupMenu; // TRUE to display popup menu instead of dialog
WCHAR* m_pwszButtonText; // bitmap or text
RECT m_rcButton; // button window dimensions
CToc* m_ptoc;
CIndex* m_pindex;
//CSearch* m_pSearch;
BOOL m_fIcon; // bitmap is an icon or a cursor
HHCTRLCTLSTATE m_state;
HDC m_dc;
BMP_DOWNLOAD_STATES m_readystate;
DWORD m_oldSize;
BYTE* m_pSelectedIndexInfoTypes;
COLORREF m_clrFontDisabled; // disabled Font color (disabled)
COLORREF m_clrFontLink; // Link Font color
COLORREF m_clrFontLinkVisited; // Visited Link Font color
COLORREF m_clrFontHover; // Hover Font color
private:
WNDPROC m_lpfnlStaticTextControlWndProc;
static LRESULT StaticTextControlSubWndProc(HWND, UINT, WPARAM, LPARAM);
char m_szRawAction[256];
char m_szFontSpec[256];
BOOL bSharedFont;
UINT m_CodePage;
INT m_Charset;
HFONT m_hfont; // author-specified font to use for child windows
RECT m_rect;
};
BOOL LoadGif(PCSTR pszFile, HBITMAP* phbmp, HPALETTE* phpal, CHtmlHelpControl* phhctrl);
BOOL ShortCut(CHtmlHelpControl* phhctrl, LPCSTR pszString1, LPCSTR pszString2, HWND hwndMsgOwner);
#ifdef CHIINDEX
#define PrintTopics
#else
void PrintTopics(int action, CToc* ptoc, IWebBrowserAppImpl* pWebApp, HWND hWndHelp = NULL);
#endif
// TODO: if you have an array of verbs, then add an extern here with the name
// of it, so that you can include it in the DEFINE_CONTROLOBJECT.
// ie. extern VERBINFO m_HHCtrlCustomVerbs [];
extern const GUID *rgHHCtrlPropPages[];
DEFINE_CONTROLOBJECT(HHCtrl,
&CLSID_HHCtrl,
"HHCtrl",
CHtmlHelpControl::Create,
1,
&IID_IHHCtrl,
"", // BUGBUG: change when OLE supports HtmlHelp files
&DIID__HHCtrlEvents,
OLEMISC_SETCLIENTSITEFIRST |
OLEMISC_ACTIVATEWHENVISIBLE |
OLEMISC_RECOMPOSEONRESIZE |
OLEMISC_CANTLINKINSIDE |
OLEMISC_INSIDEOUT,
0,
RESID_TOOLBOX_BITMAP,
"HHCtrlWndClass",
0,
NULL,
0,
NULL);
#endif // _HHCTRL_H_