pywin32 annotations improvements (#11177)

stubs/pywin32/win32/win32api.pyi

@@ -137,7 +137,7 @@ def GetSystemFileCacheSize(): ...
 def SetSystemFileCacheSize(MinimumFileCacheSize, MaximumFileCacheSize, Flags=...) -> None: ...
 def GetSystemInfo(): ...
 def GetNativeSystemInfo(): ...
-def GetSystemMetrics(index): ...
+def GetSystemMetrics(__index: int) -> int: ...
 def GetSystemPowerStatus() -> dict[str, int]: ...
 def GetSystemTime(): ...
 def GetTempFileName(path: str, prefix: str, nUnique): ...

stubs/pywin32/win32/win32gui.pyi

@@ -98,8 +98,18 @@ def CreateIconFromResource(bits: str, fIcon, ver: int = ...) -> int: ...
 def LoadImage(
     __hinst: int, __name: str, __type: int, __cxDesired: int, __cyDesired: int, __fuLoad: int
 ) -> _win32typing.PyGdiHANDLE: ...
-def DeleteObject(handle: _win32typing.PyGdiHANDLE) -> None: ...
-def BitBlt(hdcDest, x, y, width, height, hdcSrc, nXSrc, nYSrc, dwRop) -> None: ...
+def DeleteObject(__handle: int | _win32typing.PyGdiHANDLE) -> None: ...
+def BitBlt(
+    __hdcDest: int | _win32typing.PyGdiHANDLE,
+    __x: int,
+    __y: int,
+    __width: int,
+    __height: int,
+    __hdcSrc: int | _win32typing.PyGdiHANDLE | None,
+    __nXSrc: int,
+    __nYSrc: int,
+    __dwRop: int,
+) -> None: ...
 def StretchBlt(hdcDest, x, y, width, height, hdcSrc, nXSrc, nYSrc, nWidthSrc, nHeightSrc, dwRop) -> None: ...
 def PatBlt(hdc: int, XLeft, YLeft, Width, Height, Rop) -> None: ...
 def SetStretchBltMode(hdc: int, StretchMode): ...
@@ -167,13 +177,17 @@ def GetClientRect(hwnd: int) -> tuple[int, int, int, int]: ...
 def GetDC(hwnd: int): ...
 def SaveDC(hdc: int): ...
 def RestoreDC(hdc: int, SavedDC) -> None: ...
-def DeleteDC(hdc) -> None: ...
-def CreateCompatibleDC(dc): ...
-def CreateCompatibleBitmap(hdc, width, height) -> _win32typing.PyGdiHANDLE: ...
-def CreateBitmap(width, height, cPlanes, cBitsPerPixel, bitmap_bits) -> _win32typing.PyGdiHANDLE: ...
-def SelectObject(hdc, _object): ...
+def DeleteDC(__hdc: int | _win32typing.PyHANDLE) -> None: ...
+def CreateCompatibleDC(__dc: int | _win32typing.PyHANDLE | None) -> int: ...
+def CreateCompatibleBitmap(
+    __hdc: int | _win32typing.PyHANDLE | None, __width: int, __height: int
+) -> _win32typing.PyGdiHANDLE: ...
+def CreateBitmap(
+    __width: int, __height: int, __cPlanes: int, __cBitsPerPixel: int, __bitmap_bits: None
+) -> _win32typing.PyGdiHANDLE: ...
+def SelectObject(__hdc: int | _win32typing.PyHANDLE | None, __object: int | _win32typing.PyHANDLE | None) -> int: ...
 def GetCurrentObject(hdc: int, ObjectType) -> int: ...
-def GetWindowRect(hwnd: int) -> tuple[int, int, int, int]: ...
+def GetWindowRect(__hwnd: int | _win32typing.PyHANDLE) -> tuple[int, int, int, int]: ...
 def GetStockObject(Object) -> int: ...
 def PostQuitMessage(__rc: int) -> None: ...
 def WaitMessage() -> None: ...
@@ -360,18 +374,18 @@ def CreateWindowEx(
     dwExStyle, className: str, windowTitle: str, style, x, y, width, height, parent, menu, hinstance, reserved
 ): ...
 def GetParent(child: int) -> int: ...
-def SetParent(__child: int, __child1: int | None | _win32typing.PyHANDLE) -> int: ...
+def SetParent(__child: int, __child1: int | _win32typing.PyHANDLE | None) -> int: ...
 def GetCursorPos() -> tuple[Incomplete, Incomplete]: ...
 def GetDesktopWindow(): ...
 def GetWindow(__hWnd: int, __uCmd: int) -> int: ...
-def GetWindowDC(hWnd: int) -> int: ...
+def GetWindowDC(__hWnd: int | _win32typing.PyHANDLE | None) -> int: ...
 def IsIconic(__hWnd: int) -> int: ...
 def IsWindow(__hWnd: int) -> int: ...
 def IsChild(__hWndParent: int, hWnd: int) -> int: ...
 def ReleaseCapture() -> None: ...
 def GetCapture(): ...
 def SetCapture() -> None: ...
-def ReleaseDC(hWnd: int, hDC): ...
+def ReleaseDC(__hWnd: int | _win32typing.PyHANDLE | None, __hDC: int | _win32typing.PyHANDLE | None) -> Literal[0, 1]: ...
 def CreateCaret(hWnd: int, hBitmap: _win32typing.PyGdiHANDLE, nWidth, nHeight) -> None: ...
 def DestroyCaret() -> None: ...
 def ScrollWindowEx(

stubs/pywin32/win32/win32print.pyi

@@ -14,7 +14,9 @@ def GetDefaultPrinter() -> str: ...
 def GetDefaultPrinterW() -> str: ...
 def SetDefaultPrinter(printer: str): ...
 def SetDefaultPrinterW(Printer: str): ...
-def StartDocPrinter(__hprinter: _win32typing.PyPrinterHANDLE | int, __level: Literal[1], __tuple: tuple[str, str, str]): ...
+def StartDocPrinter(
+    __hprinter: _win32typing.PyPrinterHANDLE | int, __level: Literal[1], __tuple: tuple[str, str, str | None]
+) -> int: ...
 def EndDocPrinter(hPrinter: _win32typing.PyPrinterHANDLE): ...
 def AbortPrinter(hPrinter: _win32typing.PyPrinterHANDLE) -> None: ...
 def StartPagePrinter(hprinter: _win32typing.PyPrinterHANDLE) -> None: ...
@@ -24,7 +26,7 @@ def EndDoc(hdc: int) -> None: ...
 def AbortDoc(hdc: int) -> None: ...
 def StartPage(hdc: int) -> None: ...
 def EndPage(hdc: int) -> None: ...
-def WritePrinter(hprinter: _win32typing.PyPrinterHANDLE, buf: str): ...
+def WritePrinter(__hprinter: int | _win32typing.PyPrinterHANDLE, __buf: bytes | bytearray | memoryview) -> int: ...
 def EnumJobs(hPrinter: _win32typing.PyPrinterHANDLE, FirstJob, NoJobs, Level=...): ...
 def GetJob(hPrinter: _win32typing.PyPrinterHANDLE, JobID, Level: int = ...): ...
 def SetJob(hPrinter: _win32typing.PyPrinterHANDLE, JobID, Level, JobInfo, Command): ...