py2docfx 0.1.15.dev2025501__py3-none-any.whl → 0.1.15.dev2038808__py3-none-any.whl

py2docfx/venv/venv1/Lib/site-packages/win32com/demos/iebutton.py

@@ -1,214 +0,0 @@
-# -*- coding: latin-1 -*-
-
-# PyWin32 Internet Explorer Button
-#
-# written by Leonard Ritter (paniq@gmx.net)
-# and Robert Förtsch (info@robert-foertsch.com)
-
-
-"""
-This sample implements a simple IE Button COM server
-with access to the IWebBrowser2 interface.
-
-To demonstrate:
-* Execute this script to register the server.
-* Open Pythonwin's Tools -> Trace Collector Debugging Tool, so you can
-  see the output of 'print' statements in this demo.
-* Open a new IE instance.  The toolbar should have a new "scissors" icon,
-  with tooltip text "IE Button" - this is our new button - click it.
-* Switch back to the Pythonwin window - you should see:
-   IOleCommandTarget::Exec called.
-  This is the button being clicked.  Extending this to do something more
-  useful is left as an exercise.
-
-Contribtions to this sample to make it a little "friendlier" welcome!
-"""
-
-# imports section
-
-import pythoncom
-import win32api
-import win32com
-import win32com.server.register
-
-# This demo uses 'print' - use win32traceutil to see it if we have no
-# console.
-try:
-    win32api.GetConsoleTitle()
-except win32api.error:
-    import win32traceutil
-
-
-from win32com.axcontrol import axcontrol
-
-# ensure we know the ms internet controls typelib so we have access to IWebBrowser2 later on
-win32com.client.gencache.EnsureModule("{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}", 0, 1, 1)
-
-
-#
-IObjectWithSite_methods = ["SetSite", "GetSite"]
-IOleCommandTarget_methods = ["Exec", "QueryStatus"]
-
-_iebutton_methods_ = IOleCommandTarget_methods + IObjectWithSite_methods
-_iebutton_com_interfaces_ = [
-    axcontrol.IID_IOleCommandTarget,
-    axcontrol.IID_IObjectWithSite,  # IObjectWithSite
-]
-
-
-class Stub:
-    """
-    this class serves as a method stub,
-    outputting debug info whenever the object
-    is being called.
-    """
-
-    def __init__(self, name):
-        self.name = name
-
-    def __call__(self, *args):
-        print("STUB: ", self.name, args)
-
-
-class IEButton:
-    """
-    The actual COM server class
-    """
-
-    _com_interfaces_ = _iebutton_com_interfaces_
-    _public_methods_ = _iebutton_methods_
-    _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER
-    _button_text_ = "IE Button"
-    _tool_tip_ = "An example implementation for an IE Button."
-    _icon_ = ""
-    _hot_icon_ = ""
-
-    def __init__(self):
-        # put stubs for non-implemented methods
-        for method in self._public_methods_:
-            if not hasattr(self, method):
-                print("providing default stub for %s" % method)
-                setattr(self, method, Stub(method))
-
-    def QueryStatus(self, pguidCmdGroup, prgCmds, cmdtextf):
-        # 'cmdtextf' is the 'cmdtextf' element from the OLECMDTEXT structure,
-        # or None if a NULL pointer was passed.
-        result = []
-        for id, flags in prgCmds:
-            flags |= axcontrol.OLECMDF_SUPPORTED | axcontrol.OLECMDF_ENABLED
-            result.append((id, flags))
-        if cmdtextf is None:
-            cmdtext = None  # must return None if nothing requested.
-        # IE never seems to want any text - this code is here for
-        # demo purposes only
-        elif cmdtextf == axcontrol.OLECMDTEXTF_NAME:
-            cmdtext = "IEButton Name"
-        else:
-            cmdtext = "IEButton State"
-        return result, cmdtext
-
-    def Exec(self, pguidCmdGroup, nCmdID, nCmdExecOpt, pvaIn):
-        print(pguidCmdGroup, nCmdID, nCmdExecOpt, pvaIn)
-        print("IOleCommandTarget::Exec called.")
-        # self.webbrowser.ShowBrowserBar(GUID_IETOOLBAR, not is_ietoolbar_visible())
-
-    def SetSite(self, unknown):
-        if unknown:
-            # first get a command target
-            cmdtarget = unknown.QueryInterface(axcontrol.IID_IOleCommandTarget)
-            # then travel over to a service provider
-            serviceprovider = cmdtarget.QueryInterface(pythoncom.IID_IServiceProvider)
-            # finally ask for the internet explorer application, returned as a dispatch object
-            self.webbrowser = win32com.client.Dispatch(
-                serviceprovider.QueryService(
-                    "{0002DF05-0000-0000-C000-000000000046}", pythoncom.IID_IDispatch
-                )
-            )
-        else:
-            # lose all references
-            self.webbrowser = None
-
-    def GetClassID(self):
-        return self._reg_clsid_
-
-
-def register(classobj):
-    import winreg
-
-    subKeyCLSID = (
-        "SOFTWARE\\Microsoft\\Internet Explorer\\Extensions\\%38s"
-        % classobj._reg_clsid_
-    )
-    try:
-        hKey = winreg.CreateKey(winreg.HKEY_LOCAL_MACHINE, subKeyCLSID)
-        subKey = winreg.SetValueEx(
-            hKey, "ButtonText", 0, winreg.REG_SZ, classobj._button_text_
-        )
-        winreg.SetValueEx(
-            hKey, "ClsidExtension", 0, winreg.REG_SZ, classobj._reg_clsid_
-        )  # reg value for calling COM object
-        winreg.SetValueEx(
-            hKey, "CLSID", 0, winreg.REG_SZ, "{1FBA04EE-3024-11D2-8F1F-0000F87ABD16}"
-        )  # CLSID for button that sends command to COM object
-        winreg.SetValueEx(hKey, "Default Visible", 0, winreg.REG_SZ, "Yes")
-        winreg.SetValueEx(hKey, "ToolTip", 0, winreg.REG_SZ, classobj._tool_tip_)
-        winreg.SetValueEx(hKey, "Icon", 0, winreg.REG_SZ, classobj._icon_)
-        winreg.SetValueEx(hKey, "HotIcon", 0, winreg.REG_SZ, classobj._hot_icon_)
-    except OSError:
-        print("Couldn't set standard toolbar reg keys.")
-    else:
-        print("Set standard toolbar reg keys.")
-
-
-def unregister(classobj):
-    import winreg
-
-    subKeyCLSID = (
-        "SOFTWARE\\Microsoft\\Internet Explorer\\Extensions\\%38s"
-        % classobj._reg_clsid_
-    )
-    try:
-        hKey = winreg.CreateKey(winreg.HKEY_LOCAL_MACHINE, subKeyCLSID)
-        subKey = winreg.DeleteValue(hKey, "ButtonText")
-        winreg.DeleteValue(hKey, "ClsidExtension")  # for calling COM object
-        winreg.DeleteValue(hKey, "CLSID")
-        winreg.DeleteValue(hKey, "Default Visible")
-        winreg.DeleteValue(hKey, "ToolTip")
-        winreg.DeleteValue(hKey, "Icon")
-        winreg.DeleteValue(hKey, "HotIcon")
-        winreg.DeleteKey(winreg.HKEY_LOCAL_MACHINE, subKeyCLSID)
-    except OSError:
-        print("Couldn't delete Standard toolbar regkey.")
-    else:
-        print("Deleted Standard toolbar regkey.")
-
-
-#
-# test implementation
-#
-
-
-class PyWin32InternetExplorerButton(IEButton):
-    _reg_clsid_ = "{104B66A9-9E68-49D1-A3F5-94754BE9E0E6}"
-    _reg_progid_ = "PyWin32.IEButton"
-    _reg_desc_ = "Test Button"
-    _button_text_ = "IE Button"
-    _tool_tip_ = "An example implementation for an IE Button."
-    _icon_ = ""
-    _hot_icon_ = _icon_
-
-
-def DllRegisterServer():
-    register(PyWin32InternetExplorerButton)
-
-
-def DllUnregisterServer():
-    unregister(PyWin32InternetExplorerButton)
-
-
-if __name__ == "__main__":
-    win32com.server.register.UseCommandLine(
-        PyWin32InternetExplorerButton,
-        finalize_register=DllRegisterServer,
-        finalize_unregister=DllUnregisterServer,
-    )

py2docfx/venv/venv1/Lib/site-packages/win32com/demos/ietoolbar.py

@@ -1,368 +0,0 @@
-# -*- coding: latin-1 -*-
-
-# PyWin32 Internet Explorer Toolbar
-#
-# written by Leonard Ritter (paniq@gmx.net)
-# and Robert Förtsch (info@robert-foertsch.com)
-
-
-"""
-This sample implements a simple IE Toolbar COM server
-supporting Windows XP styles and access to
-the IWebBrowser2 interface.
-
-It also demonstrates how to hijack the parent window
-to catch WM_COMMAND messages.
-"""
-
-import array
-import struct
-
-# imports section
-import sys
-import winreg
-
-import commctrl
-import pythoncom
-import win32com
-import win32con
-import win32gui
-import win32ui
-from win32com.axcontrol import axcontrol
-from win32com.client import Dispatch, gencache
-from win32com.shell import shell
-from win32com.shell.shellcon import DBIMF_VARIABLEHEIGHT
-
-# ensure we know the ms internet controls typelib so we have access to IWebBrowser2 later on
-gencache.EnsureModule("{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}", 0, 1, 1)
-
-#
-IDeskBand_methods = ["GetBandInfo"]
-IDockingWindow_methods = ["ShowDW", "CloseDW", "ResizeBorderDW"]
-IOleWindow_methods = ["GetWindow", "ContextSensitiveHelp"]
-IInputObject_methods = ["UIActivateIO", "HasFocusIO", "TranslateAcceleratorIO"]
-IObjectWithSite_methods = ["SetSite", "GetSite"]
-IPersistStream_methods = ["GetClassID", "IsDirty", "Load", "Save", "GetSizeMax"]
-
-_ietoolbar_methods_ = (
-    IDeskBand_methods
-    + IDockingWindow_methods
-    + IOleWindow_methods
-    + IInputObject_methods
-    + IObjectWithSite_methods
-    + IPersistStream_methods
-)
-_ietoolbar_com_interfaces_ = [
-    shell.IID_IDeskBand,  # IDeskBand
-    axcontrol.IID_IObjectWithSite,  # IObjectWithSite
-    pythoncom.IID_IPersistStream,
-    axcontrol.IID_IOleCommandTarget,
-]
-
-
-class WIN32STRUCT:
-    def __init__(self, **kw):
-        full_fmt = ""
-        for name, fmt, default in self._struct_items_:
-            self.__dict__[name] = None
-            if fmt == "z":
-                full_fmt += "pi"
-            else:
-                full_fmt += fmt
-        for name, val in kw.items():
-            self.__dict__[name] = val
-
-    def __setattr__(self, attr, val):
-        if not attr.startswith("_") and attr not in self.__dict__:
-            raise AttributeError(attr)
-        self.__dict__[attr] = val
-
-    def toparam(self):
-        self._buffs = []
-        full_fmt = ""
-        vals = []
-        for name, fmt, default in self._struct_items_:
-            val = self.__dict__[name]
-            if fmt == "z":
-                fmt = "Pi"
-                if val is None:
-                    vals.append(0)
-                    vals.append(0)
-                else:
-                    str_buf = array.array("c", val + "\0")
-                    vals.append(str_buf.buffer_info()[0])
-                    vals.append(len(val))
-                    self._buffs.append(str_buf)  # keep alive during the call.
-            else:
-                if val is None:
-                    val = default
-                vals.append(val)
-            full_fmt += fmt
-        return struct.pack(*(full_fmt,) + tuple(vals))
-
-
-class TBBUTTON(WIN32STRUCT):
-    _struct_items_ = [
-        ("iBitmap", "i", 0),
-        ("idCommand", "i", 0),
-        ("fsState", "B", 0),
-        ("fsStyle", "B", 0),
-        ("bReserved", "H", 0),
-        ("dwData", "I", 0),
-        ("iString", "z", None),
-    ]
-
-
-class Stub:
-    """
-    this class serves as a method stub,
-    outputting debug info whenever the object
-    is being called.
-    """
-
-    def __init__(self, name):
-        self.name = name
-
-    def __call__(self, *args):
-        print("STUB: ", self.name, args)
-
-
-class IEToolbarCtrl:
-    """
-    a tiny wrapper for our winapi-based
-    toolbar control implementation.
-    """
-
-    def __init__(self, hwndparent):
-        styles = (
-            win32con.WS_CHILD
-            | win32con.WS_VISIBLE
-            | win32con.WS_CLIPSIBLINGS
-            | win32con.WS_CLIPCHILDREN
-            | commctrl.TBSTYLE_LIST
-            | commctrl.TBSTYLE_FLAT
-            | commctrl.TBSTYLE_TRANSPARENT
-            | commctrl.CCS_TOP
-            | commctrl.CCS_NODIVIDER
-            | commctrl.CCS_NORESIZE
-            | commctrl.CCS_NOPARENTALIGN
-        )
-        self.hwnd = win32gui.CreateWindow(
-            "ToolbarWindow32",
-            None,
-            styles,
-            0,
-            0,
-            100,
-            100,
-            hwndparent,
-            0,
-            win32gui.dllhandle,
-            None,
-        )
-        win32gui.SendMessage(self.hwnd, commctrl.TB_BUTTONSTRUCTSIZE, 20, 0)
-
-    def ShowWindow(self, mode):
-        win32gui.ShowWindow(self.hwnd, mode)
-
-    def AddButtons(self, *buttons):
-        tbbuttons = ""
-        for button in buttons:
-            tbbuttons += button.toparam()
-        return win32gui.SendMessage(
-            self.hwnd, commctrl.TB_ADDBUTTONS, len(buttons), tbbuttons
-        )
-
-    def GetSafeHwnd(self):
-        return self.hwnd
-
-
-class IEToolbar:
-    """
-    The actual COM server class
-    """
-
-    _com_interfaces_ = _ietoolbar_com_interfaces_
-    _public_methods_ = _ietoolbar_methods_
-    _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER
-    # if you copy and modify this example, be sure to change the clsid below
-    _reg_clsid_ = "{F21202A2-959A-4149-B1C3-68B9013F3335}"
-    _reg_progid_ = "PyWin32.IEToolbar"
-    _reg_desc_ = "PyWin32 IE Toolbar"
-
-    def __init__(self):
-        # put stubs for non-implemented methods
-        for method in self._public_methods_:
-            if not hasattr(self, method):
-                print("providing default stub for %s" % method)
-                setattr(self, method, Stub(method))
-
-    def GetWindow(self):
-        return self.toolbar.GetSafeHwnd()
-
-    def Load(self, stream):
-        # called when the toolbar is loaded
-        pass
-
-    def Save(self, pStream, fClearDirty):
-        # called when the toolbar shall save its information
-        pass
-
-    def CloseDW(self, dwReserved):
-        del self.toolbar
-
-    def ShowDW(self, bShow):
-        if bShow:
-            self.toolbar.ShowWindow(win32con.SW_SHOW)
-        else:
-            self.toolbar.ShowWindow(win32con.SW_HIDE)
-
-    def on_first_button(self):
-        print("first!")
-        self.webbrowser.Navigate2("https://github.com/mhammond/pywin32")
-
-    def on_second_button(self):
-        print("second!")
-
-    def on_third_button(self):
-        print("third!")
-
-    def toolbar_command_handler(self, args):
-        hwnd, message, wparam, lparam, time, point = args
-        if lparam == self.toolbar.GetSafeHwnd():
-            self._command_map[wparam]()
-
-    def SetSite(self, unknown):
-        if unknown:
-            # retrieve the parent window interface for this site
-            olewindow = unknown.QueryInterface(pythoncom.IID_IOleWindow)
-            # ask the window for its handle
-            hwndparent = olewindow.GetWindow()
-
-            # first get a command target
-            cmdtarget = unknown.QueryInterface(axcontrol.IID_IOleCommandTarget)
-            # then travel over to a service provider
-            serviceprovider = cmdtarget.QueryInterface(pythoncom.IID_IServiceProvider)
-            # finally ask for the internet explorer application, returned as a dispatch object
-            self.webbrowser = Dispatch(
-                serviceprovider.QueryService(
-                    "{0002DF05-0000-0000-C000-000000000046}", pythoncom.IID_IDispatch
-                )
-            )
-
-            # now create and set up the toolbar
-            self.toolbar = IEToolbarCtrl(hwndparent)
-
-            buttons = [
-                ("Visit PyWin32 Homepage", self.on_first_button),
-                ("Another Button", self.on_second_button),
-                ("Yet Another Button", self.on_third_button),
-            ]
-
-            self._command_map = {}
-            # wrap our parent window so we can hook message handlers
-            window = win32ui.CreateWindowFromHandle(hwndparent)
-
-            # add the buttons
-            for i in range(len(buttons)):
-                button = TBBUTTON()
-                name, func = buttons[i]
-                id = 0x4444 + i
-                button.iBitmap = -2
-                button.idCommand = id
-                button.fsState = commctrl.TBSTATE_ENABLED
-                button.fsStyle = commctrl.TBSTYLE_BUTTON
-                button.iString = name
-                self._command_map[0x4444 + i] = func
-                self.toolbar.AddButtons(button)
-                window.HookMessage(self.toolbar_command_handler, win32con.WM_COMMAND)
-        else:
-            # lose all references
-            self.webbrowser = None
-
-    def GetClassID(self):
-        return self._reg_clsid_
-
-    def GetBandInfo(self, dwBandId, dwViewMode, dwMask):
-        ptMinSize = (0, 24)
-        ptMaxSize = (2000, 24)
-        ptIntegral = (0, 0)
-        ptActual = (2000, 24)
-        wszTitle = "PyWin32 IE Toolbar"
-        dwModeFlags = DBIMF_VARIABLEHEIGHT
-        crBkgnd = 0
-        return (
-            ptMinSize,
-            ptMaxSize,
-            ptIntegral,
-            ptActual,
-            wszTitle,
-            dwModeFlags,
-            crBkgnd,
-        )
-
-
-# used for HKLM install
-def DllInstall(bInstall, cmdLine):
-    comclass = IEToolbar
-
-
-# register plugin
-def DllRegisterServer():
-    comclass = IEToolbar
-
-    # register toolbar with IE
-    try:
-        print("Trying to register Toolbar.\n")
-        hkey = winreg.CreateKey(
-            winreg.HKEY_LOCAL_MACHINE, "SOFTWARE\\Microsoft\\Internet Explorer\\Toolbar"
-        )
-        subKey = winreg.SetValueEx(
-            hkey, comclass._reg_clsid_, 0, winreg.REG_BINARY, b"\0"
-        )
-    except OSError:
-        print(
-            "Couldn't set registry value.\nhkey: %d\tCLSID: %s\n"
-            % (hkey, comclass._reg_clsid_)
-        )
-    else:
-        print(
-            "Set registry value.\nhkey: %d\tCLSID: %s\n" % (hkey, comclass._reg_clsid_)
-        )
-    # TODO: implement reg settings for standard toolbar button
-
-
-# unregister plugin
-def DllUnregisterServer():
-    comclass = IEToolbar
-
-    # unregister toolbar from internet explorer
-    try:
-        print("Trying to unregister Toolbar.\n")
-        hkey = winreg.CreateKey(
-            winreg.HKEY_LOCAL_MACHINE, "SOFTWARE\\Microsoft\\Internet Explorer\\Toolbar"
-        )
-        winreg.DeleteValue(hkey, comclass._reg_clsid_)
-    except OSError:
-        print(
-            "Couldn't delete registry value.\nhkey: %d\tCLSID: %s\n"
-            % (hkey, comclass._reg_clsid_)
-        )
-    else:
-        print("Deleting reg key succeeded.\n")
-
-
-# entry point
-if __name__ == "__main__":
-    import win32com.server.register
-
-    win32com.server.register.UseCommandLine(IEToolbar)
-
-    # parse actual command line option
-    if "--unregister" in sys.argv:
-        DllUnregisterServer()
-    else:
-        DllRegisterServer()
-else:
-    # import trace utility for remote debugging
-    import win32traceutil