wiki:Documentation/ARexxAPI/SETMAIL

Version 4 (modified by AmigaPhil, 11 months ago) (diff)

--

Needs update regarding ticket #351

Languages:


ARexx API

    SETMAIL

    NAME

    SetMail -- Set the current message in the current folder by its position in the list.

    TEMPLATE

    NUM/N/A,MSGID/K

    FUNCTION

    Sets the current message in the current folder by its position in the list. The message list is redrawn if necessary to make the new current message visible, and all previously selected messages get deselected.

    INPUTS

    NUM/N/A - position occupied by the message in the list, may be a number between 0 and n-1
    MSGID/K - MessageID of the message (V2.8 )

    RETURNS

    RC is set to 10 if the specified message doesn't exist.

    NOTES

    SETMAIL sets the current message, but doesn't *select* messages by itself; use LISTSELECT ? for that.

    EXAMPLE

    /* Make the third message in the list the current message */

    SETMAIL 2

    BUGS

    SEE ALSO

    LISTSELECT ?, SETMAILFILE ?