Functions
There are two ways to view the SMTPit Pro function reference, the Function Reference below, and the Function Reference Browser in a new window.
Function ReferenceThe Function Reference is a complete reference for SMTPit Pro functions. Click on a function title to view more information which includes the function description, parameter information, example usage and more. | Function Reference Browser![]() The Function Reference Browser offers better navigation for the SMTPit Pro functions, you can Launch Function Browser in a new window. |
Function Reference
- SMTPit_AddEmailHeader
The SMTPit_AddEmailHeader function adds extra email headers to your email message. The "Headers" parameter takes a name and value pair string. Multiple headers can be added by separating name and... read more
- SMTPit_Clear
The SMTPit_Clear function clears all values that have been set with the External Functions. This allows you to send a new message without any lingering values. However, you can also clear only... read more
- SMTPit_Configure
Calling this function with no parameters will open the SMTPit Pro Configuration Dialog. You can optionally open to a specific tab by specifying the name of the tab as the "Option" parameter. This... read more
- SMTPit_Connect
You can use the "SMTPit_Connect" function to specifically connect to your mail server rather than letting the "SMTPit_Send" function connect for you. When you normally use the "SMTPit_Send"... read more
- SMTPit_Disconnect
If you use SMTPit_Connect to connect to your mail server manually (instead of letting SMTPit_Send do it), then you must call SMTPit_Disconnect to disconnect from your mail server. Otherwise, SMTPit... read more
- SMTPit_File_Copy
You can use this function to copy a file to a new... read more
- SMTPit_File_Delete
You can use this function to delete a... read more
- SMTPit_File_Exists
This function will check to see if a file... read more
- SMTPit_File_Export
This function will export a file from a container to a specified path. SMTPit Pro will use the name of the file in the container unless you specify a name with the "SaveAs"... read more
- SMTPit_File_GetPath
You can use the SMTPit_File_GetPath to retrieve a variety of paths including: Database, FileMaker, Root, System, Desktop, Preferences, Temporary, Applications, or Documents. This function can be... read more
- SMTPit_File_Move
You can use this function to move a file to a new... read more
- SMTPit_File_Rename
You can use this function to rename a... read more
- SMTPit_File_SelectFileWithDialog
This function will display a file chooser dialog. You can set the location to open the dialog to, as well as display a custom prompt... read more
- SMTPit_File_SelectFolderWithDialog
This function will display a folder chooser dialog. You can set the location to open the dialog to, as well as display a custom prompt... read more
- SMTPit_File_Size
This function returns the size of a... read more
- SMTPit_GetSendValue
This function retrieves values entered in the last Email Window or last email sent. It can be used for archiving the sent email. You can also use this function in concert with the "SMTPit_Send"... read more
- SMTPit_IsConnected
This function will tell you whether or not you are currently connected to a mail... read more
- SMTPit_MergeText
With SMTPit Pro, you can use Merge Fields in your email messages. A merge field is a tag representing a field which will get replaced with the field's contents when the message is sent. For... read more
- SMTPit_QuickSet
The SMTPit_QuickSet function allows you to set the From, To, Subject, and TextBody in a quick an simple format. You can also use functions for each of these... read more
- SMTPit_Register
You can use this function to Register the plug-in from a script instead of through the Configuration Dialog. This is useful when the plug-in is being distributed to many computers, allowing you to... read more
- SMTPit_Send
The SMTPit_Send function first checks to make sure you have assigned enough fields to send an email. If everything checks out, it attempts to send the email to your mail server. If there is a problem... read more
- SMTPit_SendWithDialog
This function presents the user with a dialog for composing an email. There is both a Simple and Advanced version of the dialog. (The Simple version looks like the Message Dialog in MMEmail). If... read more
- SMTPit_SetAttachment
The SMTPit_SetAttachment function allows you to attach a file from your hard drive or network to the current email being sent. You must specify the full path and filename of the file. You can set... read more
- SMTPit_SetAttachmentWithDialog
This function presents you with a standard open file dialog that lets you choose a file from your hard drive. It then attaches the chosen file to the current... read more
- SMTPit_SetAuthentication
If your mail server requires authentication (requires you to log in) before it allows you to send email, then use the SMTPit_SetAuthentication function to assign the type of authentication your mail... read more
- SMTPit_SetBCC
Use the SMTPit_SetBCC function to assign the "BCC" (Blind Carbon Copy) email address(es). Any email addresses you have in the BCC list will have the email sent to them, but their email will not show... read more
- SMTPit_SetBody
Use the SMTPit_SetBody function to set the Plain Text or HTML Body of the email. The "Body" of the email is the content of the email that the receiver will... read more
- SMTPit_SetBodyFooter
This unique function will allow you to have a "Footer" section in the Plain Text or HTML Body of your email. Possible uses include an email signature, a public key, an email advertisement, quotes, or... read more
- SMTPit_SetBodyHeader
This unique function will allow you to have a "Header" section in the Plain Text or HTML Body of your email message. Possible uses are email letterheads or personalized email messages for mass... read more
- SMTPit_SetBodyWithFile
You can use the SMTPit_SetBodyWithFile function to load a text file into the Plain Text or HTML Body of the... read more
- SMTPit_SetCC
Use the SMTPit_SetCC function to assign the "CC" (Carbon Copy) email address(es). If you have multiple email addresses and you want to set them all at once, separate each email address with a... read more
- SMTPit_SetCharSet
Sets the Character Set that SMTPit uses when generating the... read more
- SMTPit_SetFrom
Use the SMTPit_SetFrom function to assign the "From" email address. If you assign a from email address using this function, SMTPit Pro will ignore the Default From field in the Configuration Dialog.... read more
- SMTPit_SetHost
The Host is the domain name or IP address of the SMTP Pro mail server you are connecting to. You can assign the host in your scripts, or set up a Default Host in the Configuration Dialog. SMTPit_Send... read more
- SMTPit_SetInlineImage
The SMTPit_SetInlineImage function is similar to the SMTPit_SetAttachment function. This function allows you to attach a graphic image file from your hard drive or network to the current email being... read more
- SMTPit_SetInlineImageWithDialog
The SMTPit_SetInlineImageWithDialog function is similar to the SMTPit_SetAttachmentWithDialog function. This function presents you with a standard open file dialog that lets you choose an image file... read more
- SMTPit_SetPriority
This function allows you to set the "Priority" of an email. Most email clients understand the Priority setting on an email and will highlight the email as more or less important than other emails.... read more
- SMTPit_SetReplyTo
This function is used to set the "Reply-To" header of an email message. Most email clients will look for this email header and when a user replies to an email, the email will be sent to this email... read more
- SMTPit_SetSubject
Use this function to set the Subject of the email. If you assign a Subject of the email with this function, SMTPit Pro will ignore the Default Subject field in the Configuration... read more
- SMTPit_SetTo
Use the SMTPit_SetTo function to assign the "To" email address(es). If you have multiple email addresses and you want to set them all at once, separate each email address with a paragraph mark or, if... read more
- SMTPit_StatusWindow
Use this function to show a status window that displays information about what the plug-in is currently doing. When you are sending an email, the status window will show you what part of the email it... read more
- SMTPit_StyledTextToHTML
This function will convert styled text to HTML. In other words, you can convert a field that has styled text such as bold, underline, color, font, size, etc. to html and in effect, send HTML email... read more
- SMTPit_VerifyEmailAddress
You can use this function to verify the syntax of an email address to see if it "looks" correct. You can also verify the email address against its host server to see if it is valid. Note: The... read more
- SMTPit_Version
This function returns the current version of SMTPit Pro. This function is useful for testing whether or not the plug-in is installed and enabled. If you call this function and a question mark ("?")... read more
- SMTPit_VersionAutoUpdate
This function returns an Auto Update friendly Version number of SMTPit Pro. The format of this version number is always exactly 8 digits long. The first two digits represent the major version of... read more
