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.
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.
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.
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:
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.