PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Finds one or more emails according to the criteria specified in the messaging software (Outlook, messaging software using the IMAP protocol, ...).
This search is performed in the current Outlook folder.
Reminder: This function cannot be used to find one or more emails in the Outlook Express messaging software.
Versions 22 and later
Android Widget This function is now available in Android Widget mode.
Android This function is now available for the Android applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
New in version 22
Android Widget This function is now available in Android Widget mode.
Android This function is now available for the Android applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
Android Widget This function is now available in Android Widget mode.
Android This function is now available for the Android applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
WEBDEV - Server codeLinux This function is now available for the WEBDEV sites in Linux.
WINDEVLinux This function is now available for the WINDEV applications in Linux.
Example
MySession is EmailIMAPSession
MyEmail is Email
...

// Find the emails containing "PC Soft"
// in the message subject or body
// Only the incoming emails are taken into account
IF EmailSeekFirst(MySession, MyEmail, emailSubject + emailBody, ...
"PC Soft") = True THEN
// Enumerate the emails found
WHILE MyEmail..Out = False
// Displays the sender and subject in a Table control
TableAdd(TABLE_EmailFound, Email..Sender + ...
TAB + MyEmail..Subject)
// Next email found
EmailReadNext(SessionID, MyEmail)
END
ELSE
Info("No email was found")
END
Syntax
Versions 15 and later

Seeking in an Email variable Hide the details

<Result> = EmailSeekFirst(<Session> , <Email> , <Email Section> , <Sought Value> [, <Read Mode>])
<Result>: Boolean
  • True if one or more emails have been found,
  • False otherwise. The ErrorOccurred variable is set to True if an error occurred. To find out the error details, use ErrorInfo associated with the errMessage constant.
If no email was found, ErrorOccurred remains to False and the Email.Out variable is positioned to True.
<Session>: Integer, or emailOutlookSession or emailIMAPSession variable
The session can be:
<Email>: Email variable
Message in which the search will be performed.
<Email Section>: Integer constant (or combination of constants)
Email section where the <Sought Value> will be sought:
emailBodyBody of emails.
emailRecipientRecipients of emails.
emailSenderSenders of emails.
emailMessageIDIdentifier of emails.
emailSubjectSubjects of emails.

These constants can be combined.
<Sought Value>: Character string
Value sought in the emails.
<Read Mode>: Optional constant or character string
Indicates the messages that will be read:
emailAll or "ALL"
(Default value)
The search is performed in the read emails and in the unread emails.
emailUnread or "UNREAD"The search is performed in the unread emails only.
New in version 15

Seeking in an Email variable Hide the details

<Result> = EmailSeekFirst(<Session> , <Email> , <Email Section> , <Sought Value> [, <Read Mode>])
<Result>: Boolean
  • True if one or more emails have been found,
  • False otherwise. The ErrorOccurred variable is set to True if an error occurred. To find out the error details, use ErrorInfo associated with the errMessage constant.
If no email was found, ErrorOccurred remains to False and the Email.Out variable is positioned to True.
<Session>: Integer, or emailOutlookSession or emailIMAPSession variable
The session can be:
<Email>: Email variable
Message in which the search will be performed.
<Email Section>: Integer constant (or combination of constants)
Email section where the <Sought Value> will be sought:
emailBodyBody of emails.
emailRecipientRecipients of emails.
emailSenderSenders of emails.
emailMessageIDIdentifier of emails.
emailSubjectSubjects of emails.

These constants can be combined.
<Sought Value>: Character string
Value sought in the emails.
<Read Mode>: Optional constant or character string
Indicates the messages that will be read:
emailAll or "ALL"
(Default value)
The search is performed in the read emails and in the unread emails.
emailUnread or "UNREAD"The search is performed in the unread emails only.

Seeking in an Email variable Hide the details

<Result> = EmailSeekFirst(<Session> , <Email> , <Email Section> , <Sought Value> [, <Read Mode>])
<Result>: Boolean
  • True if one or more emails have been found,
  • False otherwise. The ErrorOccurred variable is set to True if an error occurred. To find out the error details, use ErrorInfo associated with the errMessage constant.
If no email was found, ErrorOccurred remains to False and the Email.Out variable is positioned to True.
<Session>: Integer, or emailOutlookSession or emailIMAPSession variable
The session can be:
<Email>: Email variable
Message in which the search will be performed.
<Email Section>: Integer constant (or combination of constants)
Email section where the <Sought Value> will be sought:
emailBodyBody of emails.
emailRecipientRecipients of emails.
emailSenderSenders of emails.
emailMessageIDIdentifier of emails.
emailSubjectSubjects of emails.

These constants can be combined.
<Sought Value>: Character string
Value sought in the emails.
<Read Mode>: Optional constant or character string
Indicates the messages that will be read:
emailAll or "ALL"
(Default value)
The search is performed in the read emails and in the unread emails.
emailUnread or "UNREAD"The search is performed in the unread emails only.

Seeking in the Email structure Hide the details

<Result> = EmailSeekFirst(<Session> , <Email Section> , <Sought Value> [, <Read Mode>])
<Result>: Boolean
  • True if one or more emails have been found,
  • False otherwise. The ErrorOccurred variable is set to True if an error occurred. To find out the error details, use ErrorInfo associated with the errMessage constant.
If no email was found, ErrorOccurred remains to False and the Email.Out variable is positioned to True.
<Session>: Character string, integer, or emailOutlookSession or emailIMAPSession variable
The session can be:
Versions 15 and later
New in version 15
<Email Section>: Integer constant (or combination of constants)
Email section where the <Sought Value> will be sought:
emailBodyBody of emails.
emailRecipientRecipients of emails.
emailSenderSenders of emails.
emailMessageIDIdentifier of emails.
emailSubjectSubjects of emails.

These constants can be combined.
<Sought Value>: Character string (with quotes)
Value sought in the emails.
<Read Mode>: Optional constant or character string (with quotes)
Indicates the messages that will be read:
emailAll or "ALL"
(Default value)
The search is performed in the read emails and in the unread emails.
emailUnread or "UNREAD"The search is performed in the unread emails only.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230com.dll
Windows Mobile wp230com.dll
Linux wd230com.so
Android wd230android.jar
Minimum required version
  • Version 11
This page is also available for…
Comments
Click [Add] to post a comment