#ifndef _WX_OLEUTILS_H
#define _WX_OLEUTILS_H
-#ifdef __GNUG__
+#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
#pragma interface "oleutils.h"
#endif
#include "wx/defs.h"
-#if wxUSE_NORLANDER_HEADERS
+
+#if wxUSE_OLE
+
+// get IUnknown, REFIID &c
#include <ole2.h>
-#endif
+#include "wx/intl.h"
+
// ============================================================================
// General purpose functions and macros
// ============================================================================
+// ----------------------------------------------------------------------------
+// initialize/cleanup OLE
+// ----------------------------------------------------------------------------
+
+// call OleInitialize() or CoInitialize[Ex]() depending on the platform
+//
+// return true if ok, false otherwise
+inline bool wxOleInitialize()
+{
+ // we need to initialize OLE library
+#ifdef __WXWINCE__
+ if ( FAILED(::CoInitializeEx(NULL, COINIT_MULTITHREADED)) )
+#else
+ if ( FAILED(::OleInitialize(NULL)) )
+#endif
+ {
+ wxLogError(_("Cannot initialize OLE"));
+
+ return false;
+ }
+
+ return true;
+}
+
+inline void wxOleUninitialize()
+{
+#ifdef __WXWINCE__
+ ::CoUninitialize();
+#else
+ ::OleUninitialize();
+#endif
+}
+
// ----------------------------------------------------------------------------
// misc helper functions/macros
// ----------------------------------------------------------------------------
// release the interface pointer (if !NULL) and make it NULL
#define RELEASE_AND_NULL(p) if ( (p) != NULL ) { p->Release(); p = NULL; };
-// return TRUE if the iid is in the array
-bool IsIidFromList(REFIID riid, const IID *aIids[], size_t nCount);
+// return true if the iid is in the array
+extern bool IsIidFromList(REFIID riid, const IID *aIids[], size_t nCount);
// ============================================================================
// IUnknown implementation helpers
implementation is quite enough.
Usage is trivial: here is all you should have
- 1) DECLARE_IUNKNOWN_METHOS in your (IUnknown derived!) class declaration
+ 1) DECLARE_IUNKNOWN_METHODS in your (IUnknown derived!) class declaration
2) BEGIN/END_IID_TABLE with ADD_IID in between for all interfaces you
support (at least all for which you intent to return 'this' from QI,
i.e. you should derive from IFoo if you have ADD_IID(Foo)) somewhere else
- 3) IMPLEMENT_IUNKNOWN_METHOS somewhere also
+ 3) IMPLEMENT_IUNKNOWN_METHODS somewhere also
These macros are quite simple: AddRef and Release are trivial and QI does
lookup in a static member array of IIDs and returns 'this' if it founds
the requested interface in it or E_NOINTERFACE if not.
*/
+/*
+ wxAutoULong: this class is used for automatically initalising m_cRef to 0
+*/
+class wxAutoULong
+{
+public:
+ wxAutoULong(ULONG value = 0) : m_Value(value) { }
+
+ operator ULONG&() { return m_Value; }
+ ULONG& operator=(ULONG value) { m_Value = value; return m_Value; }
+
+ wxAutoULong& operator++() { ++m_Value; return *this; }
+ const wxAutoULong operator++( int ) { wxAutoULong temp = *this; ++m_Value; return temp; }
+
+ wxAutoULong& operator--() { --m_Value; return *this; }
+ const wxAutoULong operator--( int ) { wxAutoULong temp = *this; --m_Value; return temp; }
+
+private:
+ ULONG m_Value;
+};
+
// declare the methods and the member variable containing reference count
// you must also define the ms_aIids array somewhere with BEGIN_IID_TABLE
// and friends (see below)
+
#define DECLARE_IUNKNOWN_METHODS \
public: \
STDMETHODIMP QueryInterface(REFIID, void **); \
STDMETHODIMP_(ULONG) Release(); \
private: \
static const IID *ms_aIids[]; \
- ULONG m_cRef
+ wxAutoULong m_cRef
// macros for declaring supported interfaces
// NB: you should write ADD_INTERFACE(Foo) and not ADD_INTERFACE(IID_IFoo)!
{ \
wxLogRelease(_T(#classname), m_cRef); \
\
- if ( --m_cRef == 0 ) { \
+ if ( --m_cRef == wxAutoULong(0) ) { \
delete this; \
return 0; \
} \
// VZ: I don't know it's not done for compilers other than VC++ but I leave it
// as is. Please note, though, that tracing OLE interface calls may be
// incredibly useful when debugging OLE programs.
-#if defined(__WXDEBUG__) && defined(__VISUALC__) && (__VISUALC__ >= 1000)
+#if defined(__WXDEBUG__) && ( ( defined(__VISUALC__) && (__VISUALC__ >= 1000) ) || defined(__MWERKS__) )
// ----------------------------------------------------------------------------
// All OLE specific log functions have DebugTrace level (as LogTrace)
// ----------------------------------------------------------------------------
#define wxLogRelease(szInterface, cRef)
#endif //WXDEBUG
+// wrapper around BSTR type (by Vadim Zeitlin)
+
+class WXDLLEXPORT wxBasicString
+{
+public:
+ // ctors & dtor
+ wxBasicString(const char *sz);
+ wxBasicString(const wxString& str);
+ ~wxBasicString();
+
+ void Init(const char* sz);
+
+ // accessors
+ // just get the string
+ operator BSTR() const { return m_wzBuf; }
+ // retrieve a copy of our string - caller must SysFreeString() it later!
+ BSTR Get() const { return SysAllocString(m_wzBuf); }
+
+private:
+ // @@@ not implemented (but should be)
+ wxBasicString(const wxBasicString&);
+ wxBasicString& operator=(const wxBasicString&);
+
+ OLECHAR *m_wzBuf; // actual string
+};
+
+// Convert variants
+class WXDLLEXPORT wxVariant;
+
+bool wxConvertVariantToOle(const wxVariant& variant, VARIANTARG& oleVariant) ;
+bool wxConvertOleToVariant(const VARIANTARG& oleVariant, wxVariant& variant) ;
+
+// Convert string to Unicode
+BSTR wxConvertStringToOle(const wxString& str);
+
+// Convert string from BSTR to wxString
+wxString wxConvertStringFromOle(BSTR bStr);
+
+#else // !wxUSE_OLE
+
+// ----------------------------------------------------------------------------
+// stub functions to avoid #if wxUSE_OLE in the main code
+// ----------------------------------------------------------------------------
+
+inline bool wxOleInitialize() { return false; }
+inline void wxOleUninitialize() { }
+
+#endif // wxUSE_OLE/!wxUSE_OLE
+
#endif //_WX_OLEUTILS_H