Groupwise Developer's Guide

44
gwCabinet:=gwAccount.Cabinet;
try
gwCabinet.Folders.Add(MainFolder);
except
ShowMessage('Error Adding Folder');
end;
end;
Folders.Add(SharedMessage as SharedNotification, [Name as String])
This method creates a shared folder based on the SharedNotification object that is
passed in as the first parameter. Name will set the Folder.Name property of the
newly created folder. For more information on Shared Folders, see below.
Getting at the Contents of a Folder
One of the main reasons for wanting to access a GroupWise folder is to get at the
messages contained within. To that end, look at a folder as the collection of
message and subfolders that it contains. To access the messages in a folder, you
have several options:
First, you can access the Folder.Messages property, which returns all of the
messages contained within the folder in a Messages collection.
Second, you can use the Folder.FindMessages() method.
Folder.FindMessages(Condition)
This method takes one parameter; a variant called Condition. Condition may be a
string filter expression or a previously created Filter object. For more
information on Conditions and how to create them, see Chapter 8: Understanding
Field and Field Related Objects.
Because the Messages collection object returned by Folder.Messages takes
more resources and is slower than a MessageList object returned by
Folder.FindMessages(), you should use Folder.FindMessages() when you
can. However, if you have already instantiated a Messages object using the
Folder.Messages property, feel free to do so again without concern about
performance.
The following sample searches the Mailbox Folder for messages that include the
word “the”. It then displays the number of messages found.
www.novell.com/appnotes