Silverfrost Logo About Us | Contact Us
 

CLEARWIN_STRING@

Platform

Win32(ClearWin+)

Purpose

To obtain string information from ClearWin+.

Syntax

CHARACTER*(*) FUNCTION CLEARWIN_STRING@( STR )
CHARACTER*(*) STR

Description

Parameters are specified as case insensitive character strings. They may be system or user-defined values.

ClearWin+ maintains a set of system strings that contain information from the system. The following have been defined:

CALLBACK_REASON
See the end of this list.

 

CURRENT_TEXT_ITEM etc.
See Hypertext windows.

CURRENT_MENU_ITEM
This option will return a string containing the current menu item selected. It is employed when using dynamic menus that have a shared call-back (see Dynamic menus).

DROPPED_FILE
Is a string containing the full path and filename of the object dropped into a format window using %dr.

CURRENT_URL
Is the URL being navigated to when the callback reason is HYPERTEXT_LINK

CALLBACK_REASON
Whenever a call-back function is invoked, this string can be used to determine the reason for the call. The following list of reasons (upper case letters only) may be extended in the future, so programs should be designed to ignore reasons which they do not recognise.

 

 

Reason

Comments

 

'ACCELERATOR'

Call associated with %ac.

 

'BUTTON_PRESS'

A button has been pressed.

 

'COLOURING'

User_colour event for edit box (%eb).

 

'DATA_ALTERATION'

The contents of %eb, %rd (etc.) box have been altered.

 

'DIRTY'

Indicates an OpenGL window is in need of re-painting.

 

'DRAG_AND_DROP'

Call in response to dropping a file onto the window.

 

'ENUMERATED_PARAMETER'

An enumerated parameter (%ep) has been selected from within a parameter box.

 

'FILE_OPEN'

Call from 'FILE_OPENR' or 'FILE_OPENW'.

 

'GAINING_FOCUS'

Edit box gets input focus.

 

'HYPERTEXT_CHANGE'

Called when hypertext is being changed.

 

'HYPERTEXT_LINK'

Call-back from activating a hypertext link in %ht or %wb.

 

'ITEM_DOUBLE_CLICKED'

Listbox item double clicked.

 

'ITEM_SELECTED'

Listbox item selected.

 

'KEY_DOWN'

A keyboard key has been pressed.

 

'LOSING_FOCUS'

Edit box loses input focus.

 

'MENU_SELECTION'

A menu item has been invoked.

 

'MESSAGE_HOOK'

Call of %mg related function.

 

'MOUSE_LEFT_CLICK'

Left button down.

 

'MOUSE_LEFT_RELEASE'

Left button up.

 

'MOUSE_DOUBLE_CLICK'

Left double click.

 

'MOUSE_MIDDLE_CLICK'

Middle button down.

 

'MOUSE_MIDDLE_RELEASE'

Middle button up.

 

'MOUSE_MOVE'

Mouse movement.

 

'MOUSE_RIGHT_CLICK'

Right button down.

 

'MOUSE_RIGHT_RELEASE'

Right button up.

 

'RESIZE'

Called when a control is being re-sized.

 

'USER_PARAMETER'

A user parameter (%up) has been selected from within a parameter box.

 

'TIMER'

Call associated with %dl.

 

'WINDOW_CLOSE'

Call in response to %cc.

 

'WINDOW_STARTUP'

Call in response to %sc.

 

'+'

Called as part of a compound call-back.

 

'?'

Not currently in a call-back.


 

Return value

Returns the value of the specified string parameter.

See also

SET_CLEARWIN_STRING@

 

 

Copyright © 1999-2017 Silverfrost Limited