Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

SETMESSAGEQQ

QuickWin Subroutine: Changes QuickWin status messages, state messages, and dialog box messages. This routine is only available for Windows.

Module

USE IFQWIN

CALL SETMESSAGEQQ (msg,id)

msg

(Input) Character*(*). Message to be displayed. Must be a regular Fortran string, not a C string. Can include multibyte characters.

id

(Input) INTEGER(4). Identifier of the message to be changed. The following table shows the messages that can be changed and their identifiers:

Id

Message

QWIN$MSG_TERM

"Program terminated with exit code"

QWIN$MSG_EXITQ

"Exit Window"

QWIN$MSG_FINISHED

"Finished"

QWIN$MSG_PAUSED

"Paused"

QWIN$MSG_RUNNING

"Running"

QWIN$MSG_FILEOPENDLG and QWIN$MSG_BMPSAVEDLG control the text in file choosing dialog boxes and have the following syntax:

"file description, file designation"

You can change any string produced by QuickWin by calling SETMESSAGEQQ with the appropriate id. This includes status messages displayed at the bottom of a QuickWin application, state messages (such as "Paused"), and dialog box messages. These messages can include multibyte characters. To change menu messages, use MODIFYMENUSTRINGQQ.

Example

USE IFQWIN print*, "Hello" CALL SETMESSAGEQQ('Changed exit text', QWIN$MSG_EXITQ)