wxWidgets/wxPython/contrib/activex/activex.py
Robin Dunn b7c75283f2 Lindsay Mathieson's newest wxActiveX class has been wrapped into a new
extension module called wx.activex.  Lots of demo and lib updates to
go along with it.


git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@26301 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2004-03-23 05:29:50 +00:00

622 lines
21 KiB
Python

# This file was created automatically by SWIG.
# Don't modify this file, modify the SWIG interface instead.
import _activex
import core
wx = core
#---------------------------------------------------------------------------
class CLSID(object):
"""
This class wraps the Windows CLSID structure and is used to
specify the class of the ActiveX object that is to be created. A
CLSID can be constructed from either a ProgID string, (such as
'WordPad.Document.1') or a classID string, (such as
'{CA8A9783-280D-11CF-A24D-444553540000}').
"""
def __repr__(self):
return "<%s.%s; proxy of C++ CLSID instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
def __init__(self, *args, **kwargs):
"""
__init__(String id) -> CLSID
This class wraps the Windows CLSID structure and is used to
specify the class of the ActiveX object that is to be created. A
CLSID can be constructed from either a ProgID string, (such as
'WordPad.Document.1') or a classID string, (such as
'{CA8A9783-280D-11CF-A24D-444553540000}').
"""
newobj = _activex.new_CLSID(*args, **kwargs)
self.this = newobj.this
self.thisown = 1
del newobj.thisown
def __del__(self, destroy=_activex.delete_CLSID):
"""__del__()"""
try:
if self.thisown: destroy(self)
except: pass
def GetCLSIDString(*args, **kwargs):
"""GetCLSIDString() -> String"""
return _activex.CLSID_GetCLSIDString(*args, **kwargs)
def GetProgIDString(*args, **kwargs):
"""GetProgIDString() -> String"""
return _activex.CLSID_GetProgIDString(*args, **kwargs)
def __str__(self): return self.GetCLSIDString()
class CLSIDPtr(CLSID):
def __init__(self, this):
self.this = this
if not hasattr(self,"thisown"): self.thisown = 0
self.__class__ = CLSID
_activex.CLSID_swigregister(CLSIDPtr)
#---------------------------------------------------------------------------
class ParamX(object):
def __init__(self): raise RuntimeError, "No constructor defined"
def __repr__(self):
return "<%s.%s; proxy of C++ wxParamX instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
flags = property(_activex.ParamX_flags_get)
isPtr = property(_activex.ParamX_isPtr_get)
isSafeArray = property(_activex.ParamX_isSafeArray_get)
isOptional = property(_activex.ParamX_isOptional_get)
vt = property(_activex.ParamX_vt_get)
name = property(_activex.ParamX_name_get)
vt_type = property(_activex.ParamX_vt_type_get)
isIn = property(_activex.ParamX_IsIn)
isOut = property(_activex.ParamX_IsOut)
isRetVal = property(_activex.ParamX_IsRetVal)
class ParamXPtr(ParamX):
def __init__(self, this):
self.this = this
if not hasattr(self,"thisown"): self.thisown = 0
self.__class__ = ParamX
_activex.ParamX_swigregister(ParamXPtr)
class FuncX(object):
def __init__(self): raise RuntimeError, "No constructor defined"
def __repr__(self):
return "<%s.%s; proxy of C++ wxFuncX instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
name = property(_activex.FuncX_name_get)
memid = property(_activex.FuncX_memid_get)
hasOut = property(_activex.FuncX_hasOut_get)
retType = property(_activex.FuncX_retType_get)
params = property(_activex.FuncX_params_get)
class FuncXPtr(FuncX):
def __init__(self, this):
self.this = this
if not hasattr(self,"thisown"): self.thisown = 0
self.__class__ = FuncX
_activex.FuncX_swigregister(FuncXPtr)
class PropX(object):
def __init__(self): raise RuntimeError, "No constructor defined"
def __repr__(self):
return "<%s.%s; proxy of C++ wxPropX instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
name = property(_activex.PropX_name_get)
memid = property(_activex.PropX_memid_get)
type = property(_activex.PropX_type_get)
arg = property(_activex.PropX_arg_get)
putByRef = property(_activex.PropX_putByRef_get)
canGet = property(_activex.PropX_CanGet)
canSet = property(_activex.PropX_CanSet)
class PropXPtr(PropX):
def __init__(self, this):
self.this = this
if not hasattr(self,"thisown"): self.thisown = 0
self.__class__ = PropX
_activex.PropX_swigregister(PropXPtr)
class ParamXArray(object):
def __init__(self): raise RuntimeError, "No constructor defined"
def __repr__(self):
return "<%s.%s; proxy of C++ wxParamXArray instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
def __nonzero__(*args, **kwargs):
"""__nonzero__() -> bool"""
return _activex.ParamXArray___nonzero__(*args, **kwargs)
def __len__(*args, **kwargs):
"""__len__() -> int"""
return _activex.ParamXArray___len__(*args, **kwargs)
def __getitem__(*args, **kwargs):
"""__getitem__(int idx) -> ParamX"""
return _activex.ParamXArray___getitem__(*args, **kwargs)
class ParamXArrayPtr(ParamXArray):
def __init__(self, this):
self.this = this
if not hasattr(self,"thisown"): self.thisown = 0
self.__class__ = ParamXArray
_activex.ParamXArray_swigregister(ParamXArrayPtr)
class FuncXArray(object):
def __init__(self): raise RuntimeError, "No constructor defined"
def __repr__(self):
return "<%s.%s; proxy of C++ wxFuncXArray instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
def __nonzero__(*args, **kwargs):
"""__nonzero__() -> bool"""
return _activex.FuncXArray___nonzero__(*args, **kwargs)
def __len__(*args, **kwargs):
"""__len__() -> int"""
return _activex.FuncXArray___len__(*args, **kwargs)
def __getitem__(*args, **kwargs):
"""__getitem__(int idx) -> FuncX"""
return _activex.FuncXArray___getitem__(*args, **kwargs)
class FuncXArrayPtr(FuncXArray):
def __init__(self, this):
self.this = this
if not hasattr(self,"thisown"): self.thisown = 0
self.__class__ = FuncXArray
_activex.FuncXArray_swigregister(FuncXArrayPtr)
class PropXArray(object):
def __init__(self): raise RuntimeError, "No constructor defined"
def __repr__(self):
return "<%s.%s; proxy of C++ wxPropXArray instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
def __nonzero__(*args, **kwargs):
"""__nonzero__() -> bool"""
return _activex.PropXArray___nonzero__(*args, **kwargs)
def __len__(*args, **kwargs):
"""__len__() -> int"""
return _activex.PropXArray___len__(*args, **kwargs)
def __getitem__(*args, **kwargs):
"""__getitem__(int idx) -> PropX"""
return _activex.PropXArray___getitem__(*args, **kwargs)
class PropXArrayPtr(PropXArray):
def __init__(self, this):
self.this = this
if not hasattr(self,"thisown"): self.thisown = 0
self.__class__ = PropXArray
_activex.PropXArray_swigregister(PropXArrayPtr)
#---------------------------------------------------------------------------
class ActiveXWindow(core.Window):
"""
ActiveXWindow derives from wxWindow and the constructor accepts a
CLSID for the ActiveX Control that should be created. The
ActiveXWindow class simply adds methods that allow you to query
some of the TypeInfo exposed by the ActiveX object, and also to
get/set properties or call methods by name. The Python
implementation automatically handles converting parameters and
return values to/from the types expected by the ActiveX code as
specified by the TypeInfo.
"""
def __repr__(self):
return "<%s.%s; proxy of C++ wxActiveXWindow instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
def __init__(self, *args, **kwargs):
"""
__init__(Window parent, CLSID clsId, int id=-1, Point pos=DefaultPosition,
Size size=DefaultSize, long style=0,
String name=PanelNameStr) -> ActiveXWindow
Creates an ActiveX control from the clsID given and makes it act
as much like a regular wx.Window as possible.
"""
newobj = _activex.new_ActiveXWindow(*args, **kwargs)
self.this = newobj.this
self.thisown = 1
del newobj.thisown
self._setOORInfo(self)
def GetCLSID(*args, **kwargs):
"""
GetCLSID() -> CLSID
Return the CLSID used to construct this ActiveX window
"""
return _activex.ActiveXWindow_GetCLSID(*args, **kwargs)
def GetAXEventCount(*args, **kwargs):
"""
GetAXEventCount() -> int
Number of events defined for this control
"""
return _activex.ActiveXWindow_GetAXEventCount(*args, **kwargs)
def GetAXEventDesc(*args, **kwargs):
"""
GetAXEventDesc(int idx) -> FuncX
Returns event description by index
"""
return _activex.ActiveXWindow_GetAXEventDesc(*args, **kwargs)
def GetAXPropCount(*args, **kwargs):
"""
GetAXPropCount() -> int
Number of properties defined for this control
"""
return _activex.ActiveXWindow_GetAXPropCount(*args, **kwargs)
def GetAXPropDesc(*args):
"""
GetAXPropDesc(int idx) -> PropX
GetAXPropDesc(String name) -> PropX
"""
return _activex.ActiveXWindow_GetAXPropDesc(*args)
def GetAXMethodCount(*args, **kwargs):
"""
GetAXMethodCount() -> int
Number of methods defined for this control
"""
return _activex.ActiveXWindow_GetAXMethodCount(*args, **kwargs)
def GetAXMethodDesc(*args):
"""
GetAXMethodDesc(int idx) -> FuncX
GetAXMethodDesc(String name) -> FuncX
"""
return _activex.ActiveXWindow_GetAXMethodDesc(*args)
def GetAXEvents(*args, **kwargs):
"""
GetAXEvents() -> FuncXArray
Returns a sequence of FuncX objects describing the events
available for this ActiveX object.
"""
return _activex.ActiveXWindow_GetAXEvents(*args, **kwargs)
def GetAXMethods(*args, **kwargs):
"""
GetAXMethods() -> FuncXArray
Returns a sequence of FuncX objects describing the methods
available for this ActiveX object.
"""
return _activex.ActiveXWindow_GetAXMethods(*args, **kwargs)
def GetAXProperties(*args, **kwargs):
"""
GetAXProperties() -> PropXArray
Returns a sequence of PropX objects describing the properties
available for this ActiveX object.
"""
return _activex.ActiveXWindow_GetAXProperties(*args, **kwargs)
def SetAXProp(*args, **kwargs):
"""
SetAXProp(String name, PyObject value)
Set a property of the ActiveX object by name.
"""
return _activex.ActiveXWindow_SetAXProp(*args, **kwargs)
def GetAXProp(*args, **kwargs):
"""
GetAXProp(String name) -> PyObject
Get the value of an ActiveX property by name.
"""
return _activex.ActiveXWindow_GetAXProp(*args, **kwargs)
def _CallAXMethod(*args):
"""
_CallAXMethod(String name, PyObject args) -> PyObject
The implementation for CallMethod. Calls an ActiveX method, by
name passing the parameters given in args.
"""
return _activex.ActiveXWindow__CallAXMethod(*args)
def CallAXMethod(self, name, *args):
"""
Front-end for _CallMethod. Simply passes all positional args
after the name as a single tuple to _CallMethod.
"""
return self._CallAXMethod(name, args)
class ActiveXWindowPtr(ActiveXWindow):
def __init__(self, this):
self.this = this
if not hasattr(self,"thisown"): self.thisown = 0
self.__class__ = ActiveXWindow
_activex.ActiveXWindow_swigregister(ActiveXWindowPtr)
#---------------------------------------------------------------------------
def RegisterActiveXEvent(*args, **kwargs):
"""
RegisterActiveXEvent(String eventName) -> wxEventType
Creates a standard wx event ID for the given eventName.
"""
return _activex.RegisterActiveXEvent(*args, **kwargs)
class ActiveXEvent(core.CommandEvent):
"""
An instance of ActiveXEvent is sent to the handler for all bound
ActiveX events. Any event parameters from the ActiveX cntrol are
turned into attributes of the Python proxy for this event object.
Additionally, there is a property called eventName that will
return (suprizingly <wink>) the name of the ActiveX event.
"""
def __init__(self): raise RuntimeError, "No constructor defined"
def __repr__(self):
return "<%s.%s; proxy of C++ wxActiveXEvent instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
eventName = property(_activex.ActiveXEvent_EventName)
def _preInit(*args, **kwargs):
"""
_preInit(PyObject pyself)
This is called by the EventThunker before calling the handler.
We'll convert and load the ActiveX event parameters into
attributes of the Python event object.
"""
return _activex.ActiveXEvent__preInit(*args, **kwargs)
class ActiveXEventPtr(ActiveXEvent):
def __init__(self, this):
self.this = this
if not hasattr(self,"thisown"): self.thisown = 0
self.__class__ = ActiveXEvent
_activex.ActiveXEvent_swigregister(ActiveXEventPtr)
#---------------------------------------------------------------------------
class IEHtmlWindowBase(ActiveXWindow):
def __repr__(self):
return "<%s.%s; proxy of C++ wxIEHtmlWindowBase instance at %s>" % (self.__class__.__module__, self.__class__.__name__, self.this,)
def __init__(self, *args, **kwargs):
newobj = _activex.new_IEHtmlWindowBase(*args, **kwargs)
self.this = newobj.this
self.thisown = 1
del newobj.thisown
def SetCharset(*args, **kwargs): return _activex.IEHtmlWindowBase_SetCharset(*args, **kwargs)
def LoadString(*args, **kwargs): return _activex.IEHtmlWindowBase_LoadString(*args, **kwargs)
def LoadStream(*args, **kwargs): return _activex.IEHtmlWindowBase_LoadStream(*args, **kwargs)
def GetStringSelection(*args, **kwargs): return _activex.IEHtmlWindowBase_GetStringSelection(*args, **kwargs)
def GetText(*args, **kwargs): return _activex.IEHtmlWindowBase_GetText(*args, **kwargs)
class IEHtmlWindowBasePtr(IEHtmlWindowBase):
def __init__(self, this):
self.this = this
if not hasattr(self,"thisown"): self.thisown = 0
self.__class__ = IEHtmlWindowBase
_activex.IEHtmlWindowBase_swigregister(IEHtmlWindowBasePtr)
#---------------------------------------------------------------------------
# Some helper and utility functions for ActiveX
t4 = " " * 4
t8 = " " * 8
def GetAXInfo(ax):
"""
Returns a printable summary of the TypeInfo from the ActiveX instance
passed in.
"""
def ProcessFuncX(f, out, name):
out.append(name)
out.append(t4 + "retType: %s" % f.retType.vt_type)
if f.params:
out.append(t4 + "params:")
for p in f.params:
out.append(t8 + p.name)
out.append(t8+t4+ "in:%s out:%s optional:%s type:%s" % (p.isIn, p.isOut, p.isOptional, p.vt_type))
out.append('')
def ProcessPropX(p, out):
out.append(GernerateAXModule.trimPropName(p.name))
out.append(t4+ "type:%s arg:%s canGet:%s canSet:%s" % (p.type.vt_type, p.arg.vt_type, p.canGet, p.canSet))
out.append('')
out = []
out.append("PROPERTIES")
out.append("-"*20)
for p in ax.GetAXProperties():
ProcessPropX(p, out)
out.append('\n\n')
out.append("METHODS")
out.append("-"*20)
for m in ax.GetAXMethods():
ProcessFuncX(m, out, GernerateAXModule.trimMethodName(m.name))
out.append('\n\n')
out.append("EVENTS")
out.append("-"*20)
for e in ax.GetAXEvents():
ProcessFuncX(e, out, GernerateAXModule.trimEventName(e.name))
out.append('\n\n')
return "\n".join(out)
class GernerateAXModule:
def __init__(self, ax, className, modulePath, moduleName=None, verbose=False):
"""
Make a Python module file with a class that has been specialized
for the AcitveX object.
ax An instance of the ActiveXWindow class
className The name to use for the new class
modulePath The path where the new module should be written to
moduleName The name of the .py file to create. If not given
then the className will be used.
"""
import os
if moduleName is None:
moduleName = className + '.py'
filename = os.path.join(modulePath, moduleName)
if verbose:
print "Creating module in:", filename
print " ProgID: ", ax.GetCLSID().GetProgIDString()
print " CLSID: ", ax.GetCLSID().GetCLSIDString()
print
self.mf = file(filename, "w")
self.WriteFileHeader(ax)
self.WriteEvents(ax)
self.WriteClassHeader(ax, className)
self.WriteMethods(ax)
self.WriteProperties(ax)
self.WriteDocs(ax)
self.mf.close()
del self.mf
def WriteFileHeader(self, ax):
self.write("# This module was generated by the wx.activex.GernerateAXModule class\n"
"# (See also the genaxmodule script.)\n")
self.write("import wx")
self.write("import wx.activex\n")
self.write("clsID = '%s'\nprogID = '%s'\n"
% (ax.GetCLSID().GetCLSIDString(), ax.GetCLSID().GetProgIDString()))
self.write("\n")
def WriteEvents(self, ax):
events = ax.GetAXEvents()
if events:
self.write("# Create eventTypes and event binders")
for e in events:
self.write("wxEVT_%s = wx.activex.RegisterActiveXEvent('%s')"
% (self.trimEventName(e.name), e.name))
self.write()
for e in events:
n = self.trimEventName(e.name)
self.write("EVT_%s = wx.PyEventBinder(wxEVT_%s, 1)" % (n,n))
self.write("\n")
def WriteClassHeader(self, ax, className):
self.write("# Derive a new class from ActiveXWindow")
self.write("""\
class %s(wx.activex.ActiveXWindow):
def __init__(self, parent, ID=-1, pos=wx.DefaultPosition,
size=wx.DefaultSize, style=0, name='%s'):
wx.activex.ActiveXWindow.__init__(self, parent,
wx.activex.CLSID('%s'),
ID, pos, size, style, name)
""" % (className, className, ax.GetCLSID().GetCLSIDString()) )
def WriteMethods(self, ax):
methods = ax.GetAXMethods()
if methods:
self.write(t4, "# Methods exported by the ActiveX object")
for m in methods:
name = self.trimMethodName(m.name)
self.write(t4, "def %s(self%s):" % (name, self.getParameters(m, True)))
self.write(t8, "return self.CallAXMethod('%s'%s)" % (m.name, self.getParameters(m, False)))
self.write()
def WriteProperties(self, ax):
props = ax.GetAXProperties()
if props:
self.write(t4, "# Getters, Setters and properties")
for p in props:
getterName = setterName = "None"
if p.canGet:
getterName = "_get_" + p.name
self.write(t4, "def %s(self):" % getterName)
self.write(t8, "return self.GetAXProp('%s')" % p.name)
if p.canSet:
setterName = "_set_" + p.name
self.write(t4, "def %s(self, %s):" % (setterName, p.arg.name))
self.write(t8, "self.SetAXProp('%s', %s)" % (p.name, p.arg.name))
self.write(t4, "%s = property(%s, %s)" %
(self.trimPropName(p.name), getterName, setterName))
self.write()
def WriteDocs(self, ax):
self.write()
doc = GetAXInfo(ax)
for line in doc.split('\n'):
self.write("# ", line)
def write(self, *args):
for a in args:
self.mf.write(a)
self.mf.write("\n")
def trimEventName(name):
if name.startswith("On"):
name = name[2:]
return name
trimEventName = staticmethod(trimEventName)
def trimPropName(name):
#name = name[0].lower() + name[1:]
name = name.lower()
import keyword
if name in keyword.kwlist: name += '_'
return name
trimPropName = staticmethod(trimPropName)
def trimMethodName(name):
import keyword
if name in keyword.kwlist: name += '_'
return name
trimMethodName = staticmethod(trimMethodName)
def getParameters(self, m, withDefaults):
import keyword
st = ""
# collect the input parameters, if both isIn and isOut are
# False then assume it is an input paramater
params = []
for p in m.params:
if p.isIn or (not p.isIn and not p.isOut):
params.append(p)
# did we get any?
for p in params:
name = p.name
if name in keyword.kwlist: name += '_'
st += ", "
st += name
if withDefaults and p.isOptional:
st += '=None'
return st
#---------------------------------------------------------------------------