ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Communication / Managing emails
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
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 search for one or more emails in Outlook Express.
MaSession is emailIMAPSession
MonEmail is Email
...

// Recherche des emails contenant la chaîne "PC Soft" 
// dans le sujet ou dans le corps du message
// Seuls les emails reçus sont pris en compte
IF EmailSeekFirst(MaSession, MonEmail, emailSubject + emailBody, ...
			"PC Soft") = True THEN
	// Enumération des emails trouvés
	WHILE MonEmail.Out = False
		// Affiche l'expéditeur et le sujet dans un champ Table
		TableAdd(TABLE_EmailTrouve, MonEmail.Sender + ...
			TAB + MonEmail.Subject)
		// Email trouvé suivant
		EmailReadNext(MaSession, MonEmail)
	END
ELSE
	Info("Aucun email n'a été trouvé")
END
Syntax

Seeking in an Email variable Hide the details

<Result> = EmailSeekFirst(<Session> , <Email> , <Email section> , <Search value> [, <Read mode>])
<Result>: Boolean
  • True if one or more emails have been found,
  • False otherwise. If an error occurs, the ErrorOccurred variable is set to True. To get more details on the error, use ErrorInfo with the errMessage constant.
If no email was found, ErrorOccurred remains set to False and the Email.Out variable is set 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.
emailMessageIDIdentifier of emails.
emailRecipientRecipients of emails.
emailSenderSenders of emails.
emailSubjectSubjects of emails.

These constants can be combined.
<Search 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> , <Search value> [, <Read mode>])
<Result>: Boolean
  • True if one or more emails have been found,
  • False otherwise. If an error occurs, the ErrorOccurred variable is set to True. To get more details on the error, use ErrorInfo with the errMessage constant.
If no email was found, ErrorOccurred remains set to False and the Email.Out variable is set to True.
<Session>: Character string, integer, or emailOutlookSession or emailIMAPSession variable
The session can be:
<Email section>: Integer constant (or combination of constants)
Email section where the <Sought Value> will be sought:
emailBodyBody of emails.
emailMessageIDIdentifier of emails.
emailRecipientRecipients of emails.
emailSenderSenders of emails.
emailSubjectSubjects of emails.

These constants can be combined.
<Search 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.
Component: wd300com.dll
Minimum version required
  • Version 11
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 03/27/2025

Send a report | Local help