EccoItem Properties

FolderValue (Folder)

Read/write. Reads or sets the specified folder's value for the item.

You may specify the folder either as an integer (representing the ID number of the folder), or as an EccoFolder object.  You may also specify the folder by name, but be careful; an Ecco folder can contain more than one folder with the same name, and results can be unpredictable.

This function will return a boolean (true or false) for checkmark items; a date variant for dates; a variant for numbers; and a string for popup and text values.

When writing data to Ecco, this function will attempt to intelligently convert the supplied data to the appropriate type for the Ecco folder. For example, legal string dates and date variants will be accepted for dates; numbers or strings that can be converted to numbers will be accepted for numbers; etc.

AltPhone

Read/write text. Reads or sets the Alt # value for the item (canonical folder 127).

BusAddr1

Read/write text. Reads or sets the Address 1 - Business value for the item (canonical folder 118).

BusAddr2

Read/write text. Reads or sets the Address 2 - Business value for the item (canonical folder 133).

BusAddress

Read-only text. Returns the complete formatted business address.

BusCity

Read/write text. Reads or sets the City - Business value for the item (canonical folder 119).

BusCountry

Read/write text. Reads or sets the Country - Business value for the item (canonical folder 122).

BusPhone

Read/write text. Reads or sets the Work # value for the item (canonical folder 123).

BusState

Read/write text. Reads or sets the State - Business value for the item (canonical folder 120).

BusZip

Read/write text. Reads or sets the Zip - Business value for the item (canonical folder 121).

CellPhone

Read/write text. Reads or sets the Cell # value for the item (canonical folder 126).

Company

Read/write text. Reads or sets the Company value for the item (canonical folder 117).

DefaultAddress

Read-only text. Returns the complete formatted default address (business or home) for the item.

Done

Read/write date variant. Returns the date (and time if specified) that the item was marked done (canonical folder 1), as a date variant. You may set this value using either a date variant or a string that can be interpreted as a date.

DueDate

Read/write date variant. Returns the due date (canonical folder 12) for the item as a date variant. You may set this value using either a date variant or a string that can be interpreted as a date.

EMail

Read/write text. Reads or sets the E-Mail value for the item (canonical folder 18).

EndLog

Read/write date variant. Returns the ending time for the Phone/Time Log folder (canonical folder 16) as a date variant. You may set this value using either a date variant or a string that can be interpreted as a date.

EndTime

Read/write date variant.  Returns the ending time for the Appointments folder (canonical folder 4) as a date variant. You may set this value using either a date variant or a string that can be interpreted as a date.

FaxPhone

Read/write text. Reads or sets the Fax # value for the item (canonical folder 125).

FirstName

Read-only text. Returns the first name of the item text.

FullName

Read-only text. Returns the full name of the item text. For example, if the item text is "Doe, John," this property returns "John Doe."

HomeAddr1

Read/write text. Reads or sets the Address 1 - Home value for the item (canonical folder 128).

HomeAddr2

Read/write text. Reads or sets the Address 2 - Home value for the item (canonical folder 134).

HomeAddress

Read-only text. Returns the formatted home address for the item.

HomeCity

Read/write text. Reads or sets the City - Home value for the item (canonical folder 129).

HomeCountry

Read/write text. Reads or sets the Country - Home value for the item (canonical folder 132).

HomePhone

Read/write text. Reads or sets the Home # value for the item (canonical folder 124).

HomeState

Read/write text. Reads or sets the State - Home value for the item (canonical folder 130).

HomeZip

Read/write text. Reads or sets the Zip - Home value for the item (canonical folder 131).

ID

Read/write integer. Returns the unique ID associated with the Ecco item. Note that changing this value does not change the ID associated with a given item, but rather causes the object to reference a different item in the Ecco file.

LastName

Read-only text. Returns the last name of the item text. For example, if the item text is "Doe, John," this property will be "Doe."

Parent

Read-write EccoItem. Reads or sets the immediate parent item of the item.  This is a powerful function that could be used to implement program-controlled linking of Ecco items.

PhoneBook

Read-write boolean. Reads or sets whether an item is included in the PhoneBook folder (canonical folder 13).

Prefix

Read/write text. Reads or sets the Mr./Ms. value for the item (canonical folder 136).

StartDate

Read/write date variant.  Returns the starting date and time for the Start Dates folder (canonical folder 11) as a date variant. You may set this value using either a date variant or a string that can be interpreted as a date.

StartLog

Read/write date variant.  Returns the ending time for the Phone/Time Log folder (canonical folder 16) as a date variant. You may set this value using either a date variant or a string that can be interpreted as a date.

StartTime

Read/write date variant.  Returns the starting date and time for the Appointments folder (canonical folder 4) as a date variant. You may set this value using either a date variant or a string that can be interpreted as a date.

Subs

Read-only EccoItems. Returns an EccoItems collection representing all first-level sub-items of the item.

Text

Read-write text. Reads or sets the item text.

Title

Read/write text. Reads or sets the Job Title value for the item (canonical folder 116).

TLI

Read-only EccoItem. Returns the top-level parent item of the item.

ToDo

Read/write date variant.  Returns the starting time for the To-Do's folder as a date variant. You may set this value using either a date variant or a string that can be interpreted as a date.