#include "wx/datetime.h"
#endif // wxUSE_DATETIME
-// static void ShowException(LPOLESTR szMember, HRESULT hr, EXCEPINFO *pexcep, unsigned int uiArgErr);
-
#if wxUSE_OLE_AUTOMATION
-/*
- * wxAutomationObject
- */
+#include <wx/vector.h>
+
+// Report an OLE error when calling the specified method to the user via wxLog.
+static void
+ShowException(const wxString& member,
+ HRESULT hr,
+ EXCEPINFO *pexcep = NULL,
+ unsigned int uiArgErr = 0);
+
+// wxAutomationObject
wxAutomationObject::wxAutomationObject(WXIDISPATCH* dispatchPtr)
{
m_dispatchPtr = dispatchPtr;
+ m_lcid = LOCALE_SYSTEM_DEFAULT;
}
wxAutomationObject::~wxAutomationObject()
}
}
+namespace
+{
+
+// A simple helper that ensures that VARIANT is destroyed on scope exit.
+struct wxOleVariantArg : VARIANTARG
+{
+ wxOleVariantArg() { VariantInit(this); }
+ ~wxOleVariantArg() { VariantClear(this); }
+};
+
+} // anonymous namespace
+
+
#define INVOKEARG(i) (args ? args[i] : *(ptrArgs[i]))
// For Put/Get, no named arguments are allowed.
+// WARNING: if args contain IDispatches, their reference count will be decreased
+// by one after Invoke() returns!
bool wxAutomationObject::Invoke(const wxString& member, int action,
wxVariant& retValue, int noArgs, wxVariant args[], const wxVariant* ptrArgs[]) const
{
if (!m_dispatchPtr)
return false;
- // nonConstMember is necessary because the wxString class doesn't have enough consts...
- wxString nonConstMember(member);
-
- int ch = nonConstMember.Find('.');
+ int ch = member.Find('.');
if (ch != -1)
{
// Use dot notation to get the next object
- wxString member2(nonConstMember.Left((size_t) ch));
- wxString rest(nonConstMember.Right(nonConstMember.length() - ch - 1));
+ wxString member2(member.Left((size_t) ch));
+ wxString rest(member.Right(member.length() - ch - 1));
wxAutomationObject obj;
if (!GetObject(obj, member2))
return false;
return obj.Invoke(rest, action, retValue, noArgs, args, ptrArgs);
}
- VARIANTARG vReturn;
- VariantInit(& vReturn);
-
- VARIANTARG* vReturnPtr = & vReturn;
+ wxOleVariantArg vReturn;
+ wxOleVariantArg* vReturnPtr = & vReturn;
// Find number of names args
int namedArgCount = 0;
int i;
for (i = 0; i < noArgs; i++)
- if (!INVOKEARG(i).GetName().IsNull())
+ {
+ if ( !INVOKEARG(i).GetName().empty() )
{
namedArgCount ++;
}
+ }
int namedArgStringCount = namedArgCount + 1;
- BSTR* argNames = new BSTR[namedArgStringCount];
- argNames[0] = wxConvertStringToOle(member);
+ wxVector<wxBasicString> argNames(namedArgStringCount, wxString());
+ argNames[0] = member;
// Note that arguments are specified in reverse order
// (all totally logical; hey, we're dealing with OLE here.)
int j = 0;
for (i = 0; i < namedArgCount; i++)
{
- if (!INVOKEARG(i).GetName().IsNull())
+ if ( !INVOKEARG(i).GetName().empty() )
{
- argNames[(namedArgCount-j)] = wxConvertStringToOle(INVOKEARG(i).GetName());
+ argNames[(namedArgCount-j)] = INVOKEARG(i).GetName();
j ++;
}
}
// + 1 for the member name, + 1 again in case we're a 'put'
- DISPID* dispIds = new DISPID[namedArgCount + 2];
+ wxVector<DISPID> dispIds(namedArgCount + 2);
HRESULT hr;
DISPPARAMS dispparams;
// Get the IDs for the member and its arguments. GetIDsOfNames expects the
// member name as the first name, followed by argument names (if any).
- hr = ((IDispatch*)m_dispatchPtr)->GetIDsOfNames(IID_NULL, argNames,
- 1 + namedArgCount, LOCALE_SYSTEM_DEFAULT, dispIds);
+ hr = ((IDispatch*)m_dispatchPtr)->GetIDsOfNames(IID_NULL,
+ // We rely on the fact that wxBasicString is
+ // just BSTR with some methods here.
+ reinterpret_cast<BSTR *>(&argNames[0]),
+ 1 + namedArgCount, m_lcid, &dispIds[0]);
if (FAILED(hr))
{
-// ShowException(szMember, hr, NULL, 0);
- delete[] argNames;
- delete[] dispIds;
+ ShowException(member, hr);
return false;
}
}
// Convert the wxVariants to VARIANTARGs
- VARIANTARG* oleArgs = new VARIANTARG[noArgs];
+ wxVector<wxOleVariantArg> oleArgs(noArgs);
for (i = 0; i < noArgs; i++)
{
// Again, reverse args
if (!wxConvertVariantToOle(INVOKEARG((noArgs-1) - i), oleArgs[i]))
- {
- delete[] argNames;
- delete[] dispIds;
- delete[] oleArgs;
return false;
- }
}
- dispparams.rgdispidNamedArgs = dispIds + 1;
- dispparams.rgvarg = oleArgs;
+ dispparams.rgdispidNamedArgs = &dispIds[0] + 1;
+ dispparams.rgvarg = oleArgs.empty() ? NULL : &oleArgs[0];
dispparams.cArgs = noArgs;
dispparams.cNamedArgs = namedArgCount;
EXCEPINFO excep;
wxZeroMemory(excep);
- hr = ((IDispatch*)m_dispatchPtr)->Invoke(dispIds[0], IID_NULL, LOCALE_SYSTEM_DEFAULT,
+ hr = ((IDispatch*)m_dispatchPtr)->Invoke(dispIds[0], IID_NULL, m_lcid,
(WORD)action, &dispparams, vReturnPtr, &excep, &uiArgErr);
- for (i = 0; i < namedArgStringCount; i++)
- {
- SysFreeString(argNames[i]);
- }
- delete[] argNames;
- delete[] dispIds;
-
- for (i = 0; i < noArgs; i++)
- VariantClear(& oleArgs[i]) ;
- delete[] oleArgs;
-
if (FAILED(hr))
{
// display the exception information if appropriate:
-// ShowException((const char*) member, hr, &excep, uiArgErr);
+ ShowException(member, hr, &excep, uiArgErr);
// free exception structure information
SysFreeString(excep.bstrSource);
SysFreeString(excep.bstrDescription);
SysFreeString(excep.bstrHelpFile);
- if (vReturnPtr)
- VariantClear(vReturnPtr);
return false;
}
else
if (vReturnPtr)
{
// Convert result to wxVariant form
- wxConvertOleToVariant(vReturn, retValue);
+ if (!wxConvertOleToVariant(vReturn, retValue))
+ return false;
// Mustn't release the dispatch pointer
if (vReturn.vt == VT_DISPATCH)
{
vReturn.pdispVal = NULL;
}
- VariantClear(& vReturn);
+ // Mustn't free the SAFEARRAY if it is contained in the retValue
+ if ((vReturn.vt & VT_ARRAY) &&
+ retValue.GetType() == wxS("safearray"))
+ {
+ vReturn.parray = NULL;
+ }
}
}
return true;
if (dispatch)
{
obj.SetDispatchPtr(dispatch);
+ obj.SetLCID(GetLCID());
return true;
}
else
if (dispatch)
{
obj.SetDispatchPtr(dispatch);
+ obj.SetLCID(GetLCID());
return true;
}
else
return false;
}
+namespace
+{
+
+HRESULT wxCLSIDFromProgID(const wxString& progId, CLSID& clsId)
+{
+ HRESULT hr = CLSIDFromProgID(wxBasicString(progId), &clsId);
+ if ( FAILED(hr) )
+ {
+ wxLogSysError(hr, _("Failed to find CLSID of \"%s\""), progId);
+ }
+ return hr;
+}
+
+void *DoCreateInstance(const wxString& progId, const CLSID& clsId)
+{
+ // get the server IDispatch interface
+ //
+ // NB: using CLSCTX_INPROC_HANDLER results in failure when getting
+ // Automation interface for Microsoft Office applications so don't use
+ // CLSCTX_ALL which includes it
+ void *pDispatch = NULL;
+ HRESULT hr = CoCreateInstance(clsId, NULL, CLSCTX_SERVER,
+ IID_IDispatch, &pDispatch);
+ if (FAILED(hr))
+ {
+ wxLogSysError(hr, _("Failed to create an instance of \"%s\""), progId);
+ return NULL;
+ }
+
+ return pDispatch;
+}
+
+} // anonymous namespace
+
// Get a dispatch pointer from the current object associated
-// with a class id
-bool wxAutomationObject::GetInstance(const wxString& classId) const
+// with a ProgID
+bool wxAutomationObject::GetInstance(const wxString& progId, int flags) const
{
if (m_dispatchPtr)
return false;
CLSID clsId;
- IUnknown * pUnk = NULL;
-
- wxBasicString unicodeName(classId);
-
- if (FAILED(CLSIDFromProgID((BSTR) unicodeName, &clsId)))
- {
- wxLogWarning(wxT("Cannot obtain CLSID from ProgID"));
+ HRESULT hr = wxCLSIDFromProgID(progId, clsId);
+ if (FAILED(hr))
return false;
- }
- if (FAILED(GetActiveObject(clsId, NULL, &pUnk)))
+ IUnknown *pUnk = NULL;
+ hr = GetActiveObject(clsId, NULL, &pUnk);
+ if (FAILED(hr))
{
- wxLogWarning(wxT("Cannot find an active object"));
+ if ( flags & wxAutomationInstance_CreateIfNeeded )
+ {
+ const_cast<wxAutomationObject *>(this)->
+ m_dispatchPtr = DoCreateInstance(progId, clsId);
+ if ( m_dispatchPtr )
+ return true;
+ }
+ else
+ {
+ // Log an error except if we're supposed to fail silently when the
+ // error is that no current instance exists.
+ if ( hr != MK_E_UNAVAILABLE ||
+ !(flags & wxAutomationInstance_SilentIfNone) )
+ {
+ wxLogSysError(hr,
+ _("Cannot get an active instance of \"%s\""),
+ progId);
+ }
+ }
+
return false;
}
- if (pUnk->QueryInterface(IID_IDispatch, (LPVOID*) &m_dispatchPtr) != S_OK)
+ hr = pUnk->QueryInterface(IID_IDispatch, (LPVOID*) &m_dispatchPtr);
+ if (FAILED(hr))
{
- wxLogWarning(wxT("Cannot find IDispatch interface"));
+ wxLogSysError(hr,
+ _("Failed to get OLE automation interface for \"%s\""),
+ progId);
return false;
}
}
// Get a dispatch pointer from a new object associated
-// with the given class id
-bool wxAutomationObject::CreateInstance(const wxString& classId) const
+// with the given ProgID
+bool wxAutomationObject::CreateInstance(const wxString& progId) const
{
if (m_dispatchPtr)
return false;
CLSID clsId;
-
- wxBasicString unicodeName(classId);
-
- if (FAILED(CLSIDFromProgID((BSTR) unicodeName, &clsId)))
- {
- wxLogWarning(wxT("Cannot obtain CLSID from ProgID"));
+ HRESULT hr = wxCLSIDFromProgID(progId, clsId);
+ if (FAILED(hr))
return false;
- }
- // get the server IDispatch interface
- //
- // NB: using CLSCTX_INPROC_HANDLER results in failure when getting
- // Automation interface for Microsoft Office applications so don't use
- // CLSCTX_ALL which includes it
- if (FAILED(CoCreateInstance(clsId, NULL, CLSCTX_SERVER, IID_IDispatch,
- (void**)&m_dispatchPtr)))
- {
- wxLogWarning(wxT("Cannot start an instance of this class."));
- return false;
- }
+ const_cast<wxAutomationObject *>(this)->
+ m_dispatchPtr = DoCreateInstance(progId, clsId);
- return true;
+ return m_dispatchPtr != NULL;
}
-#endif // wxUSE_OLE_AUTOMATION
-
-#if 0
+LCID wxAutomationObject::GetLCID() const
+{
+ return m_lcid;
+}
-void ShowException(LPOLESTR szMember, HRESULT hr, EXCEPINFO *pexcep, unsigned int uiArgErr)
+void wxAutomationObject::SetLCID(LCID lcid)
{
- TCHAR szBuf[512];
+ m_lcid = lcid;
+}
+static void
+ShowException(const wxString& member,
+ HRESULT hr,
+ EXCEPINFO *pexcep,
+ unsigned int uiArgErr)
+{
+ wxString message;
switch (GetScode(hr))
{
case DISP_E_UNKNOWNNAME:
- wsprintf(szBuf, L"%s: Unknown name or named argument.", szMember);
+ message = _("Unknown name or named argument.");
break;
case DISP_E_BADPARAMCOUNT:
- wsprintf(szBuf, L"%s: Incorrect number of arguments.", szMember);
+ message = _("Incorrect number of arguments.");
break;
case DISP_E_EXCEPTION:
- wsprintf(szBuf, L"%s: Error %d: ", szMember, pexcep->wCode);
- if (pexcep->bstrDescription != NULL)
- lstrcat(szBuf, pexcep->bstrDescription);
+ if ( pexcep )
+ {
+ if ( pexcep->bstrDescription )
+ message << pexcep->bstrDescription << wxS(" ");
+ message += wxString::Format(wxS("error code %u"), pexcep->wCode);
+ }
else
- lstrcat(szBuf, L"<<No Description>>");
+ {
+ message = _("Unknown exception");
+ }
break;
case DISP_E_MEMBERNOTFOUND:
- wsprintf(szBuf, L"%s: method or property not found.", szMember);
+ message = _("Method or property not found.");
break;
case DISP_E_OVERFLOW:
- wsprintf(szBuf, L"%s: Overflow while coercing argument values.", szMember);
+ message = _("Overflow while coercing argument values.");
break;
case DISP_E_NONAMEDARGS:
- wsprintf(szBuf, L"%s: Object implementation does not support named arguments.",
- szMember);
+ message = _("Object implementation does not support named arguments.");
break;
case DISP_E_UNKNOWNLCID:
- wsprintf(szBuf, L"%s: The locale ID is unknown.", szMember);
+ message = _("The locale ID is unknown.");
break;
case DISP_E_PARAMNOTOPTIONAL:
- wsprintf(szBuf, L"%s: Missing a required parameter.", szMember);
+ message = _("Missing a required parameter.");
break;
case DISP_E_PARAMNOTFOUND:
- wsprintf(szBuf, L"%s: Argument not found, argument %d.", szMember, uiArgErr);
+ message.Printf(_("Argument %u not found."), uiArgErr);
break;
case DISP_E_TYPEMISMATCH:
- wsprintf(szBuf, L"%s: Type mismatch, argument %d.", szMember, uiArgErr);
+ message.Printf(_("Type mismatch in argument %u."), uiArgErr);
+ break;
+
+ case ERROR_FILE_NOT_FOUND:
+ message = _("The system cannot find the file specified.");
+ break;
+
+ case REGDB_E_CLASSNOTREG:
+ message = _("Class not registered.");
break;
default:
- wsprintf(szBuf, L"%s: Unknown error occurred.", szMember);
+ message.Printf(_("Unknown error %08x"), hr);
break;
}
- wxLogWarning(szBuf);
+ wxLogError(_("OLE Automation error in %s: %s"), member, message);
}
-#endif
+#endif // wxUSE_OLE_AUTOMATION
projects / wxWidgets.git / blobdiff