Programmer Guide/Command Reference/PARSECELLMESSAGE: Difference between revisions
From STX Wiki
Jump to navigationJump to search
No edit summary |
No edit summary |
||
Line 8: | Line 8: | ||
* the variables whose names are stored in the remaining arguments are where the parsed output of the <code>PARSECELLMESSAGE</code> command will be stored. Their meaning is as follows: | * the variables whose names are stored in the remaining arguments are where the parsed output of the <code>PARSECELLMESSAGE</code> command will be stored. Their meaning is as follows: | ||
* the variable whose name is stored in <var>itemvar</var> will be set to the number of the dialog item the message is referring to; | :* the variable whose name is stored in <var>itemvar</var> will be set to the number of the dialog item the message is referring to; | ||
* the variables whose names are stored in <var>rowvar</var> and <var>colvar</var>, respectively, will be set to the row and the column the cell message is referring to; | :* the variables whose names are stored in <var>rowvar</var> and <var>colvar</var>, respectively, will be set to the row and the column the cell message is referring to; | ||
* the variables whose names are stored in <var>newlenvar</var> and <var>newvalvar</var> will be set to the length of the *new* value of the respective cell, and to this value itself, respectively; and, finally, | :* the variables whose names are stored in <var>newlenvar</var> and <var>newvalvar</var> will be set to the length of the *new* value of the respective cell, and to this value itself, respectively; and, finally, | ||
* the variables whose names are stored in <var>oldlenvar</var> and <var>oldvalvar</var> will be set to the length of the ''old'' value of the respective cell (i.e. the value it contained *before* the edit reported by the message has taken place) | :* the variables whose names are stored in <var>oldlenvar</var> and <var>oldvalvar</var> will be set to the length of the ''old'' value of the respective cell (i.e. the value it contained *before* the edit reported by the message has taken place) |
Revision as of 17:24, 25 April 2014
PARSECELLMESSAGE srcvar itemvar rowvar colvar newlenvar newvalvar oldlenvar oldvalvar
The PARSECELLMESSAGE command (aka PARSECELLMSG
) facilitates parsing cell messages sent by listview controls. The arguments are the names of variables with the following properties:
- the variable whose name is stored in srcvar contains the input to
PARSECELLMESSAGE
, i.e. the argument passed to the message nameCELLEDITED
orCELLEDITEDBACKTAB
, respectively
- the variables whose names are stored in the remaining arguments are where the parsed output of the
PARSECELLMESSAGE
command will be stored. Their meaning is as follows:
- the variable whose name is stored in itemvar will be set to the number of the dialog item the message is referring to;
- the variables whose names are stored in rowvar and colvar, respectively, will be set to the row and the column the cell message is referring to;
- the variables whose names are stored in newlenvar and newvalvar will be set to the length of the *new* value of the respective cell, and to this value itself, respectively; and, finally,
- the variables whose names are stored in oldlenvar and oldvalvar will be set to the length of the old value of the respective cell (i.e. the value it contained *before* the edit reported by the message has taken place)