ó ˛Í[Mc@s–ddlZddlZddlZddlZddlZejejZddddej dd„Z dddd„Z ej d„Z ej d„Zddddej d„Zddddddd„Zdejfd „ƒYZd „Zd dd „ƒYZeƒZd „Zddd„ƒYZd„Zd„Zd„Zd„Zddd„ƒYZddd„Zddd„Zddd„ƒYZdS(i˙˙˙˙Nc Csç|dkstd‚|dkrvy5|jƒ}|dk rUt|jƒdƒ}nWqvtjtfk rrqvXn|dk rśddl}|j |ƒ}|dk rś||ƒSn|dkrËt }nt j ||||d|ƒS(s{ Helper function to return a makepy generated class for a CLSID if it exists, otherwise cope by using CDispatch. s#this is deprecated and will go awayii˙˙˙˙Ntclsctx( tNonetAssertionErrort GetTypeInfotstrt GetTypeAttrt pythoncomt com_errortAttributeErrortgencachetGetClassForCLSIDt CDispatchtdynamictDispatch( tdispatchtuserNamet resultCLSIDttypeinfotUnicodeToStringRt WrapperClassR tklass((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyt__WrapDispatchs         cCs|dkrtj}n|dkr0|dksH|dk rW|dk rWtdƒ‚n|dk rpt||ƒSt||ƒSdS(s@ Mimic VB's GetObject() function. ob = GetObject(Class = "ProgID") or GetObject(Class = clsid) will connect to an already running instance of the COM object. ob = GetObject(r"c:lahlah oo.xls") (aka the COM moniker syntax) will return a ready to use Python wrapping of the required COM object. Note: You must specifiy one or the other of these arguments. I know this isn't pretty, but it is what VB does. Blech. If you don't I'll throw ValueError at you. :) This will most likely throw pythoncom.com_error if anything fails. s=You must specify a value for Pathname or Class, but not both.N(RRt CLSCTX_ALLt ValueErrortGetActiveObjecttMoniker(tPathnametClassR((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyt GetObject.s    cCsItj|ƒ}tj|ƒ}|jtjƒ}t||d|d|ƒS(sJ Python friendly version of GetObject's ProgID/CLSID functionality. RR(t pywintypestIIDRRtQueryInterfacet IID_IDispatchR(RRRR((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyRJscCsCtj|ƒ\}}}|j|dtjƒ}t||d|ƒS(sE Python friendly version of GetObject's moniker functionality. RN(RtMkParseDisplayNamet BindToObjectRR R(RRtmonikertitbindCtxR((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyRSscCsI|dkstd‚tj|||ƒ\}}t||||d|ƒS(s'Creates a Dispatch based COM object. s#this is deprecated and will go awayRN(RRR t_GetGoodDispatchAndUserNameR(RRRRRR((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyR [sc Csť|dkstd‚|dkrJtj}|dk rJ|tj@}qJn|dkr_d}n |f}|dkr}|}ntj|d||tjfƒd}t||||d|ƒS(s=Creates a Dispatch based COM object on a specific machine. s#this is deprecated and will go awayiRN(RRRt CLSCTX_SERVERt CLSCTX_INPROCtCoCreateInstanceExR R ( tclsidtmachineRRRRRt serverInfoR((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyt DispatchExbs       %R cBs eZdZdddd„ZRS(sî The dynamic class used as a last resort. The purpose of this overriding of dynamic.CDispatch is to perpetuate the policy of using the makepy generated wrapper Python class instead of dynamic.CDispatch if/when possible. cCs(|dkstd‚t|||dƒS(Ns#this is deprecated and will go away(RRR (tselftobRt returnCLSIDR((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyt_wrap_dispatch_{sN(t__name__t __module__t__doc__RR1(((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyR tscCs t|dƒrd|jjkr3tj|ƒ}nd|jjkrTtdƒ‚n|j}tj|ƒ}tj|j|j |j |j ƒ}|j j |ƒ}|dkrÇtd||fƒ‚ntj|ƒ}t||ƒ}t|d|ƒ}||ƒSt‚dS(s('Cast' a COM object to another interfacetindextCLSIDs-Must be a makepy-able object for this to worksJThe interface name '%s' does not appear in the same library as object '%r'tdefault_interfaceN(thasattrt __class__t__dict__R tEnsureDispatchRR6tGetModuleForCLSIDtGetModuleForTypelibtLCIDt MajorVersiont MinorVersiont NamesToIIDMaptgetRtgetattr(R/ttargetR*tmodt target_clsidt target_class((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pytCastTos$   t ConstantscBs eZdZd„Zd„ZRS(s+A container for generated COM constants. cCs g|_dS(N(t __dicts__(R.((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyt__init__¤scCs8x%|jD]}||kr ||Sq Wt|ƒ‚dS(N(RJR(R.tatd((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyt __getattr__Śs  (R2R3R4RKRN(((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyRIĄs cCsFy!|jjdj|||ƒWntk rA||j|>> class IEEvents: ... def OnVisible(self, visible): ... print "Visible changed:", visible ... >>> ie = DispatchWithEvents("InternetExplorer.Application", IEEvents) >>> ie.Visible = 1 Visible changed: 1 >>> R6iiiit bValidateFiles`This COM object can not automate the makepy process - please run makepy manually for this objecti˙˙˙˙(t ClassTypes(This COM object does not support events.t COMEventClassRPRKN(R R9R:RBt_oleobj_RRtGetContainingTypeLibt GetLibAttrR t EnsureModuletGetClassForProgIDRRRt TypeErrorR6ttypesRZt ImportErrorttypet geteventsRRRSRKR8RT( R*tuser_event_classtdispttit disp_clsidttlbR5ttlat disp_classtnew_typet events_classt result_classtinstance((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pytDispatchWithEventsÍs4(  ,      "c CsXt|ƒ}|jjjdƒsÉy‚|jjƒ}|jƒd}|jƒ\}}|jƒ}t j |d|d|d|dddƒt j t |ƒƒ}WqŇt jk rĹtdƒ‚qŇXn |j}|j}dd l} t|ƒ} | d krtd ƒ‚n| jd | |fiƒ} | |ƒ} t|d ƒrT|j| ƒn| S( s^Similar to DispatchWithEvents - except that the returned object is *not* also usable as the original Dispatch object - that is the returned object is not dispatchable. The difference is best summarised by example. >>> class IEEvents: ... def OnVisible(self, visible): ... print "Visible changed:", visible ... >>> ie = Dispatch("InternetExplorer.Application") >>> ie_events = WithEvents(ie, IEEvents) >>> ie.Visible = 1 Visible changed: 1 Compare with the code sample for DispatchWithEvents, where you get a single object that is both the interface and the event handler. Note that the event handler instance will *not* be able to use 'self.' to refer to IE's methods and properties. This is mainly useful where using DispatchWithEvents causes circular reference problems that the simple proxy doesn't deal with R6iiiiRYs`This COM object can not automate the makepy process - please run makepy manually for this objecti˙˙˙˙Ns(This COM object does not support events.R[RK(R R9R:RBR\RRR]R^R R_R`RRRRaR6tnewReRRtclassobjR8RK( RgRfRhRiRjR5RkRlR*RrRnRoRp((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyt WithEventss,  ,      cCssttj|ƒƒ}tj|ƒ}y |jSWn=tk rnytj|jƒjSWqotk rjdSXnXdS(sCDetermine the default outgoing interface for a class, given either a clsid or progid. It returns a class - you can conveniently derive your own handler from this class and implement the appropriate methods. This method relies on the classes produced by makepy. You must use either makepy or the gencache module to ensure that the appropriate support classes have been generated for the com server that you will be handling events from. Beware of COM circular references. When the Events class is connected to the COM object, the COM object itself keeps a reference to the Python events class. Thus, neither the Events instance or the COM object will ever die by themselves. The 'close' method on the events instance must be called to break this chain and allow standard Python collection rules to manage object lifetimes. Note that DispatchWithEvents() does work around this problem by the use of a proxy object, but if you use the getevents() function yourself, you must make your own arrangements to manage this circular reference issue. Beware of creating Python circular references: this will happen if your handler has a reference to an object that has a reference back to the event source. Call the 'close' method to break the chain. Example: >>>win32com.client.gencache.EnsureModule('{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}',0,1,1) >> >>> class InternetExplorerEvents(win32com.client.getevents("InternetExplorer.Application.1")): ... def OnVisible(self, Visible): ... print "Visibility changed: ", Visible ... >>> >>> ie=win32com.client.Dispatch("InternetExplorer.Application.1") >>> events=InternetExplorerEvents(ie) >>> ie.Visible=1 Visibility changed: 1 >>> N( RRRR R tdefault_sourceRt coclass_clsidR(R*R((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyReJs+   cCs˛ddl}|j|ƒ}tj|jj}|j|j|j|j |j ƒ}y|j |}Wn't k rŒt d||fƒ‚nXtj|j|j |j |j|ƒS(s)Creates a new record object, given the name of the record, and an object from the same type library. Example usage would be: app = win32com.client.Dispatch("Some.Application") point = win32com.client.Record("SomeAppPoint", app) point.x = 0 point.y = 0 app.MoveTo(point) i˙˙˙˙Ns0The structure '%s' is not defined in module '%s'(R R;tsystmodulesR9R3R=R6R>R?R@t RecordMaptKeyErrorRRtGetRecordFromGuids(tnametobjectR tmoduletpackaget struct_guid((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pytRecord‚s $ tDispatchBaseClasscBsheZd d„Zd„Zd„Zd„Zd„Zd„Zd„Z d d d„Z d d d„Z RS( cCs˛|dkr!tj|jƒ}n€t|ƒt|ƒkrĄy|jj|jtjƒ}WqĄtjk r}ddl }|j |j kr‘‚n|j}qĄXn||j d(RwRxR9R3R4R2Rztid(R.tmod_doctmod_name((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyt__repr__˛s   cCst|d|ƒ}|j|kS(NR\(RCR\(R.tother((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyt__eq__žscCst|d|ƒ}|j|kS(NR\(RCR\(R.RŒ((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyt__ne__ÂscGs.|j|jj|d||||Œ||ƒS(Ni(t_get_good_object_R\t InvokeTypes(R.tdispidtwFlagstretTypetargTypestuserRtargs((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyt _ApplyTypes_ĆscCsJ|jj|ƒ}|dkr=tdt|ƒ|fƒ‚n|j|ŒS(Ns!'%s' object has no attribute '%s'(t_prop_map_get_RBRRtreprR—(R.RQR–((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyRNËs cCs†||jkr ||j|(R4R9R2(R.((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyR‹ńscCs6|jd}|dk r&t||ƒSt|ƒ‚dS(NRŠ(R:RRCR(R.RQRM((s;C:\RCS\Python\lib\site-packages\win32com\client\__init__.pyRNôs  cCsv||jkr ||j| s6          "   I 4 8 =