python模块之pywin32使用文档,python操作windowsAPI

文章目录

  • 一、pywin32简介
    • 1、windowsAPI是什么
    • 2、pywin32模块
    • 3、安装pywin32
  • 二、常用模块:pywintypes
    • 0、使用
    • 1、CreateGuid:生成唯一标识符
  • 三、常用模块:win32api
    • 0、使用
    • 1、AbortSystemShutdown:关机
    • 2、Beep:发出声音
    • 3、ClipCursor:限制鼠标范围
    • 4、CloseHandle:关闭文件句柄
    • 5、CopyFile:复制文件
    • 6、DeleteFile:删除文件
    • 7、ExitWindows:注销当前用户
    • 8、GetComputerName:获取计算机名
    • 9、GetCursorPos:返回鼠标位置
    • 10、GetLocalTime:获取当前时间
    • 11、MessageBeep:发出预定义的声音
    • 12、TerminateProcess:终止进程
    • 13、其他
  • 四、剪切板模块:win32clipboard
  • 五、文件模块:win32file
  • 六、ui模块:win32gui
    • 1、常用方法
    • 2、获取窗口并设为活跃窗口

一、pywin32简介

1、windowsAPI是什么

Windows API(Application Programming Interface)是一组函数、数据结构、指令集等的集合,用于操作和控制Windows操作系统的各种功能和特性。它提供了一种通过编程方式与Windows进行交互的接口。

Windows API允许开发人员使用编程语言(如C/C++、Python等)调用和使用Windows操作系统的内部功能,如创建和管理进程、访问和修改文件系统、读取和写入注册表、绘制图形、操作窗口和控件、网络通信等。通过Windows API,开发人员可以利用操作系统提供的功能和资源,构建各种类型的应用程序。

Windows API以动态链接库(DLL)的形式提供,开发人员可以通过引入相应的库文件并使用库中的函数和数据结构,来实现对特定功能的调用和操作。使用Windows API可以完成从底层系统操作到高级应用程序开发的各个层次的任务。

Windows API是使用非常广泛的API之一,广泛应用于Windows软件开发、系统编程、驱动程序开发等领域。

win32API参考手册:http://www.yfvb.com/help/win32sdk/index.htm

微软win32API手册:https://learn.microsoft.com/zh-cn/windows/win32/

2、pywin32模块

pywin32是一个Python扩展模块,它提供了与Windows操作系统的API进行交互的功能。具体而言,pywin32模块可以用于在Python中调用和操作Windows的各种系统功能,包括但不限于以下功能:

  1. 与Windows API的交互:pywin32提供了对Windows的API函数的封装,使得在Python中可以直接调用这些API函数进行操作,如创建和管理进程、访问和修改注册表、操作文件和文件夹等。
  2. COM组件和ActiveX对象的操作:pywin32支持使用COM技术(Component Object Model)与Windows操作系统中的COM组件进行交互。通过pywin32,可以创建、操纵和使用COM组件、ActiveX对象和OLE对象,实现与Windows应用程序和组件的集成。
  3. Windows服务的管理:pywin32提供了管理Windows服务的功能,可以通过pywin32创建和管理Windows服务,包括安装、启动、停止和删除Windows服务。
  4. GUI编程:pywin32模块还提供了与Windows的图形用户界面(GUI)进行交互的功能。它可以创建和操作Windows窗口、对话框,以及访问和修改窗口控件的属性和事件。

总之,pywin32模块提供了丰富的功能和方法,可以在Python中直接调用Windows操作系统的API,实现与Windows相关的操作和功能。

该项目是开源的,地址为:https://github.com/mhammond/pywin32

api地址为:http://timgolden.me.uk/pywin32-docs/contents.html

3、安装pywin32

# 直接安装
pip install pywin32

安装完成之后,在python安装目录下:\Lib\site-packages,会有一个PyWin32.chm文件,就是使用文档。

pywin32把Windows API按照功能分了一些大类,每一个大类作为一个模块。以下是所有的模块:

_winxptheme:提供专为xp系统的主题API
mmapfile:编译的扩展模块,提供对内存映射文件API的访问
odbc:odb数据库api
perfmon:包装性能监视器功能的模块。
pywintypes:支持常见 Windows 类型的模块。
servicemanager:与 Windows 服务控制管理器交互的模块。
timer:包装 Win32 Timer 函数的扩展
win2kras:将 Windows 2000 扩展封装到远程访问服务 (RAS) API 的模块。
win32api:提供了常用的用户API
win32clipboard:提供了有关粘贴板的API
win32con:有关的常量
win32console:控制台
win32cred:凭证管理功能的接口。此模块中的功能仅适用于 Windows XP 及更高版本。
win32crypt:win32 Cryptography API 的接口
win32event:提供了win32事件/等待API
win32evtlog:封装了 Windows Win32 事件日志 API。
win32file:提供了有关文件操作的API
win32gui:提供了有关windows用户界面图形操作的API
win32help:Win32 help API’s
win32inet:Windows internet (wininet) API的接口
win32job:win32进程和线程API的接口,可在Windows 2000及更高版本中使用。
win32lz:封装 Windows LZ 压缩例程的模块
win32net:Windows internet (wininet) API的接口
win32pdh:封装了Windows性能数据助手API
win32pipe:管道api
win32print:封装Windows打印API
win32process:进程api
win32profile:包装用于处理用户配置文件的函数
win32ras:封装Windows远程访问服务(RAS) API
win32security:win32安全API的接口
win32service:服务
win32trace
win32transaction:用于事务化的NTFS和事务化的注册表函数
win32ts:这个模块中的所有函数都接受关键字参数
win32wnet:公开Windows网络API
winxpgui:xp图像用户界面API

二、常用模块:pywintypes

0、使用

使用前需要引入:

import pywintypes

1、CreateGuid:生成唯一标识符

返回一个字符串,格式为{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}

PyIID = pywintypes.CreateGuid()
print(PyIID) # {BB02ECB7-BC18-4336-A65C-C9C0CE548020}

三、常用模块:win32api

0、使用

使用前需要引入:

import win32api

1、AbortSystemShutdown:关机

import win32api

# 取消系统关闭操作
win32api.AbortSystemShutdown(computer_name=None)

该方法的参数computer_name是可选的,用于指定要取消系统关闭操作的计算机名称。如果未提供computer_name参数,则默认为本地计算机。

注意:该方法要求以管理员权限运行,否则会抛出权限错误。

2、Beep:发出声音

import win32api

# 发出一次短促的蜂鸣声
win32api.Beep(freq, duration)

该方法接受两个参数:
freq:表示发声的频率,以赫兹(Hz)为单位。常见的频率可以尝试使用440(标准音A)。
duration:表示发声持续的时间,以毫秒(ms)为单位。
请注意,该方法可能不适用于所有的计算机和操作系统。在某些系统中可能无法产生蜂鸣声音。

3、ClipCursor:限制鼠标范围

pywin32模块中,win32api.ClipCursor方法用于限制鼠标光标的移动范围在指定的矩形区域内。

import win32api
# 定义矩形的左上角和右下角坐标
left, top, right, bottom = 100, 100, 500, 500

# 创建矩形对象
rect = (left, top, right, bottom)

# 限制鼠标光标的移动范围
win32api.ClipCursor(rect)

# 取消限制,恢复正常的鼠标光标移动范围
win32api.ClipCursor(None)

在这个示例中,首先我们定义了一个矩形区域的左上角和右下角坐标。然后,使用win32api.ClipCursor方法将鼠标光标的移动范围限制在该矩形区域内,传入矩形的坐标参数。最后,使用win32api.ClipCursor(None)取消对鼠标光标移动范围的限制,恢复正常的移动范围。

注意:在使用win32api.ClipCursor方法之后,记得一定要及时取消限制,以免造成鼠标无法移动的情况。

4、CloseHandle:关闭文件句柄

pywin32模块中,win32api.CloseHandle方法用于关闭一个句柄(handle)。

import win32api
# 打开或创建一个文件,并获取文件的句柄
handle = win32api.CreateFile("path/to/file", win32api.GENERIC_READ, 0, None, win32api.OPEN_EXISTING, 0, None)

# 使用句柄进行一些操作

# 关闭句柄
win32api.CloseHandle(handle)

在这个示例中,首先我们使用win32api.CreateFile方法打开或创建一个文件,并获取文件的句柄。然后,使用这个句柄进行一些操作。最后,使用win32api.CloseHandle方法关闭句柄,确保资源的释放和内存的回收。

请注意,在使用完句柄后,务必记得及时关闭句柄,以免资源泄露或其他不可预见的问题。

5、CopyFile:复制文件

import win32api
# 源文件路径
src_file = "path/to/source/file"

# 目标文件路径
dst_file = "path/to/destination/file"

# 复制文件
win32api.CopyFile(src_file, dst_file)

CopyFile支持多传一个int类型参数:指示如果文件存在,操作是否应该失败,默认为0。

6、DeleteFile:删除文件

win32api.DeleteFile(fileName)

7、ExitWindows:注销当前用户

pywin32模块中,win32api.ExitWindows方法用于执行系统的关机、重启、注销或关闭等操作。

import win32api
# 执行关机操作(将在 30 秒后关机)
win32api.ExitWindowsEx(win32api.EWX_SHUTDOWN | win32api.EWX_FORCE, 30)

在这个示例中,我们使用win32api.ExitWindowsEx方法执行关机操作。win32api.EWX_SHUTDOWN指定了要执行的操作为关机操作,win32api.EWX_FORCE指定了强制执行关机操作。最后的参数 30 表示延迟关机的时间,单位为秒(默认为 0)。

除了关机操作,还可以使用其他参数来执行其他操作,如重启、注销、锁定等。以下是一些常用的系统操作参数:

win32api.EWX_LOGOFF:注销
win32api.EWX_REBOOT:重启
win32api.EWX_SHUTDOWN:关机
win32api.EWX_POWEROFF:关闭电源(需要特权)
可以根据需要选择适合的操作参数。请注意,某些操作可能需要管理员权限才能执行成功。

另外,也可以使用win32api.InitiateSystemShutdown方法进行关机操作,它提供更多的自定义选项。

8、GetComputerName:获取计算机名

import win32api
# 获取计算机名称
computer_name = win32api.GetComputerName()

print(f"Computer Name: {computer_name}")

9、GetCursorPos:返回鼠标位置

import win32api
a, b = win32api.GetCursorPos()

print(a)
print(b)

10、GetLocalTime:获取当前时间

# 结果:(2023, 11, 3, 15, 10, 12, 23, 214)
win32api.GetLocalTime()
win32api.GetSystemTime()

11、MessageBeep:发出预定义的声音

win32api.MessageBeep(1)

12、TerminateProcess:终止进程

import win32api
import win32con

# 根据进程ID终止进程
def kill_process_by_pid(pid):
    # 打开进程句柄
    handle = win32api.OpenProcess(win32con.PROCESS_TERMINATE, False, pid)
    if handle:
        # 终止进程
        win32api.TerminateProcess(handle, 0)
        # 关闭进程句柄
        win32api.CloseHandle(handle)

# 根据进程名称终止进程
def kill_process_by_name(name):
    import psutil
    for process in psutil.process_iter(['name', 'pid']):
        if process.info['name'] == name:
            pid = process.info['pid']
            kill_process_by_pid(pid)

# 终止名为"program_name.exe"的进程
kill_process_by_name("program_name.exe")

在上面的代码中,我们定义了两个函数:kill_process_by_pid()和kill_process_by_name()。kill_process_by_pid()函数使用进程ID(pid)来终止进程,而kill_process_by_name()函数使用进程名称来终止进程。在kill_process_by_name()函数中,我们使用了psutil模块来获取正在运行的进程列表,并根据进程名称匹配要终止的进程。

请注意,在使用win32api.TerminateProcess()函数时,要谨慎操作,因为它可以立即终止进程,而不进行任何清理工作。

13、其他

还有各种内存、文件、鼠标、键盘等操作的。

四、剪切板模块:win32clipboard

win32clipboard 模块提供了对 Windows 系统剪贴板的访问。

以下是 win32clipboard 模块的常用方法和属性:

OpenClipboard(hwnd):打开剪贴板。hwnd 是一个可选参数,用于指定当前活动窗口的句柄。
CloseClipboard():关闭剪贴板。
EmptyClipboard():清空剪贴板。
GetClipboardData(format):获取剪贴板中的数据。format 是一个可选参数,用于指定数据的格式。常见的格式有:
win32con.CF_TEXT:文本格式
win32con.CF_UNICODETEXT:Unicode 文本格式
win32con.CF_DIB:位图格式
SetClipboardData(format, data):设置剪贴板中的数据。format 是数据的格式,data 是要设置的数据。
IsClipboardFormatAvailable(format):检查指定格式的数据是否在剪贴板中可用。

import win32clipboard
import win32con

# 打开剪贴板
win32clipboard.OpenClipboard()

# 清空剪贴板
win32clipboard.EmptyClipboard()

# 设置文本数据
win32clipboard.SetClipboardData(win32con.CF_TEXT, b"Hello, World!")

# 获取文本数据
data = win32clipboard.GetClipboardData(win32con.CF_TEXT)
print(data)

# 检查指定格式的数据是否可用
is_available = win32clipboard.IsClipboardFormatAvailable(win32con.CF_UNICODETEXT)
print(is_available)

# 关闭剪贴板
win32clipboard.CloseClipboard()

上述代码打开剪贴板,清空剪贴板,设置文本数据,获取文本数据,并检查指定格式的数据是否可用,最后关闭剪贴板。

五、文件模块:win32file

win32file模块是pywin32模块中的一个子模块,用于处理Windows文件和文件系统的相关操作。

win32file模块提供了一些方法和常量来处理文件的读写、文件属性的获取和设置、文件系统的操作等。以下是这个模块的一些常用方法和功能的详细说明:

CreateFile(filename, access, share_mode, security_attributes, creation_disposition, flags_and_attributes, template_file):创建或打开一个文件,并返回一个文件句柄。
CloseHandle(handle):关闭一个文件句柄。
ReadFile(handle, buffer, overlapped):从文件中读取数据,并将结果存入指定的缓冲区。
WriteFile(handle, buffer, overlapped):将数据写入文件。
GetFileSize(handle):获取指定文件的大小。
SetFileAttributes(filename, file_attributes):设置文件的属性,比如只读、隐藏等。
GetFileAttributes(filename):获取文件的属性。
DeleteFile(filename):删除指定的文件。
GetFileInformationByHandle(handle):通过文件句柄获取文件的信息,如文件大小、创建时间等。
FindFirstFile(filename):查找指定文件/文件夹,并返回一个用于遍历结果的搜索句柄。
FindNextFile(handle):通过搜索句柄获取下一个文件/文件夹的信息。
FindClose(handle):关闭搜索句柄。
这些方法提供了对文件和文件系统进行操作的功能。可以使用这些方法来创建、打开、读写文件,获取和设置文件属性,删除文件,遍历文件夹等等。在使用这些方法之前,需要先安装pywin32模块,并导入win32file模块。

下面是一个示例代码,演示了如何使用win32file模块读取文件的内容和获取文件的大小:

# 我们使用CreateFile方法打开指定的文件,然后使用GetFileSize方法获取文件的大小。接着,我们调用ReadFile方法读取文件的内容,并将结果返回。最后,我们使用CloseHandle方法关闭文件句柄。
#注意,在使用win32file模块时,需要有管理员权限或具有适当的权限来访问和操作文件。
import win32file

def read_file(filename):
    try:
        # 打开文件
        handle = win32file.CreateFile(filename, win32file.GENERIC_READ, 0, None, win32file.OPEN_EXISTING, 0, 0)

        # 获取文件大小
        file_size = win32file.GetFileSize(handle)

        # 读取文件内容
        buffer = win32file.ReadFile(handle, file_size)

        # 关闭文件句柄
        win32file.CloseHandle(handle)

        return buffer
    except Exception as e:
        print("Error:", e)

# 读取文件内容
filename = "test.txt"
file_content = read_file(filename)
print(file_content)

六、ui模块:win32gui

1、常用方法

win32gui模块定义了windows窗口的常用方法:

import win32gui
# 获取窗口句柄
hwnd = win32gui.FindWindow(None, "窗口标题")
print(hwnd)
# 获取窗口位置和大小:
import win32gui
hwnd = win32gui.FindWindow(None, "窗口标题")
rect = win32gui.GetWindowRect(hwnd)
left, top, right, bottom = rect
print("窗口位置:(左:{}, 上:{})".format(left, top))
print("窗口大小:(宽:{}, 高:{})".format(right - left, bottom - top))
# 获取窗口的父窗口和子窗口:
import win32gui
hwnd = win32gui.FindWindow(None, "窗口标题")
parent_hwnd = win32gui.GetParent(hwnd)
child_hwnds = []
win32gui.EnumChildWindows(hwnd, lambda hwnd, param: param.append(hwnd), child_hwnds)
print("父窗口句柄:", parent_hwnd)
print("子窗口句柄:", child_hwnds)
# 设置窗口标题:
import win32gui
hwnd = win32gui.FindWindow(None, "窗口标题")
win32gui.SetWindowText(hwnd, "新的窗口标题")

2、获取窗口并设为活跃窗口

import win32gui
window_name = "窗口标题"

# 通过窗口名称获取窗口句柄
hwnd = win32gui.FindWindow(None, window_name)

if hwnd != 0:
    # 将窗口设为活跃窗口
    win32gui.SetForegroundWindow(hwnd)
    print("窗口已设为活跃")
else:
    print("未找到该窗口")

该代码只会将窗口设为活跃,并不会将其移动到前台。如果窗口已最小化或位于其他桌面,它可能不会立即显示在屏幕上。

你可能感兴趣的:(python大家庭,python,开发语言)