Help files

Data type Properties

Some of the built in WinAutomation data types have properties, which are values associated to the value stored in the variable. The value of these properties can be accessed directly through the following notation: %VariableName.PropertyName%.

Below you can find the available properties for the different built-in WinAutomation data types:

Data type Text has the following property:

  • Length: the length (in characters) of the text stored into the variable.

Data type DateTime has the following properties:

  • Year: The year part of the DateTime value.

  • Month: The month part of the DateTime value.

  • Day: The day part of the DateTime value.

  • DayOfWeek: The name of the day (e.g. Sunday, Monday etc)

  • DayOfYear: The day of the year part of the DateTime value (1-365/6)

  • Hour: The hour part of the DateTime value.

  • Minute: The minute part of the DateTime value.

  • Second: The seconds part of the DateTime value.

Data type List has the following property:

  • Count: the number of items stored into the list.

Data type File has the following properties:

  • FullName: The full path to the file.

  • RootPath: The root path of the file (e.g. C:\).

  • Directory: The directory where the file is stored.

  • Name: The name of the file, including the extension (e.g. MyFile.txt).

  • NameWithoutExtension: The name of the file, without its extension.

  • Extension: The extension of the file.

  • Size: The size of the file (in bytes).

  • CreationTime: The date when the file was created.

  • LastAccessed: The date when the file was last accessed.

  • LastModified: The date when the file was last modified.

  • IsHidden: This property is true if the file is hidden or false if the file is visible.

  • IsSystem: This property is true if the file is a system file or false if it is not.

  • IsReadOnly: This property is true if the file is read only or false if it is not.

  • IsArchive: This property is true if the file is an archive or false if it is not.

  • Exists: This property is true if the file exists or false if the file does not exist.

Data type Folder has the following properties:

  • FullName: The full path to the folder.

  • RootPath: The root path of the folder (e.g. C:\).

  • Parent: The parent directory of the folder.

  • Name: The name of the folder.

  • CreationTime: The date when the folder was created.

  • LastModified: The date when the folder was last modified.

  • IsHidden: This property is true if the folder is hidden or false if the folder is visible.

  • Exists: This property is true if the folder exists or false if the folder does not exist.

Data type Mail Message has the following properties:

  • MailFolder: the name folder the email message is retrieved from

  • Uid: the unique identifier of the message

  • From: the sender of the email message

  • To: a list of values containing the recipients of the message

  • Cc: a list of values containing additional recipients for the message (carbon copy)

  • Date: the date and time in which the message was sent

  • Subject: the subject of the message

  • Body: the body of the message. This can be in plain text or in HTML form

  • BodyText: if the previous property contains HTML, this property contains the body of the message in plain text form.

  • Attachments: a list of File data types that represent the attachments of the email message (if any) after they have saved locally.

Data type FTPFile has the following properties:

  • FullName: The full path to the file.

  • Directory: The directory where the file is stored on the FTP Server.

  • Name: The name of the file, including the extension (e.g. MyFile.txt).

  • NameWithoutExtension: The name of the file, without its extension.

  • Extension: The extension of the file.

  • Size: The size of the file (in bytes).

  • LastModified: The date when the file was last modified.

Data type FTPFolder has the following properties:

  • FullName: The full path to the folder.

  • Parent: The parent directory of the folder.

  • Name: The name of the folder.

  • LastModified: The date when the folder was last modified.

Data type DataTable has the following properties:

  • RowsCount: The number of rows of the DataTable

  • Columns: A list that contains the names of the columns of the DataTable

Data type DataRow has the following property:

  • ColumnsCount: The number of columns that the DataRow holds.

Data type Custom Dialog Instance has the following property:

  • LastButtonPressed: The name of the button that was last pressed on the dialog.

  • DialogWasForciblyClosed: This property is true if the dialog was closed by a close window command or by pressing the "Cancel Button", false otherwise.

  • Handle: The handle of the Window belonging to this specific Custom Dialog.