.\" This is a wxWidgets manpage page generated from the XML docs .TH wxAutomationObject 3wx 2005-02-15 "wxWidgets" "wxWidgets class documentation" .SH NAME wxAutomationObject \- OLE automation class .SH DESCRIPTION The wxAutomationObject class represents an OLE automation object containing a single data member, an IDispatch pointer. It contains a number of functions that make it easy to perform automation operations, and set and get properties. The class makes heavy use of the wxVariant class. The usage of these classes is quite close to OLE automation usage in Visual Basic. The API is high-level, and the application can specify multiple properties in a single string. The following example gets the current Excel instance, and if it exists, makes the active cell bold. wxAutomationObject excelObject; if (excelObject.GetInstance("Excel.Application")) excelObject.PutProperty("ActiveCell.Font.Bold", true); Note that this class obviously works under Windows only. .SH "PARENTS" wxObject .SH "INCLUDE FILES" wx/msw/ole/automtn.h .SH MEMBERS .SS wxAutomationObject (WXIDISPATCH* dispatchPtr = NULL) Constructor, taking an optional IDispatch pointer which will be released when the object is deleted. .SS ~wxAutomationObject () Destructor. If the internal IDispatch pointer is non-null, it will be released. .SS wxVariant CallMethod (const wxString& methodint noArgswxVariant args[]) .SS wxVariant CallMethod (const wxString& method...) Calls an automation method for this object. The first form takes a method name, number of arguments, and an array of variants. The second form takes a method name and zero to six constant references to variants. Since the variant class has constructors for the basic data types, and C++ provides temporary objects automatically, both of the following lines are syntactically valid: wxVariant res = obj.CallMethod("Sum", wxVariant(1.2), wxVariant(3.4)); wxVariant res = obj.CallMethod("Sum", 1.2, 3.4); Note that method can contain dot-separated property names, to save the application needing to call GetProperty several times using several temporary objects. For example: object.CallMethod("ActiveCell.Font.ShowDialog", "My caption"); .SS bool CreateInstance (const wxString& classId) Creates a new object based on the class id, returning true if the object was successfully created, or false if not. .SS IDispatch* GetDispatchPtr () Gets the IDispatch pointer. .SS bool GetInstance (const wxString& classId) Retrieves the current object associated with a class id, and attaches the IDispatch pointer to this object. Returns true if a pointer was successfully retrieved, false otherwise. Note that this cannot cope with two instances of a given OLE object being active simultaneously, such as two copies of Excel running. Which object is referenced cannot currently be specified. .SS bool GetObject (wxAutomationObject&objconst wxString& propertyint noArgs = 0wxVariant args[] = NULL) Retrieves a property from this object, assumed to be a dispatch pointer, and initialises obj with it. To avoid having to deal with IDispatch pointers directly, use this function in preference to wxAutomationObject::GetProperty when retrieving objects from other objects. Note that an IDispatch pointer is stored as a void* pointer in wxVariant objects. .SS wxVariant GetProperty (const wxString& propertyint noArgswxVariant args[]) .SS wxVariant GetProperty (const wxString& property...) Gets a property value from this object. The first form takes a property name, number of arguments, and an array of variants. The second form takes a property name and zero to six constant references to variants. Since the variant class has constructors for the basic data types, and C++ provides temporary objects automatically, both of the following lines are syntactically valid: wxVariant res = obj.GetProperty("Range", wxVariant("A1")); wxVariant res = obj.GetProperty("Range", "A1"); Note that property can contain dot-separated property names, to save the application needing to call GetProperty several times using several temporary objects. .SS bool Invoke (const wxString& memberint actionwxVariant& retValueint noArgswxVariant args[]const wxVariant* ptrArgs[] = 0) This function is a low-level implementation that allows access to the IDispatch Invoke function. It is not meant to be called directly by the application, but is used by other convenience functions. . .SS bool PutProperty (const wxString& propertyint noArgswxVariant args[]) .SS bool PutProperty (const wxString& property...) Puts a property value into this object. The first form takes a property name, number of arguments, and an array of variants. The second form takes a property name and zero to six constant references to variants. Since the variant class has constructors for the basic data types, and C++ provides temporary objects automatically, both of the following lines are syntactically valid: obj.PutProperty("Value", wxVariant(23)); obj.PutProperty("Value", 23); Note that property can contain dot-separated property names, to save the application needing to call GetProperty several times using several temporary objects. .SS void SetDispatchPtr (WXIDISPATCH* dispatchPtr) Sets the IDispatch pointer. This function does not check if there is already an IDispatch pointer. You may need to cast from IDispatch* to WXIDISPATCH* when calling this function. .SH "SEE ALSO" wxObject wxVariant .SH "AUTHORS" Documentation content by Julian Smart, Robert Roebling, Vadim Zeitlin, Robin Dunn, et al Conversion to manpage format by Arnout Engelen (http://bzzt.net), bugreports welcome.