Gets the text of a specific console line.
Private Declare Function CSGetLineText Lib "consoul_010205_32.dll" ( _ ByVal hWnd As Long, _ ByVal wLine As Integer, _ ByVal wBufferCharLen As Integer, _ ByVal lpStringBuffer As Long, _ ByVal wAsVt100 As Integer _ ) As Integer
Private Declare PtrSafe Function CSGetLineText Lib "consoul_010205_64.dll" ( _ ByVal hWnd As LongPtr, _ ByVal wLine As Integer, _ ByVal wBufferCharLen As Integer, _ ByVal lpStringBuffer As LongPtr, _ ByVal wAsVt100 As Integer _ ) As Integer
The return value.
The window handle (HWND) of the Consoul window, as returned by CSCreateLogWindow.
The number of the line (as returned by
CSPushLine) where the specified
pwZoneID should be.
The size in characters (*Consoul" is unicode, one char is 2 bytes) of the receiving memory buffer.
The address of the memory buffer where Consoul will write the line text string, up to
wBufferCharLen characters. No terminating zero is written in the buffer.
If 0 (zero), only the text parts of the line contents are extracted, stripping out the Consoul vt100 escape sequences. If 1 (one) then the full contents, including escapes sequences are written in
Consoul does not memorize the exact strings that are pushed (CSPushLine) or set (CSSetLine) into the window queue. Consoul parses the content that is pushed into an intermediary script. When functions like CSGetZoneText or CSGetLineText are called, Consoul rebuilds the returned content from its internal scripts, thus there may be subtle differences between the original content that was pushed and the content that is returned by these functions.