Clarion Unicode – beta refresh (15290)

Clarion · Unicode Preview · Beta Refresh

Refresh build 15290 — applications, the IDE and the utilities sharp on scaled displays, and a SQL application that stays open while the server is away

Rebuild, and your application is DPI-aware: on a display at 125%, 150% or more its windows are laid out at the real resolution with crisp text, and its icons grow with the window. The IDE and the utilities are DPI-aware as well. A generated SQL application meets a server that is away with one “Connection lost” box, Retry and Close, and carries on when the server is back. START takes a procedure with USTRING parameters, FILEDIALOG returns any file name into a USTRING, SYSTEM{PROP:HelpFile} is new, ClarionCL gained plain answers for unattended runs, a BIGFILE file is safe from the TOPSPEED driver, and a TXA follows your edits more closely. Already testing? Everything below is new since build 14556.

Scaled displays DPI-aware applications · the gdiScaling prompt · icons that grow · a sharp IDE and utilities SQL the “Connection lost” box · reconnect after an outage · a Filtered locator answered by the server Language START with USTRING parameters · FILEDIALOG · PROP:HelpFile · the Dates and Times help page ClarionCL /win by default · /au with /dx · /stoponerror on imports · ClarionCL-LAA.exe TopSpeed a BIGFILE file safe from the TOPSPEED driver Reports, projects, TXA a previewed report at its exact paper position · one .lib per DLL · a TXA that follows your edits

First the two changes every Clarion developer meets — sharp applications on scaled displays and the SQL application that rides out a server outage — then the IDE, the language, ClarionCL and the fixes of this drop, then the full tester guide, whose “What’s new” section lists everything that changed since you last read it.

◎

For every developer: your applications are sharp on scaled displays

With “Set dpiAware to true?” checked in Global Properties › App Settings › Application Manifest (the default), or with “Include Default Application Manifest”, a rebuilt application is DPI-aware: on a display scaled to 125%, 150% or more, Windows lays its windows out at the real resolution and draws text and controls crisp. Icons grow with the window: the icon of a BUTTON, CHECK, RADIO, sized IMAGE, LIST or menu item is drawn larger by the display scale as far as its control has room, and an .ico that carries larger images (48, 64, 256) gives the sharpest result. For a laptop at 150% docked to a monitor at 100% there is a new check box, “Set gdiScaling to true?”: the application lays out for 100% and Windows draws its text and lines at the resolution of the display the window is on, sharp on every display and when a window moves between them. Rebuild to get it and look at your windows once on a scaled display; to keep the previous look, where Windows enlarges the finished window, uncheck the dpiAware prompt. The help’s Manifest Support topic describes both prompts. From a beta report.

Global Properties, App Settings, Application Manifest: the check boxes Set dpiAware to true? (checked) and Set gdiScaling to true?
Global Properties › App Settings › Application Manifest: the two prompts.
⇄

For every SQL application: the server is away, the window stays open

In a generated application, ABC and Clarion chains, a browse read, a form’s insert, change or delete, or a procedure that opens its tables while the SQL server cannot be reached shows one message, “The connection to the server was lost.” with the driver’s text, and two buttons. Retry connects again and repeats the operation. Close closes the message only: the browse keeps the rows it shows, the form keeps what was typed, and OK saves once the server is back. A program that keeps working through an outage reconnects at the next operation, nothing to reopen and no restart. A lost connection has one error code on every ODBC driver, 08S01, each reconnect attempt returns after about 5 seconds, and FILEERROR() returns the driver’s whole message, up to 2047 characters. The words are in ABERROR.TRN (Msg:ConnectionLost) and the Clarion chain’s StandardWarning; BrowseClass.TakeConnectionLost is a virtual method. F1: “How do I keep the application running when the server connection drops?”. From a beta report.

▣

IDE and utilities: sharp on scaled displays too

Clarion.exe and ClarionLAA.exe are DPI-aware: the editors, designers, dialogs, the Start Page and the Application Tree are laid out at the real resolution with crisp text, and the toolbars follow the display scale. So are TopScan, TPSFix, LibMaker, the debugger and the Application Broker Service Manager. The Start Page font size under Tools › Options is a point size now: 17 means 17 points. Tell us about any window that looks too small or cut off on your display.

U

Language: START with USTRING parameters, FILEDIALOG, PROP:HelpFile

START(StringView, 25000, Title, Caption, Value) with StringView PROCEDURE(USTRING, USTRING, USTRING) compiles, and the new thread receives the Unicode text intact; STRING and USTRING parameters mix. FILEDIALOG hands back any file name, in any script, into a USTRING variable, whether it holds a starting name or is empty. SYSTEM{PROP:HelpFile} reads and sets the active help file, so a class or template with a help file of its own can save the application’s, show its topic and put it back. And the help has one page for everything about dates and times: type Dates and Times in the Index. From beta reports and requests.

>_

ClarionCL: plain answers for unattended runs, and ClarionCL-LAA.exe with 4 GB

/win is the default, so ClarionCL /ag myapp.app runs as it is. /au works with /dx, and an older dictionary without it gets error DCTE005 naming the two ways to upgrade. /stoponerror ends an /ai or /aim at the first error with nothing written; /ag on a missing application is one GENE100 line; a redirection file with a line that cannot be read is an error CLCE012 line; and the generation summary names the applications that had errors. An application imported from a TXA hands its procedures to the templates in the same order at every import. ClarionCL-LAA.exe is the same tool with a 4 GB address space, for very large applications. From beta reports.

?

SQL: a Filtered locator is answered by the server

The text typed into a Filtered locator on a SQL table goes to the server as a LIKE, so only the matching rows travel, whatever the size of the table, in both template chains and with no change to your application. The server’s case rules decide the match; on a case-sensitive server set PROP:ServerCaseInsensitive to 0 on the file and a case-blind key’s locator is sent with the upper-case function. From a beta report.

◆

TopSpeed: a BIGFILE file is safe from the TOPSPEED driver

A program that opens a BIGFILE (TopSpeedW) file with DRIVER('TOPSPEED') gets error 47, “newer TopSpeed file format”, whatever the file’s size; the file is untouched and TopSpeedW programs keep reading and writing it meanwhile. A BIGFILE file carries its own signature, so a program built with an earlier Clarion version answers error 36 and leaves it alone. Rebuild every program that shares a TopSpeedW file with this build. From a beta report.

≡

Reports and lists

A previewed Unicode report prints at its exact paper position on every printer, edge to edge with the classic page, and the preview shows the page at the same position; recompile so PDF / HTML exports and the preview’s Find highlights use the same page geometry. With SYSTEM{PROP:PropVScroll} = TRUE, a one-row LIST in a box too short for a whole row, a closed drop list with a column header for one, opens and works like any other. From beta and user reports.

#

Projects: one .lib per DLL, and a TXA that follows your edits

A fresh install’s default redirection file writes a project’s .lib to the project folder, one copy for Debug and Release, so an EXE always links the library of the DLL you built last; the guide has the two lines to remove in an existing install. For teams that keep applications as TXA files under source control, this build reduces the incidental changes in a TXA that come from regular AppGen work: generating, opening and accepting a procedure, looking at embeds. The first generation with this build can change an application’s export once; after that it stays put. From user reports.

Full tester guide — mental model, conversion rules, DCT import table, screen controls, reports, blobs, SQL / SQLite / text drivers / TopSpeedW / Memory / IP, recipes, the new-language-surface quick reference, and what to focus on when testing. The guide’s “What’s new” section lists everything in this drop, and every section has its task topic in the F1 help’s “How do I …” chapter.

Open the full Unicode Tester Guide

Report tool authors — the wide generator surface (IReportGeneratorW), format detection, the EMF record set, transition paths per integration style, and the PageTextIndexClass text index the previewer searches with:

EMF Page Files — Transition Note

Standalone pages (best full-width). Everything described there is implemented unless marked as a known limitation — if you see something different, the beta forum is the place.

Leave a Reply