3.74 QuickMessage

Provides a faster way to access messages.

3.74.1 Properties

The following table lists properties along with their access and descriptions.

Property

Access

Description

Accepted

R/O

Boolean. TRUE if the QuickMessage is an Appointment, Task, or Note item and has been accepted by the user. If the item isn't an Appointment, Task, or Note item, S_FALSE is also returned (in addition to FALSE).

Application

R/O

Application. Returns the application object.

BoxType

R/O

MessageBoxTypeConstants. Returns an enumeration value for Message that corresponds to whether the item is one of the following:

  • Received egwIncoming
  • Sent egwOutgoing
  • Personal egwPersonal
  • Draft egwDraft

Categories

R/O

Categories. Returns the Categories collection object that corresponds to the QuickMessage. Any changes made to the Categories or Category objects that are accessed from QuickMessage are not reflected back to the QuickMessage object. If changes are made, the Categories object is released, and the Categories object is retrieved again, the old Categories object is returned.

EnclosingFolders

R/O

Folders. Returns a Folders collection object that holds every folder this QuickMessage appears in.

Hidden

R/O

Boolean. TRUE if this QuickMessage is hidden. If a QuickMessage is hidden, it does not show up in any user interface.

Message

R/O

Message. Returns the full Message object that corresponds to this QuickMessage. Any changes that are made to the Message object (or any of its sub objects) are not given to the QuickMessage object. To see the changes, the entire QuickMessages collection and the associated QuickMessage objects must be released and reacquired.

ModifiedDate

R/O

Date. The date and time the QuickMessage was last modified.

Opened

R/O

Boolean. TRUE if this QuickMessage has been opened.

Parent

R/O

QuickMessages. Returns the QuickMessages collection object that spawned the QuickMessage object.

PersonalSubject

R/O

String. A text string that is displayed by the GroupWise Windows client as the subject text. The text appears only for the current user. The normal subject or their own personal subject text appears for other users.

Private

R/O

Boolean. TRUE if the QuickMessage is marked Private (so that a proxy user cannot see it).

Read

R/O

Boolean. TRUE if the QuickMessage has been read.

Subject

R/O

String. The subject of the message. Unlike the full Message object, QuickMessage returns only the plain text version of the subject.

3.74.2 Remarks

A QuickMessage is a small subset of the full Message object. QuickMessage properties should match their corresponding Message object. However, if the full Message object is obtained and then changed, the changes do not make it back into the QuickMessage object. To refresh QuickMessage, the entire QuickMessages collection and all related objects from the collection must be released and then retrieved again.