WebView2 headers collection pages state 997's enumerator and its four derived classes; FAQ: VBP import carries the startup object, icon form and the console flag

Author: KubaO

docs/Miscellaneous/FAQs.md

@@ -248,6 +248,8 @@ You can import individual files, from VB projects or any type, through the Impor
 > You can select .bas/.cls files individually, but to import Forms, UserControls, Property Pages, and Resource Files you must currently select the .vbp file they're associated with. You'll then be shown a list of files you can import (with their new twinBASIC extensions .tbform/.twin etc-- make sure to import both, e.g. for Form1.frm you'll see Form1.frm.tbform and Form1.frm.twin:
 
 ![The Import from twinproj dialog: a tick-box tree of everything found in RunAsTI.vbp, with the Resources branch expanded over its ICON and MANIFEST folders and a Sources branch below. Form1.frm.tbform and Form1.frm.twin are both ticked.](Images/16833fae-4bd7-418f-bb16-691a611a5b01.png){:style="width:50%; height:auto;"}
+
+Importing a .vbp also carries over its [startup object](tB/IDE/Project/Settings#startup-object) and its [icon form](tB/IDE/Project/Settings#icon-form). A VB6 project that was linked as a console program --- its `LinkSwitches` line contains `/SUBSYSTEM:CONSOLE`, written in capitals --- becomes a [console application](tB/IDE/Project/Settings#is-console-application). No other linker switch is carried over.
 </details>
 
 <details>

docs/Reference/Built-In/WebView2/WebView2HeadersCollection.md

@@ -10,7 +10,9 @@ has_toc: false
 
 An enumerator that yields [**WebView2Header**](WebView2Header) values one by one. Returned by **WebView2RequestHeaders.GetHeaders**, **WebView2ResponseHeaders.GetHeaders**, and by `For Each` over a [**WebView2RequestHeaders**](WebView2RequestHeaders) or [**WebView2ResponseHeaders**](WebView2ResponseHeaders) instance.
 
-The collection is forward-only: once iterated it is exhausted. It does not implement **Reset**, **Skip**, or **Clone**, and calling those raises run-time error 80004001 (*Not implemented*).
+The collection implements the COM enumerator operations **Next**, **Skip**, **Reset** and **Clone**, which `For Each` and other COM enumerator clients call. They are not members that BASIC code can call. A loop reads the headers once, front to back; **Reset** starts the enumeration again from the first header. Every call to **GetHeaders** and every `For Each` loop produces a new enumerator, so a new loop always starts at the first header.
+
+A **WebView2HeadersCollection** is never created by application code. The package returns one of the four derived classes listed under [Derived classes](#derived-classes), typed as **WebView2HeadersCollection**.
 
 ```tb check_build
 Private Sub WebView21_NavigationStarting( _
@@ -27,14 +29,20 @@ Private Sub WebView21_NavigationStarting( _
 End Sub
 ```
 
+## Derived classes
+
+Four public classes inherit from **WebView2HeadersCollection**. Each is `[COMCreatable(False)]`, and application code does not create them: the package creates them and returns them as **WebView2HeadersCollection**. Each overrides **Reset** and **Clone** to work on its own source of headers.
+
+| Class | Returned by | Yields |
+|-------|-------------|--------|
+| **WebView2HeadersCollection_RequestGetHeaders** | [**WebView2RequestHeaders.GetHeaders**](WebView2RequestHeaders#getheaders) | the request headers whose name matches the *name* argument |
+| **WebView2HeadersCollection_RequestEnumerator** | `For Each` over a [**WebView2RequestHeaders**](WebView2RequestHeaders) | every request header |
+| **WebView2HeadersCollection_ResponseGetHeaders** | [**WebView2ResponseHeaders.GetHeaders**](WebView2ResponseHeaders#getheaders) | the response headers whose name matches the *name* argument |
+| **WebView2HeadersCollection_ResponseEnumerator** | `For Each` over a [**WebView2ResponseHeaders**](WebView2ResponseHeaders) | every response header |
+
 ## Methods
 
 ### New
 {: .no_toc }
 
-Constructs the collection. Created internally by the package; application code does not normally invoke this.
-
-Syntax: **New WebView2HeadersCollection** ( *Iterator* )
-
-*Iterator*
-: *required* An internal iterator handed in by the runtime.
+Constructs the collection from the runtime's header iterator. The constructor is **Protected**: only the four derived classes call it, and application code cannot create a **WebView2HeadersCollection**.

docs/Reference/Built-In/WebView2/WebView2RequestHeaders.md

@@ -67,7 +67,7 @@ Syntax: *object*.**GetHeader** ( *name* ) **As String**
 ### GetHeaders
 {: .no_toc }
 
-Returns a [**WebView2HeadersCollection**](WebView2HeadersCollection) iterator restricted to the headers that match *name* --- useful for headers that may have multiple values.
+Returns a [**WebView2HeadersCollection**](WebView2HeadersCollection) enumerator restricted to the headers that match *name* --- useful for headers that may have multiple values. Each call returns a new enumerator that starts at the first matching header.
 
 Syntax: *object*.**GetHeaders** ( *name* ) **As WebView2HeadersCollection**
 
@@ -103,4 +103,4 @@ Private Sub WebView21_NavigationStarting( _
 End Sub
 ```
 
-The enumerator is forward-only and cannot be reset. See [**WebView2HeadersCollection**](WebView2HeadersCollection) for the iteration object.
+Each `For Each` loop starts at the first header. See [**WebView2HeadersCollection**](WebView2HeadersCollection) for the iteration object.

docs/Reference/Built-In/WebView2/WebView2ResponseHeaders.md

@@ -62,7 +62,7 @@ Syntax: *object*.**GetHeader** ( *name* ) **As String**
 ### GetHeaders
 {: .no_toc }
 
-Returns a [**WebView2HeadersCollection**](WebView2HeadersCollection) iterator restricted to the headers that match *name*.
+Returns a [**WebView2HeadersCollection**](WebView2HeadersCollection) enumerator restricted to the headers that match *name*. Each call returns a new enumerator that starts at the first matching header.
 
 Syntax: *object*.**GetHeaders** ( *name* ) **As WebView2HeadersCollection**
 
@@ -85,4 +85,4 @@ Private Sub WebView21_WebResourceRequested( _
 End Sub
 ```
 
-See [**WebView2HeadersCollection**](WebView2HeadersCollection) for the iteration object.
+Each `For Each` loop starts at the first header. See [**WebView2HeadersCollection**](WebView2HeadersCollection) for the iteration object.

docs/Reference/Built-In/WebView2/index.md

@@ -19,7 +19,7 @@ Beyond the control itself, the package exposes a small set of wrapper objects th
 - [WebView2](WebView2/) -- the control: navigation, scripting, settings, deferral-aware events, and PDF / suspend / download / task-manager features controlled by the underlying Edge runtime
 - [WebView2EnvironmentOptions](WebView2/EnvironmentOptions) -- pre-creation configuration for the WebView2 environment (user-data folder, executable folder, locale, tracking-prevention, …); reached via the control's **EnvironmentOptions** property
 - [WebView2Header](WebView2Header) -- one HTTP header (Name / Value); the element type yielded by header iteration
-- [WebView2HeadersCollection](WebView2HeadersCollection) -- enumerable wrapper used by `For Each` over request / response headers
+- [WebView2HeadersCollection](WebView2HeadersCollection) -- enumerator returned by **GetHeaders** and used by `For Each` over request / response headers; also describes its four derived classes
 - [WebView2Request](WebView2Request) -- the request side of a **WebResourceRequested** event -- **Method**, **Uri**, **Headers**, and the request body as bytes or UTF-8 text
 - [WebView2RequestHeaders](WebView2RequestHeaders) -- mutable request-header collection passed to **NavigationStarting** and reached via **WebView2Request.Headers**
 - [WebView2Response](WebView2Response) -- the response side of a **WebResourceRequested** event -- **StatusCode**, **ReasonPhrase**, **Headers**, and the body as bytes or UTF-8 text