SENDMSG() Function - Send Message to Windows and Controls

Syntax

SENDMSG(sysgui,id,function,int,string${,context{,ERR=lineref}})

Description

The SENDMSG() function sends messages to windows and controls. The meaning of the returned string depends on the type of object the id parameter refers to and the message being sent.

While the SENDMSG() functions contained in this section apply to windows and child windows, there are SENDMSG()functions that apply specifically to grid , INPUTE, INPUTN, and tab controls, as well as those that apply specifically to setting international keyboards. The following identifies the parameters common to all SENDMSG() functions:

Parameter

Description

sysgui

Valid SYSGUI channel.

id

Object ID. For system operations, use a value of -1. Use a value of 0 when referring to the window in the current context. When the context parameter is included, using a value of 0 refers to the window of the specified context.

function

Function number.

int

Four-byte integer containing an argument for a given function.

string$

String argument for a given function.

context

Context that contains the specified ID. This parameter is only necessary for objects that do not pertain to the current context.

ERR=lineref

Branch to be taken if an error occurs during execution.

If any parameters are invalid because they specify an id or context that does not exist or are invalid for the request, Visual PRO/5 generates an !ERROR=17 and sets the TCB(10) value to the 1-based index of the invalid parameter.

See Also

GRID SENDMSG() Functions Listed in Alphabetical Order

GRID SENDMSG() Functions Listed in Numeric Order

GRID SENDMSG() Functions Listed by Functional Grouping

Functions - Alphabetical Listing