v2.0.0-beta.3

Author: ioa747

NetWebView2Lib.au3

@@ -63,45 +63,51 @@ This project is provided "as-is". You are free to use, modify, and distribute it
   <img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%">
 </p>
 
-## 🚀 What's New in v2.0.0-beta.1 - Multi-Instance & Stability Focus
+## 🚀 What's New in v2.0.0-beta.3 - AcceleratorKey Detail & Refactoring
 
-This major beta release re-engineers the core event architecture to support professional multi-instance applications and solves long-standing COM deadlock issues with pre-emptive key blocking.
+This update focuses on deep keyboard interception and code modularity.
 
 ### ⚡ Key Features & Enhancements
 
-#### **1. Sender-Aware Event Architecture**
+#### **1. PhysicalKeyStatus Expansion**
+The `OnAcceleratorKeyPressed` event now provides 1:1 access to the underlying Windows keyboard state.
+- **New Properties**: `RepeatCount`, `ScanCode`, `IsExtendedKey`, `IsMenuKeyDown`, `WasKeyDown`, and `IsKeyReleased`.
+- **Use Case**: Detect held keys, distinguish between left/right Alt/Ctrl, and implement complex hotkey logic without Win32 API calls.
 
-The entire event system has been refactored for multi-instance reliability. Every event fired from the C# core now provides a "Sender" context.
+#### **2. Performance & Modularity**
+- **Standalone Argument Logic**: Argument wrappers have been moved to dedicated files (e.g., `WebView2AcceleratorKeyPressedEventArgs.cs`).
+- **Lean Core**: Reduced `WebViewManager.cs` complexity by outsourcing event data structures.
 
-- **Instance Isolation**: AutoIt scripts can now easily distinguish which WebView2 instance triggered an event using the `parentHandle` parameter.
-- **Sealed Contexts**: The communication bridge is now sealed to its parent manager, preventing message cross-talk in complex multi-window setups.
-
-#### **2. Pre-emptive Key Blocking (Zero Deadlocks)**
+---
 
-We have abandoned the legacy synchronous polling for accelerator keys in favor of a proactive, list-based approach.
+## 🚀 What's New in v2.0.0-beta.2 - COM Versioning & Handle Alignment
 
-- **`BlockedVirtualKeys`**: Define a list of VK codes (like F5, F12) to be blocked directly by the C# engine.
-- **Performance**: Eliminates the 600ms sync-wait loops, resulting in instant response times and 0% risk of COM re-entrancy deadlocks.
-- **OnAcceleratorKeyPressed**: Still available for monitoring, but the "Handled" logic is now pre-emptively managed by the property list.
+This update introduces the ability to query the DLL version directly and aligns window handles with AutoIt's native format.
 
-#### **3. Native Win32 Integration**
+### ⚡ Key Features & Enhancements
 
-- **`BrowserWindowHandle`**: A new property that exposes the internal `HWND` of the browser control. This allows for advanced parent-child window relationship management and direct Win32 message interception via DLL calls.
+#### **1. Advanced Handle Formatting (`[HANDLE:0x...]`)**
+All window handles returned by the library (via properties or events) are now formatted as strings compatible with AutoIt's Advanced Window Descriptions.
+- **Direct Compatibility**: Handles like `[HANDLE:0x00010203]` can be passed directly to `WinExists`, `WinSetTitle`, etc., without `HWnd()` conversion.
 
-#### **4. Internal Messaging Overlay**
+#### **2. COM Version Exposure**
+You can now access the `.version` property on all primary COM objects.
+- **`Manager.version`**, **`Bridge.version`**, **`Parser.version`**.
 
-- **Improved Stability**: A new internal messaging system ensures that background state updates never interfere with the primary UI event loop, ensuring a smoother user experience during heavy navigation sequences.
+#### **3. Stabilized Infrastructure**
+- **GUID Collision Resolution**: Fixed internal interface IDs that caused registration issues in v2.0.0-beta.1.
+- **`ParentWindowHandle`**: New property to retrieve the handle passed during initialization.
 
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%">
 </p>
 
-## 📖 NetWebView2Lib Version 2.0.0-beta.1 (Quick Reference)
+## 📖 NetWebView2Lib Version 2.0.0-beta.3 (Quick Reference)
 
 ### NetWebView2Lib (ProgId: NetWebView2.Manager)
 
-#### === Properties ===
+#### ===Properties===
 
 ##### AreDevToolsEnabled
 Determines whether the user is able to use the context menu or keyboard shortcuts to open the DevTools window.
@@ -188,14 +194,18 @@ Control visibility of the browser's default error pages (e.g., connection lost).
 `object.IsBuiltInErrorPageEnabled = Value`
 
 ##### BrowserWindowHandle
-Returns the internal window handle (HWND) of the WebView2 control. This is the child window attached to the parent GUI.
+Returns the internal window handle (HWND) of the WebView2 control. [Format: `[HANDLE:0x...]`]
 `object.BrowserWindowHandle`
 
+##### ParentWindowHandle
+Returns the parent window handle provided during initialization. [Format: `[HANDLE:0x...]`]
+`object.ParentWindowHandle`
+
 ##### BlockedVirtualKeys
 A comma-separated list of Virtual Key codes to be blocked synchronously (e.g., "116,123").
 `object.BlockedVirtualKeys = "116,123"`
 
-#### === Method ===
+#### ===Method===
 
 ##### Initialize
 Initializes the WebView2 control within a parent window.
@@ -354,6 +364,7 @@ Enables or disables the Web Message communication system.
 ##### SetStatusBarEnabled
 Enables or disables the browser status bar.
 `object.SetStatusBarEnabled(Enabled As Boolean)`
+
 
 ##### CapturePreview
 Captures a screenshot of the current view to a file.
@@ -489,7 +500,7 @@ Captures page data using Chrome DevTools Protocol. Can return MHTML or other CDP
 `object.CaptureSnapshot(CdpParameters As String)`
 
 ##### SetDownloadPath
-Sets a global default folder or file path for all browser downloads. If a directory is provided, the filename is automatically appended by the library.
+Sets a global default folder or file path for all browser downloads. If a directory is provided, the filename is automatically appended by the library. Create the folder if it doesn't exist
 `object.SetDownloadPath(Path As String)`
 
 ##### CancelDownloads
@@ -504,7 +515,7 @@ Cancels active downloads. If `uri` is empty or omitted, cancels all active downl
 Captures the current page as a PDF and returns the content as a Base64-encoded string.
 `object.PrintToPdfStream()`
 
-#### === Events ===
+#### ===Events===
 
 ##### OnMessageReceived
 Fired when a message or notification is sent from the library to AutoIt.
@@ -564,14 +575,21 @@ Fired when an accelerator key is pressed. Allows blocking browser shortcuts.
 	*Args properties: 
 		VirtualKey (uint): The VK code of the key.
 		KeyEventKind (int): Type of key event (Down, Up, etc.).
-		Handled (bool): Set to `True` to stop the browser from processing the key.*
-  
+		Handled (bool): Set to `True` to stop the browser from processing the key.
+		RepeatCount (uint): The number of times the key has repeated.
+		ScanCode (uint): Hardware scan code.
+		IsExtendedKey (bool): True if it's an extended key (e.g., right Alt).
+		IsMenuKeyDown (bool): True if Alt is pressed.
+		WasKeyDown (bool): True if the key was already down.
+		IsKeyReleased (bool): True if the event is a key up.
+		KeyEventLParam  (int):  Gets the LPARAM value that accompanied the window message*
+
 
 ---
 
 ### JsonParser (ProgId: NetJson.Parser)
 
-#### === Methods ===
+#### ===Methods===
 
 ##### Parse
 Parses a JSON string. Automatically detects if it's an Object or an Array.

README.md

@@ -33,6 +33,8 @@ Func Main()
 
 	Local $sProfileDirectory = @ScriptDir & "\NetWebView2Lib-UserDataFolder"
 	_NetWebView2_Initialize($oWebV2M, $hGUI, $sProfileDirectory, 0, 0, 0, 0, True, True, True, 1.2, "0x2B2B2B")
+	If @error Then Return SetError(@error, @extended, $oWebV2M)
+
 	__Example_Log(@ScriptLineNumber, "After: _NetWebView2_Initialize()")
 
 	; navigate to HTML string - full fill the object with your own offline content - without downloading any content

bin/NetWebView2Lib.dll

@@ -1,7 +1,7 @@
 #AutoIt3Wrapper_UseX64=y
 #include <GUIConstantsEx.au3>
 #include <WindowsConstants.au3>
-
+#include <Misc.au3>
 #include "..\NetWebView2Lib.au3"
 
 ; 006-DownloadDemo.au3
@@ -35,15 +35,20 @@ Func _Example()
 
 	#EndRegion ; GUI CREATION
 
+	; BlockedVirtualKeys
+	;	A comma-separated list of Virtual Key codes to be blocked synchronously (e.g., "116,123").
+	;	`object.BlockedVirtualKeys = "116,123"`
+
+	; Block F5 (116) and F12 (123) AcceleratorKey!
+	$oWebV2M.BlockedVirtualKeys = "116,123"
+
 	; Silent Download Setting
 	$oWebV2M.IsDownloadUIEnabled = False
-	; Set default Download Path
-	DirCreate(@ScriptDir & "\Downloads_Test")
+
+	; Set default Download Path (Create the folder if it doesn't exist)
 	$oWebV2M.SetDownloadPath(@ScriptDir & "\Downloads_Test")
 
 	; navigate to the page
-;~ 	_NetWebView2_Navigate($oWebV2M, "https://www.libreoffice.org/download/download-libreoffice", $NETWEBVIEW2_MESSAGE__TITLE_CHANGED)
-
 	_NetWebView2_Navigate($oWebV2M, "https://www.libreoffice.org/donate/dl/win-x86_64/25.8.4/en-US/LibreOffice_25.8.4_Win_x86-64.msi", $NETWEBVIEW2_MESSAGE__NAV_STARTING)
 
 	#Region ; GUI Loop
@@ -61,7 +66,8 @@ Func _Example()
 	_NetWebView2_CleanUp($oWebV2M, $oJSBridge)
 EndFunc   ;==>_Example
 
-Func __UserEventHandler__OnDownloadStateChanged($oWebV2M, $hGUI, $sState, $sURL, $iTotal_Bytes, $iReceived_Bytes)
+; Advise using 'Volatile' for Event Handlers to ensure the WebView2 COM thread can interrupt the main script safely.
+Volatile Func __UserEventHandler__OnDownloadStateChanged($oWebV2M, $hGUI, $sState, $sURL, $iTotal_Bytes, $iReceived_Bytes)
 	#forceref $oWebV2M
 
 	$hGUI = HWnd("0x" & Hex($hGUI, 16))
@@ -99,21 +105,108 @@ Func __UserEventHandler__OnDownloadStateChanged($oWebV2M, $hGUI, $sState, $sURL,
 	EndSwitch
 EndFunc   ;==>__UserEventHandler__OnDownloadStateChanged
 
-Func __UserEventHandler__OnAcceleratorKeyPressed($oWebV2M, $hGUI, $oArgs)
-	$hGUI = HWnd("0x" & Hex($hGUI, 16))
-	Local Const $sArgsList = '[Handled=' & $oArgs.Handled & '; KeyEventKind=' & $oArgs.KeyEventKind & '; KeyEventLParam=' & $oArgs.KeyEventLParam & '; VirtualKey=' & $oArgs.VirtualKey & ']'
-	Local Const $s_Prefix = "[USER:EVENT: OnAcceleratorKeyPressed]: GUI:" & $hGUI & " ARGS: " & ((IsObj($oArgs)) ? ($sArgsList) : ('ERRROR'))
+; Advise using 'Volatile' for Event Handlers to ensure the WebView2 COM thread can interrupt the main script safely.
+Volatile Func __UserEventHandler__OnAcceleratorKeyPressed($oWebV2M, $hGUI, $oArgs)
+    Local Const $sArgsList = '[VirtualKey=' & $oArgs.VirtualKey & _ ; The VK code of the key.
+            '; KeyEventKind=' & $oArgs.KeyEventKind & _             ; Type of key event (Down, Up, etc.).
+            '; Handled=' & $oArgs.Handled & _                       ; Set to `True` to stop the browser from processing the key.
+            '; RepeatCount=' & $oArgs.RepeatCount & _               ; The number of times the key has repeated.
+            '; ScanCode=' & $oArgs.ScanCode & _                     ; Hardware scan code.
+            '; IsExtendedKey=' & $oArgs.IsExtendedKey & _           ; True if it's an extended key (e.g., right Alt).
+            '; IsMenuKeyDown=' & $oArgs.IsMenuKeyDown & _           ; True if Alt is pressed.
+            '; WasKeyDown=' & $oArgs.WasKeyDown & _                 ; True if the key was already down.
+            '; IsKeyReleased=' & $oArgs.IsKeyReleased & _           ; True if the event is a key up.
+            '; KeyEventLParam=' & $oArgs.KeyEventLParam & ']'       ; Gets the LPARAM value that accompanied the window message.
+
+    Local Const $s_Prefix = "[USER:EVENT: OnAcceleratorKeyPressed]:: GUI:" & $hGUI & " ARGS: " & ((IsObj($oArgs)) ? ($sArgsList) : ('ERROR'))
+
+    ; Example of checking specific keys
+    Switch $oArgs.VirtualKey
+        Case Int($VK_F7)
+            ConsoleWrite("! Blocked: F7 caret browsing." & @CRLF)
+            $oArgs.Handled = True
+
+        Case Int($VK_N)
+            ; Check if Ctrl is pressed (using _IsPressed for Ctrl as IsMenuKeyDown specifically targets Alt)
+            ; Use this to block shortcuts like Ctrl+N (New Window)
+            If _IsPressed("11") Then
+                ConsoleWrite("! Blocked: Ctrl+N shortcut." & @CRLF)
+                $oArgs.Handled = True
+            EndIf
+
+        Case Int($VK_ESCAPE) ; ESC 27 1b 033 Escape
+            ; Cancels active downloads. If `uri` is empty or omitted, cancels all active downloads.
+            $oWebV2M.CancelDownloads()
+
+    EndSwitch
+
+    __NetWebView2_Log(@ScriptLineNumber, $s_Prefix, 0)
+
+    $oArgs = 0 ; Explicitly release the COM reference inside the volatile scope
+EndFunc   ;==>__UserEventHandler__OnAcceleratorKeyPressed
+
+; Advise using 'Volatile' for Event Handlers to ensure the WebView2 COM thread can interrupt the main script safely.
+Volatile Func __UserEventHandler__OnAcceleratorKeyPressed00($oWebV2M, $hGUI, $oArgs)
+	Local Const $sArgsList = '[VirtualKey=' & $oArgs.VirtualKey & _ ; The VK code of the key.
+			'; KeyEventKind=' & $oArgs.KeyEventKind & _             ; Type of key event (Down, Up, etc.).
+			'; Handled=' & $oArgs.Handled & _                       ; Set to `True` to stop the browser from processing the key.
+			'; RepeatCount=' & $oArgs.RepeatCount & _               ; The number of times the key has repeated.
+			'; ScanCode=' & $oArgs.ScanCode & _                     ; Hardware scan code.
+			'; IsExtendedKey=' & $oArgs.IsExtendedKey & _           ; True if it's an extended key (e.g., right Alt).
+			'; IsMenuKeyDown=' & $oArgs.IsMenuKeyDown & _           ; True if Alt is pressed.
+			'; WasKeyDown=' & $oArgs.WasKeyDown & _                 ; True if the key was already down.
+			'; IsKeyReleased=' & $oArgs.IsKeyReleased & _           ; True if the event is a key up.
+			'; KeyEventLParam=' & $oArgs.KeyEventLParam & ']'       ; Gets the LPARAM value that accompanied the window message.
+
+
+	Local Const $s_Prefix = "[USER:EVENT: OnAcceleratorKeyPressed]:: GUI:" & $hGUI & " ARGS: " & ((IsObj($oArgs)) ? ($sArgsList) : ('ERRROR'))
+
+;~  public uint VirtualKey { get; }
+;~  public int KeyEventLParam { get; }
+;~  public int KeyEventKind { get; }
+;~
+;~  public uint RepeatCount { get; }
+;~  public uint ScanCode { get; }
+;~  public bool IsExtendedKey { get; }
+;~  public bool IsMenuKeyDown { get; }
+;~  public bool WasKeyDown { get; }
+;~  public bool IsKeyReleased { get; }
 
 ;~ 	https://learn.microsoft.com/en-us/dotnet/api/microsoft.web.webview2.core.corewebview2acceleratorkeypressedeventargs?view=webview2-dotnet-1.0.705.50
-	ConsoleWrite($oArgs.Handled & @CRLF) ; Indicates whether the AcceleratorKeyPressed event is handled by host.
-	ConsoleWrite($oArgs.KeyEventKind & @CRLF) ; Gets the key event kind that caused the event to run
-	ConsoleWrite($oArgs.KeyEventLParam & @CRLF) ; Gets the LPARAM value that accompanied the window message.
+;~ 	ConsoleWrite($oArgs.Handled & @CRLF) ; Indicates whether the AcceleratorKeyPressed event is handled by host.
+;~ 	ConsoleWrite($oArgs.KeyEventKind & @CRLF) ; Gets the key event kind that caused the event to run
+;~ 	ConsoleWrite($oArgs.KeyEventLParam & @CRLF) ; Gets the LPARAM value that accompanied the window message.
 ;~ 	ConsoleWrite('>> PhysicalKeyStatus=' & $oArgs.PhysicalKeyStatus & @CRLF) ; Gets a CoreWebView2PhysicalKeyStatus representing the information passed in the LPARAM of the window message. ==> ; https://learn.microsoft.com/en-us/dotnet/api/microsoft.web.webview2.core.corewebview2physicalkeystatus?view=webview2-dotnet-1.0.705.50
-	ConsoleWrite($oArgs.VirtualKey & @CRLF) ; Gets the Win32 virtual key code of the key that was pressed or released.
+;~ 	ConsoleWrite($oArgs.VirtualKey & @CRLF) ; Gets the Win32 virtual key code of the key that was pressed or released.
+
+;~ 	If $oArgs.VirtualKey = 27 Then ; ESC 27 1b 033 Escape, next character is not echoed ; https://www.autoitscript.com/autoit3/docs/appendix/ascii.htm
+;~ 		$oWebV2M.CancelDownloads($_sURLDownload_InProgress)
+;~ 	EndIf
 
-	If $oArgs.VirtualKey = 27 Then ; ESC 27 1b 033 Escape, next character is not echoed ; https://www.autoitscript.com/autoit3/docs/appendix/ascii.htm
-		$oWebV2M.CancelDownloads($_sURLDownload_InProgress)
-	EndIf
+	; Example of checking specific keys
+    Switch $oArgs.VirtualKey
+        Case Int($VK_F7)
+            ConsoleWrite("! Blocked: F7 caret browsing." & @CRLF)
+            $oArgs.Handled = True
+
+        Case Int($VK_N)
+            ; Έλεγχος αν είναι πατημένο το Ctrl (χρησιμοποιώντας το IsMenuKeyDown αν αφορά Alt ή WinAPI για Ctrl)
+            ; Αν θέλουμε να μπλοκάρουμε το Ctrl+N (New Window)
+            If _IsPressed("11") Then ; Χρειάζεται το Misc.au3 για την _IsPressed
+                ConsoleWrite("! Blocked: Ctrl+N shortcut." & @CRLF)
+                $oArgs.Handled = True
+
+			EndIf
+
+		Case Int($VK_ESCAPE) ; ESC 27 1b 033 Escape, next character is not echoed ; https://www.autoitscript.com/autoit3/docs/appendix/ascii.htm
+			; Cancels active downloads. If `uri` is empty or omitted, cancels all active downloads.
+			$oWebV2M.CancelDownloads()
+
+    EndSwitch
+
+	__NetWebView2_Log(@ScriptLineNumber, $s_Prefix, 0)
+	$oArgs = 0 ; Explicitly release the COM reference inside the volatile scopeEndFunc
 
-	__NetWebView2_Log(@ScriptLineNumber, (StringLen($s_Prefix) > 150 ? StringLeft($s_Prefix, 150) & "..." : $s_Prefix), 1)
 EndFunc   ;==>__UserEventHandler__OnAcceleratorKeyPressed
+
+

bin/NetWebView2Lib.tlb

@@ -1,6 +1,8 @@
+;~ #AutoIt3Wrapper_UseX64=y
 #include <GUIConstantsEx.au3>
 #include <WindowsConstants.au3>
 #include "..\NetWebView2Lib.au3"
+#include <WinAPISysWin.au3>
 
 ; Global objects
 Global $oMyError = ObjEvent("AutoIt.Error", "_ErrFunc") ; COM Error Handler
@@ -9,6 +11,7 @@ _Example_HTTP_Tracking()
 
 Func _Example_HTTP_Tracking()
 	Local $hGUI = GUICreate("WebView2 HTTP Status Tracker", 1000, 600)
+	ConsoleWrite("$hGUI=" & $hGUI & @CRLF)
 
 	; Initialize WebView2 Manager and register events
 	Local $oWebV2M = _NetWebView2_CreateManager("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0 Safari/537.36 Edg/144.0.0.0", "WebEvents_")
@@ -49,6 +52,21 @@ EndFunc   ;==>_Example_HTTP_Tracking
 #Region ; === EVENT HANDLERS ===
 ; Handles native WebView2 events
 Func WebEvents_OnMessageReceived($oWebV2M, $hGUI, $sMsg)
+
+	; { part of the $hGUI handle explanation
+	; with the new Advanced Handle Formatting logic [HANDLE:0x...]
+	ConsoleWrite("$hGUI=" & $hGUI & @CRLF)
+	ConsoleWrite("WinExists=" & WinExists($hGUI) & @CRLF)
+	ConsoleWrite("WinGetTitle=" & WinGetTitle($hGUI) & @CRLF)
+	ConsoleWrite("! _WinAPI_GetClientWidth($hGUI)=" & _WinAPI_GetClientWidth($hGUI) & @CRLF) ; not working
+
+	Local $hWnd = WinGetHandle($hGUI)
+	ConsoleWrite("$hWnd=" & $hWnd & @CRLF)
+	ConsoleWrite("WinExists($hWnd)=" & WinExists($hWnd) & @CRLF)
+	ConsoleWrite("- _WinAPI_GetClientWidth($hWnd)=" & _WinAPI_GetClientWidth($hWnd) & @CRLF) ; working
+	; End part of the $hGUI handle explanation }
+
+
 	ConsoleWrite(">>> [WebEvents]: " & (StringLen($sMsg) > 150 ? StringLeft($sMsg, 150) & "..." : $sMsg) & @CRLF)
 	Local $iSplitPos = StringInStr($sMsg, "|")
 	Local $sCommand = $iSplitPos ? StringStripWS(StringLeft($sMsg, $iSplitPos - 1), 3) : $sMsg