[Doxygen-users] Doxygen seems lost with ATL Source. Please help !!!

[Jean-Marc P. <jm...@mi...>]

Hi gurus,

Just new to Doxygen, and it really looks fantastic. but I am sure you =
all now that.

Anyway, I have to document some Win32/MFC/ATL code, and it sounds like I =
am missing some configuration somewhere.

Basically, Doxygen cannot pull the documentation from =
CCustomControlSite::XDocHostUIHandler::GetHostInfo() for instance.
It sounds like it can get things out from the header file, but associate =
it to the #define STDMETHOD instead of the=20
method name. I guess this is because of the #define STDMETHOD somewhere =
in atl.h (M$ stuff) but I do not know how
to get it right. thanks for any help.

Regards,

Jean-Marc




from Custsite.cpp
...  =20
<source file=3DCustsite.cpp>
/// Called at initialization
HRESULT FAR EXPORT  CCustomControlSite::XDocHostUIHandler::GetHostInfo( =
DOCHOSTUIINFO* pInfo )
{

   METHOD_PROLOGUE(CCustomControlSite, DocHostUIHandler)
   pInfo->dwFlags =3D DOCHOSTUIFLAG_NO3DBORDER;
    pInfo->dwDoubleClick =3D DOCHOSTUIDBLCLK_DEFAULT;

    return S_OK;
}

/// Called when MSHTML.DLL shows its UI
HRESULT FAR EXPORT  CCustomControlSite::XDocHostUIHandler::ShowUI(
            DWORD dwID,=20
            IOleInPlaceActiveObject * /*pActiveObject*/,
            IOleCommandTarget * pCommandTarget,
            IOleInPlaceFrame * /*pFrame*/,
            IOleInPlaceUIWindow * /*pDoc*/)
{

   METHOD_PROLOGUE(CCustomControlSite, DocHostUIHandler)
   // We've already got our own UI in place so just return S_OK
    return S_OK;
}

/// Called when MSHTML.DLL hides its UI
HRESULT FAR EXPORT  CCustomControlSite::XDocHostUIHandler::HideUI(void)
{
   METHOD_PROLOGUE(CCustomControlSite, DocHostUIHandler)
    return S_OK;
}
</source>

<source file=3DCustsite.h>
/**
<p>Local implementation of <I>IDocHostUIHandler2</I>.</p>
<p>IWebBrowser2 will query its host to find out if it implements it, and =
then use it when required. This is
used to implement our menu in the HTML view. allowing the user to select =
a section of the=20
HTML as a RegExp.</p>
*/
/// Implement IDocHostUIHandler2 for displaying our own pop-up menu in =
the Internet Explorer view
class CCustomControlSite:public COleControlSite
{
public:
   CCustomControlSite(COleControlContainer =
*pCnt):COleControlSite(pCnt){}

protected:

   DECLARE_INTERFACE_MAP();
BEGIN_INTERFACE_PART(DocHostUIHandler, IDocHostUIHandler)
/**
<p>Called by IWebBrowser2 when the user wants to display the pop-up =
menu.</p>
<p>1st Check if the user has selected some text (HTML Text). If this is =
the case
then display our pop-up menu from the Edit menu (allowing the add of a =
RegExp). If not
then let the browser follow its default behavior.</p>
<p>For some reasons, the selection tag matches the CONTEXT_MENU_CONTROL =
#define, and not=20
the expected CONTEXT_MENU_TEXTSELECT. Is this a bug ??? </p>
*/
   STDMETHOD(ShowContextMenu)(/* [in] */ DWORD dwID,
            /* [in] */ POINT __RPC_FAR *ppt,
            /* [in] */ IUnknown __RPC_FAR *pcmdtReserved,
            /* [in] */ IDispatch __RPC_FAR *pdispReserved);
   STDMETHOD(GetHostInfo)(=20
            /* [out][in] */ DOCHOSTUIINFO __RPC_FAR *pInfo);
   STDMETHOD(ShowUI)(=20
            /* [in] */ DWORD dwID,
            /* [in] */ IOleInPlaceActiveObject __RPC_FAR *pActiveObject,
            /* [in] */ IOleCommandTarget __RPC_FAR *pCommandTarget,
            /* [in] */ IOleInPlaceFrame __RPC_FAR *pFrame,
            /* [in] */ IOleInPlaceUIWindow __RPC_FAR *pDoc);
   STDMETHOD(HideUI)(void);
   STDMETHOD(UpdateUI)(void);
</source>


And the output:

<log>
Parsing file X:/TransxRX:/TransxRec/Tools/TransRec/custsite.cpp:54 =
Warning: member `AddRef' of class =
`CCustomControlSite::XDocHostUIHandler' cannot be found
X:/TransxRec/Tools/TransRec/custsite.cpp:62 Warning: member `Release' of =
class `CCustomControlSite::XDocHostUIHandler' cannot be found
X:/TransxRec/Tools/TransRec/custsite.cpp:69 Warning: no matching class =
member found for=20
  HRESULT FAR EXPORT =
CCustomControlSite::XDocHostUIHandler::QueryInterface(REFIID riid, void =
**ppvObj)
X:/TransxRec/Tools/TransRec/custsite.cpp:77 Warning: member =
`GetHostInfo' of class `CCustomControlSite::XDocHostUIHandler' cannot be =
found
X:/TransxRec/Tools/TransRec/custsite.cpp:93 Warning: member `ShowUI' of =
class `CCustomControlSite::XDocHostUIHandler' cannot be found
X:/TransxRec/Tools/TransRec/custsite.cpp:102 Warning: member `HideUI' of =
class `CCustomControlSite::XDocHostUIHandler' cannot be found
X:/TransxRec/Tools/TransRec/custsite.cpp:110 Warning: member `UpdateUI' =
of class `CCustomControlSite::XDocHostUIHandler' cannot be found
X:/TransxRec/Tools/TransRec/custsite.cpp:118 Warning: member =
`EnableModeless' of class `CCustomControlSite::XDocHostUIHandler' cannot =
be found
X:/TransxRec/Tools/TransRec/custsite.cpp:125 Warning: member =
`OnDocWindowActivate' of class `CCustomControlSite::XDocHostUIHandler' =
cannot be found
X:/TransxRec/Tools/TransRec/custsite.cpp:132 Warning: member =
`OnFrameWindowActivate' of class `CCustomControlSite::XDocHostUIHandler' =
cannot be found
X:/TransxRec/Tools/TransRec/custsite.cpp:142 Warning: member =
`ResizeBorder' of class `CCustomControlSite::XDocHostUIHandler' cannot =
be found
X:/TransxRec/Tools/TransRec/custsite.cpp:164 Warning: member =
`ShowContextMenu' of class `CCustomControlSite::XDocHostUIHandler' =
cannot be found
X:/TransxRec/Tools/TransRec/custsite.cpp:185 Warning: member =
`TranslateAccelerator' of class `CCustomControlSite::XDocHostUIHandler' =
cannot be found
X:/TransxRec/Tools/TransRec/custsite.cpp:192 Warning: member =
`GetOptionKeyPath' of class `CCustomControlSite::XDocHostUIHandler' =
cannot be found
X:/TransxRec/Tools/TransRec/custsite.cpp:201 Warning: member =
`GetDropTarget' of class `CCustomControlSite::XDocHostUIHandler' cannot =
be found
X:/TransxRec/Tools/TransRec/custsite.cpp:209 Warning: member =
`GetExternal' of class `CCustomControlSite::XDocHostUIHandler' cannot be =
found
X:/TransxRec/Tools/TransRec/custsite.cpp:221 Warning: member =
`TranslateUrl' of class `CCustomControlSite::XDocHostUIHandler' cannot =
be found
X:/TransxRec/Tools/TransRec/custsite.cpp:229 Warning: member =
`FilterDataObject' of class `CCustomControlSite::XDocHostUIHandler' =
cannot be found
X:/TransxRec/Tools/TransRec/custsite.h:45 Warning: Member =
CCustomControlSite of class CCustomControlSite is not documented.
X:/TransxRec/Tools/TransRec/custsite.h:49 Warning: Member =
DECLARE_INTERFACE_MAP of class CCustomControlSite is not documented.
X:/TransxRec/Tools/TransRec/custsite.h:64 Warning: Member STDMETHOD of =
class CCustomControlSite is not documented.
X:/TransxRec/Tools/TransRec/custsite.h:70 Warning: Member STDMETHOD of =
class CCustomControlSite is not documented.
X:/TransxRec/Tools/TransRec/custsite.h:71 Warning: Member STDMETHOD of =
class CCustomControlSite is not documented.
X:/TransxRec/Tools/TransRec/custsite.h:72 Warning: Member STDMETHOD of =
class CCustomControlSite is not documented.
X:/TransxRec/Tools/TransRec/custsite.h:73 Warning: Member STDMETHOD of =
class CCustomControlSite is not documented.
X:/TransxRec/Tools/TransRec/custsite.h:74 Warning: Member STDMETHOD of =
class CCustomControlSite is not documented.
X:/TransxRec/Tools/TransRec/custsite.h:75 Warning: Member STDMETHOD of =
class CCustomControlSite is not documented.
X:/TransxRec/Tools/TransRec/custsite.h:79 Warning: Member STDMETHOD of =
class CCustomControlSite is not documented.
X:/TransxRec/Tools/TransRec/custsite.h:83 Warning: Member STDMETHOD of =
class CCustomControlSite is not documented.
X:/TransxRec/Tools/TransRec/custsite.h:86 Warning: Member STDMETHOD of =
class CCustomControlSite is not documented.
X:/TransxRec/Tools/TransRec/custsite.h:89 Warning: Member STDMETHOD of =
class CCustomControlSite is not documented.
X:/TransxRec/Tools/TransRec/custsite.h:91 Warning: Member STDMETHOD of =
class CCustomControlSite is not documented.
X:/TransxRec/Tools/TransRec/custsite.h:95 Warning: Member STDMETHOD of =
class CCustomControlSite is not documented.
X:/TransxRec/Tools/TransRec/custsite.h:98 Warning: Member STDMETHOD of =
class CCustomControlSite is not documented.
X:/TransxRec/Tools/TransRec/custsite.h:107 Warning: Member =
CCustomOccManager of class CCustomOccManager is not documented.
</log>