Parameter syntax	Data type
date	Date and time in Short Date style and Time style from Windows Regional Settings (DATE in Visual C++)
fParameter	Float (Single in Visual C++)
iParameter	Short integer
lParameter	Long integer
szString	String, terminated by a null character (BSTR in Visual C++)
True\|False or bParameter	Boolean
vParameter	Variant (VARIANT in Visual C++)

File	Description
ACT.EXE	The ACT! Application Object is contained within the executable file for the ACT! application.
ACT.TLB	Type library that contains functions within the ACT! OLE Application Object. Methods contained in the type library need to be used directly by Visual C++ developers. In Visual Basic type library functions are handled automatically at run time.
ACTEVENT.OCX	OLE event notification control module, used by third-party applications for receiving event notification. An event is generated, for example, when the contact is changed in the Contact View.
ACTREG.EXE	The ACT! Windows registry update utility. This utility can be run manually if necessary to register ACT! OLE controls as a troubleshooting procedure.

Property name	Type	C++ Method
ContactView.Active	Read Only	ContactView.GetActive()
Preferences.ExitPrompt	Read/Write	Preferences.GetExitPrompt() (to get the value of the property) Preferences.SetExitPrompt() (to get the value of the property)

Object	Modified Methods	Change
Application	Command	Many values for lCommandID parameter added
Grid	GetColumnCount GetColumnID GetCurrentRow GetRowCount GetRowNumber	Return value on failure changed from 100 to -1
Preferences	GetEmailNewMsgInfo	Return string changed to: CreateHist\InitialText
	GetSchdActivityDefaults	PopupFields returned item added
	GetSynchSchedule	Return string changed to: SynchDays\SynchTime...
	SetEmailNewMsgInfo	The szInfo parameter changed to: CreateHist\InitialText
	SetSchdActivityDefaults	PopupFields parameter added
	SetSynchSchedule	The szInfo parameter changed to: SynchDays\SynchTime...

Object	New Properties	New Methods
Common properties and methods		ClearError
Application		AddUser BackupDB ClearError GetCurrentUsername GetUserPrivilege GetVersion ProcessFile RestoreDB
ContactListView		AddNewContactEx
ContactView		AddNewActivityEx AddNoteHistoryEx AttachFile GetTabCount GetTabName LookupFieldEx NewContactDialog SelectContactDlg
Grid		GetFilter RefreshGrid SelectRow SetFilter
GroupView		AddNoteEx AttachFile GetTabCount GetTabName LookupFieldEx SaveQuery
Preferences	AttachMsgToContact AttachToMsgUsing CalMinDurationForBanner ContactSalutation GenerateSynchReport GetSynchScheduleInfo NewActivitiesSeparate PromptToPrintEnvelope ReceivedSynchLocation RemindToBackup ReturnReceipt UseTypeahead WaitTime	ClearError EnableSpeedLoader GetAttachmentInfo GetDataToSynch GetEmailSystem GetLastError GetSynchUpdateInfo SetAttachmentInfo SetDataToSynch SetEmailSystem SetSynchScheduleInfo SetSynchUpdateInfo
TaskListView		AddNewActivityEx
Views		ClearError GetLastError

Object	New Properties	New Methods
Common properties and methods	ViewState	CurrentFieldId CurrentRecord GetMode HasRecordChanged LookupKeyword
Application	ActVersion	RemoveOutlookActivities UpdateOutlookActivities
ContactView	¾	CompleteSale CreateLookup CreateSalesForecast DeleteContactFast Sales TriggerActivitySeries
EmailView	¾	GetOpenFolderMessageCount Sort
GroupView	¾	AddNewSubGroup ChangeToParentGroup ChangeToSubGroup Collapse DeleteGroupFast Expand GetSubGroupCount GroupType IsExpanded
MailComposeView	¾	AddBccRecepient AddCcRecepient
Preferences	ShowContactParsingDialog	GetDBMaintReminderInfo SetDBMaintReminderInfo
Views	¾	CreateEx

Object	Modified Methods	Change
ContactView	GetActiveGroup GrtCurrentID	For versions of ACT! prior to ACT! 2000 version 5.0.2, these methods activate the Contact View upon return. For ACT! 2000 version 5.0.2 or later, these methods do not activate the Contact View.

Object	New Methods
Views	CreateBrowserView CreateBrowserViewFromUrl GetViewEx

Object	Modified Methods (documentation only)	Change
ContactView	AddRecepient AddCcRecepient AddBccRecepient ClearRecepients	Syntax corrected. Note: Use the exact specified spelling.

CHAPTER

Using Application Object Properties and Methods

This chapter contains descriptions of the different properties and methods that apply to the various ACT! OLE Application objects. The chapter is divided into sections devoted to the following ACT! Application Object properties and methods:

· Common properties and methods applying to more than one object

· Application object properties and methods

· CalendarView object methods

· ContactListView object methods

· ContactView object methods

· EmailView object methods

· ExplorerView object methods

· Grid object methods

· GroupView object methods

· MailComposeView object methods

· Preferences object properties and methods

· TaskListView object methods

· Views object property and methods

The descriptions for each object include one table of properties and one of methods (if applicable), followed by alphabetical descriptions of the combined properties and methods. The descriptions supply details and, in some cases, examples. Cross references are also given to other properties or methods in the same or another object. Where possible, the descriptions include error codes (in the heading GetLastError) that can be returned. Use the GetLastError method (described in “Common properties and methods”) to get the last error code for the object. Methods with a long integer or short integer return type return S_OK on success.

Common properties and methods

The following common properties and methods apply to the CalendarView, ContactListView, ContactView, EmailView, ExplorerView, GroupView, MailComposeView, and TaskListView objects.

Properties

Property name	Parameter(s)	Parameter type(s)	Value type	Access
Active	None	¾	Boolean	Read Only
Caption	[=szTitleBar]	String/BSTR	String/BSTR	Read/Write
Displayed	None	¾	Boolean	Read Only
Name	[=szName]	String/BSTR	String/BSTR	Read/Write
Type	None	¾	Long Integer	Read Only
ViewState	None	¾	Short Integer	Read/Write

Methods

Method name	Parameter(s)	Parameter type(s)	Return type
Activate	None	¾	Boolean
Application	None	¾	Object/LPDISPATCH
ClearError	None	¾	Void
Close	None	¾	Long Integer
CurrentFieldId	None	¾	Short Integer
CurrentRecord	None	¾	Long Integer
GetLastError	None	¾	Long Integer
GetMode	None	¾	Short Integer
HasRecordChanged	None	¾	Boolean
LookupKeyword	szKeyword, lTables, iLookupType, szGroupName	String, Long Integer, Short Integer, String	Void
Maximize	None	¾	Boolean
Minimize	None	¾	Boolean
Parent	None	¾	Object/LPDISPATCH
ReSize	iHeight, iWidth	Short Integer, Short Integer	Long Integer
Show	True\|False	Boolean	Long Integer
Update	None	¾	Long Integer

Activate Method

Description Activates the view by bringing it to the foreground. Returns True on success or False on failure.

Objects CalendarView, ContactListView, ContactView, EmailView, ExplorerView, GroupView, MailComposeView, TaskListView

Syntax object.Activate

Return type Boolean

GetLastError S_VW_NOT_FOUND

Value	Mode	Value	Mode
0	None (for example, when a dialog box is open)	3	Query
1	Data Entry/Browse	4	Replace Fields
2	Layout

Value	Table	Value	Table
1	Contact	8	Email
2	Activity	16	Groups
4	NoteHistory	32	Sales

Value	Type		Value	Type
0	All Records		2	Current Lookup
1	Current Record		3	Selected Group

Value	State	Value	State
1	Contact view	5	Calendar view
2	Contact List view	6	E-mail inbox view
3	Group view	7	Explorer view
4	Task List view

Value	State		Value	State
1	Normal		3	Minimized
2	Maximized		4	Hidden

Application object properties and methods

The Application object provides functions to externally control the ACT! application. The following properties and methods apply only to the Application object. See “Common properties and methods” in this section for properties and additional methods that apply to the ContactView object.

Properties

Property name	Parameter(s)	Parameter type(s)	Value type	Access
ActVersion	None	¾	String	Read Only
Caption	[= szTitleBar]	String/BSTR	String/BSTR	Read/Write
LastContactListModTime	None	¾	Long Integer	Read Only

Methods

Method name	Parameter(s)	Parameter type(s)	Return type
AddUser	szUserName, szPassword, iPrivilege	String, String, Short Integer	Long Integer
BackupDB	szZipFileFullPath, iItems, iMode	String, Short Integer, Short Integer	Long Integer
ChangePassword	szUserName, szOldPassword, szNewPassword	String, String, String	Long Integer
ClearError	None	¾	Void
CloseDB	None	¾	Long Integer
Command	iCommandID	Short Integer	Long Integer
CompressDB	szDBName	String	Long Integer
GetActiveDB	None	¾	Object/LPDISPATCH
GetAppName	None	¾	String/BSTR
GetAppPath	None	¾	String/BSTR
GetCurrentUserName	None	¾	String/BSTR
GetLastError	None	¾	Long Integer
GetOpenDBName	None	¾	String/BSTR
GetPosition	lXPos, lYPos	Long Integer, Long Integer	Long Integer
GetSize	lWidth, lHeight	Long Integer, Long Integer	Long Integer
GetUserId	None	¾	String/BSTR
GetUserPrivilege	None	¾	Long Integer
GetVersion	iFor	Short Integer	String/BSTR
Help	[szHelpFile, lContextID]	String, Long Integer	Long Integer
IsDBOpen	None	¾	Boolean
IsVisible	None	¾	Boolean
Maximize	None	¾	Long Integer
Minimize	None	¾	Long Integer
OpenDB	szDBName	String	Object/LPDISPATCH
OpenFile	szDBName	String	Long Integer
Preferences	None	¾	Object/LPDISPATCH
ProcessFile	szFilename, lReserved	String, Long Integer	Long Integer
PurgeHistories	szDBName	String	Long Integer
PurgeNotes	szDBName	String	Long Integer
PurgeTransactions	szDBName	String	Long Integer
ReIndexDB	szDBName	String	Long Integer
RemoveOutlookActivities	iRemoveIn	Short Integer	Long Integer
ReSize	iHeight, iWidth	Short Integer, Short Integer	Long Integer
RestoreDB	szSourceZipFile, szDestinationPath, iMode	String, String, Short Integer	Long Integer
RunMacro	szMacroName	String	Long Integer
SaveCurrentLookup	szFilename	String	Long Integer
SendKey	lParam1, lParam2, lParam3	Long Integer, Long Integer, Long Integer	Long Integer
Show	True\|False	Boolean	Long Integer
Update	None	¾	Long Integer
UpdateOutlookActivities	iUpdateDirection, iDurationType	Short Integer, Short Integer	Long Integer
Views	None	¾	Object/LPDISPATCH

ActVersion Property (requires ACT! 2000 or later)

Description Returns a string that contains the version of the ACT! application. An example of a returned string is 5.0.0.175, where 5.0.0 is the version of ACT! (ACT! 2000) and 175 is the number of the build.

Object Application

Syntax object.ActVersion

Value type String, Read Only

AddUser Method

Description Adds a user with the specified password and security level to the open database, but does not verify that a My Record exists for the user. The database should not be open by the ACT! application or by another instance of OLE. The current user must have Administrator security level to add new users. Returns S_ERROR on failure.

Object Application

Syntax object.AddUser(szUserName, szPassword, iPrivilege)

Parameters szUserName A string representing the user name of the new user.

szPassword A string representing the password for the new user.

iPrivilege A short integer representing the privilege (security level) of the new user.

Following is a list of the values for the iPrivilege parameter:

Value	Security level	Value	Security level
0	Browse	2	Administrator
1	Standard

Return type Long Integer

GetLastError S_NO_DB, S_NO_SECURITY, S_NO_USER, S_NOT_PRIVILEGED, S_CREATE_NEWUSER

Value	Item		Value	Item
1	Reports		4	Envelopes
2	Labels		8	Layouts

Value	Activities
1	Removes Outlook activities from ACT!
2	Removes ACT! activities from Outlook
3	Removes Outlook activities from ACT! and removes ACT! activities from Outlook

Value	Direction
1	From ACT! to Outlook
2	From Outlook to ACT!
3	Both

Value	Duration
1	All days
2	Today
3	Today and in the future
4	Over the next 30 days

CalendarView object methods

The CalendarView object provides an interface to use the Calendar view in the ACT! application. The following properties and methods apply only to the CalendarView object. See “Common properties and methods” for properties and additional methods that apply to the CalendarView object.

Methods

Method name	Parameter(s)	Parameter type(s)	Return type
GetActiveMonth	None	¾	Short Integer
GetCalendarMode	None	¾	Short Integer
SetActiveMonth	iMonth	Short Integer	Long Integer
SetCalendarMode	iMode	Short Integer	Long Integer

The following sample code demonstrates how to use the CalendarView object:

Dim objApp as object

Dim objViews as object

Dim objCal as object

Dim i as long

'Initialize the Application object.

'This starts ACT! if it is not already running.

Set objApp = CreateObject("ACTOLE.APPOBJECT")

'Open the database.

objApp.OpenFile C:\My Documents\ACT\Database\ACT5demo.dbf

'Create a Views object.

Set objViews = App.Views

'Create the Calendar object.

Set objCal = objViews.Create(5, "MyCal")

'If the Calendar Active month is not April, then set it to April.

If objCal.GetActiveMonth <> 4 Then

objCal.SetActiveMonth (4)

End If

'If the Calendar is not weekly, then set it to weekly.

If objCal.GetCalendarMode <> 301 Then

objCal.SetCalendarMode (301)

End If

objViews.CloseAll

Set objCal = Nothing

Set objViews = Nothing

'Close the Application object.

Set objApp = Nothing

GetActiveMonth Method

Description Returns the month between 1 and 12 indicating the active in the calendar view. Returns 0 (zero) on error.

Object CalendarView

Syntax object.GetActiveMonth

Return type Short Integer

GetLastError S_NO_CALVW

Value	Mode		Value	Mode
300	Monthly		302	Daily
301	Weekly

ContactListView object methods

The ContactListView object provides an interface to use the Contact List view in the ACT! application. The following methods apply only to the ContactListView object. See “Common properties and methods” for properties and additional methods that apply to the ContactListView object.

Method

Method name	Parameter(s)	Parameter type(s)	Return type
AddNewContactEx	None	¾	String/BSTR
GetGrid	None	¾	Object/LPDISPATCH

AddNewContact Method (obsolete)

Use AddNewContactEx instead of this method.

AddNewContactEx Method (requires ACT! 4.0 or later)

Description Adds a new contact to the database. Use SetField in the Grid object to set the fields in the newly created row. Returns the Unique ID of the new contact. Use GetRowNumber in the Grid object to find the row number of the new contact.

Object ContactListView

Syntax object.AddNewContactEx

Return type String/BSTR

Comments The new contact appears as the first visible row in the Contact List view. The Contact List view is activated after a call to this method.

See also AddNewContact
GetField, GetRowNumber, SetField, in Grid object

Example 'This example adds a new contact in the Contact List view.

Dim objCtListView As Object

Dim objCtView As Object

Dim objCtListGrid As Object

Dim RN As Integer

Dim objV As Object

Dim uid As String

Dim objApp As Object

'Initialize the Application object.

'This starts ACT! if it is not already running.

Set objApp = CreateObject("ACTOLE.APPOBJECT")

'Open the database.

objApp.OpenDB C:\My Documents\ACT\Database\ACT5demo.dbf

'Create the Views object.

Set objViews = objApp.Views

'Create the Contact List view.

Set objCtListView = objViews.Create(2, "CL")

'Create the Grid object.

Set objCtListGrid = objCtListView.GetGrid

'Add a new Contact record and get the Unique ID.

uid = objCtListView.AddNewContactEx

'Get the row number.

RN = objCtListGrid.GetRowNumber(uid)

'Populate the fields.

objCtListGrid.SetField CF_Name, RN, "Carl Bowman"

RN = objCtListGrid.GetRowNumber(uid)

objCtListGrid.SetField CF_Company, RN, "Cordoba Coffee Shops"

RN = objCtListGrid.GetRowNumber(uid)

objCtListGrid.SetField CF_Phone, RN, "415-555-1212"

RN = objCtListGrid.GetRowNumber(uid)

objCtListGrid.SetField CF_Title, RN, "Engineer"

Set objCtListGrid = Nothing

'Close the Contact List view.

objCtListView.Close

Set objCtListView = Nothing

Set objViews = Nothing

'Close the Application object.

Set objApp = Nothing

GetGrid Method

Description Returns a dispatch pointer to a grid object for the Contact List view. The returned dispatch pointer can be used to manipulate the grid object. Returns NULL on error.

Object ContactListView

Syntax object.GetGrid

Return type Object/LPDISPATCH

GetLastError S_ERROR

Example 'This example returns a dispatch pointer.

Dim objApp as object

Dim objViews as object

Dim objContactListView as object

Dim objContactListViewGrid as object

'Initialize the Application object.

'This starts ACT! if it is not already running.

Set objApp = CreateObject("ACTOLE.APPOBJECT")

'Open the database.

objApp.OpenFile C:\My Documents\ACT\Database\ACT5demo.dbf

'Initialize the Views object.

Set objViews = objApp.Views

List1.AddItem objApp.GetLastError

Set objCtListView = objViews.Create(2, "CL")

'Get the Grid Object in the Contact List.

Set objCtListGrid = objCtListView.GetGrid

'List the contact name and company for all the contacts in the Contact List.

For i = 0 To objCtListGrid.GetRowCount - 1

List1.AddItem objCtListGrid.GetField(CF_Name, i) & " , " &

objCtListGrid.GetField(CF_Company, i)

Next i

Set objCtListGrid = Nothing

objCtListView.Close

Set objCtListView = Nothing

Set objViews = Nothing

Set objApp = Nothing

ContactView object methods

The ContactView object provides an interface to use the Contact view in the ACT! application. The following methods apply only to the ContactView object. See “Common properties and methods” for properties and additional methods that apply to the ContactView object.

Methods

Method name	Parameter(s)	Parameter type(s)	Return type
Activities	None	¾	Object/LPDISPATCH
AddContactToGroup	szGroupID	String	Long Integer
AddNewActivityEx	szContactID…, szDateTime, iType, iTimeless, szRegarding, lDuration	String, String, Short Integer, Short Integer, String, Long Integer	String/BSTR
AddNewContact	None	¾	Long Integer
AddNoteHistoryEx	iType	Short Integer	String/BSTR
AttachFile	szFilename	String	Long Integer
BOL	None	¾	Boolean
CompleteSale	szSaleID, iStatus, dateClosed, szReason, lUnits, fUnitPrice, fAmount	String Short Integer Date String Long Integer Float (Single) Float (Single)	Long Integer
CreateLookup	szContact…	String	Long Integer
CreateSalesForecast	szContactID, szProductID, szType, szCompetitor, lUnits, fUnitPrice, fAmount, dateClose, lProb	String, String, String, String , Long Integer, Float (Single), Float (Single), Date, Long Integer	String
Delete	None	¾	Long Integer
DeleteContactFast	None	¾	Long Integer
EOL	None	¾	Boolean
GetActiveGroup	None	¾	String/BSTR
GetActiveGroupName	None	¾	String/BSTR
GetActiveTab	None	¾	String/BSTR
GetCount	None	¾	Short Integer
GetCurrentID	None	¾	String/BSTR
GetField	lFieldID	Long Integer	String/BSTR
GetTabCount	None	¾	Short Integer
GetTabName	iTabNo	Short Integer	String/BSTR
Goto	szContactID	String	Long Integer
GroupMembership	None	¾	Object/LPDISPATCH
LookupAll	None	¾	Long Integer
LookupFieldEx	lFieldID, szFieldValue, iType	Long Integer, String, Short Integer	Long Integer
LookupMyRecord	None	¾	Long Integer
LookupPrevious	None	¾	Long Integer
MoveFirst	None	¾	Long Integer
MoveLast	None	¾	Long Integer
MoveNext	None	¾	Long Integer
Moveprevious	None	¾	Long Integer
NewContactDialog	None	¾	Long Integer
NotesHistory	None	¾	Object/LPDISPATCH
RunQuery	szQueryFile	String	Long Integer
Sales	None	¾	Object/LPDISPATCH
SaveQuery	szQueryFile	String	Long Integer
SelectContactDlg	szText	String	String/BSTR
SetActiveGroup	szGroupID	String	Long Integer
SetActiveGroupName	szGroupName	String	Long Integer
SetActiveTab	szTabName	String	Long Integer
SetField	lFieldID, szFieldValue	Long Integer, String	Long Integer
TriggerActivitySeries	iLookupType, SeriesDate, szActivitySeriesName	Short Integer, Date, String	Long Integer

Activities Method

Description Returns a dispatch pointer to a Grid object for the Activities tab. The Activities tab must be the active tab before calling this method. Returns NULL on error.

Object ContactView

Syntax object.Activities

Return type Object/LPDISPATCH

GetLastError S_MEM_ERROR, S_NO_DALLIST_VIEW, S_UNKNOWN

See also GetActiveTab, NotesHistory, SetActiveTab

AddContactToGroup Method

Description Adds the current contact to the specified group. If the function is successful, the specified group appears in the Groups tab of the Contact view. If the contact is currently a member of the specified group or the Unique ID is invalid, this method fails. Returns S_ERROR on failure.

Object ContactView

Syntax object.AddContactToGroup(szGroupID)

Parameters szGroupID A string representing the Unique ID of the group.

Return type Long Integer

GetLastError S_ADD_CONTACT, S_DUPLICATE_GRP, S_INVALID_INPUT, S_UNKNOWN

See also AddMembersToGroup in GroupView object

Example 'This example adds the current contact to the group with the ID GroupID.

Dim objApp as object

Dim objViews as object

Dim objContact as object

'Initialize the Application object.

'This starts ACT! if it is not already running.

Set objApp = CreateObject("ACTOLE.APPOBJECT")

'Open the database.

objApp.OpenFile C:\My Documents\ACT\Database\ACT5demo.dbf

'Create a Views object.

Set objViews = objApp.Views

'Create the ContactView object.

Set objContact = objViews.Create(1, "MyContact")

'Set Groups to be the active tab.

objContact.SetActiveTab "Groups"

'Add the current contact in the Contact view to the group

'with the Unique ID GroupID.

objCView.AddContactToGroup GroupId

'Close the Contact view.

objContact.Close

Set objContact = Nothing

Set objViews = Nothing

'Close the Application object.

Set objApp = Nothing

AddNewActivity Method (obsolete)

Use AddNewActivityEx instead of this method.

AddNewActivityEx Method (requires ACT! 4.0 or later)

Description Adds a new activity for the specified contacts using Activity defaults set in Preferences. Returns the Unique ID of the new activity on success and NULL on failure. If any ID in szContactID is invalid, this method returns S_OK, but GetLastError returns S_INVALID_INPUT. Use GetFilter and SetFilter in the Grid object before using this method.

Object ContactView

Syntax object.AddNewActivityEx(szContactID…, szDateTime, iType, iTimeless, szRegarding, lDuration)

Parameters szContactID A string representing the Unique ID(s) of contacts with which the new activity will be associated. If a NULL value is specified for this required parameter, the new activity will be associated with the default of the current database user.

Note: Specify multiple Unique IDs as a continuous string of 12‑character values, with no delimiters between the Unique ID values.

szDateTime A string representing the starting date and time of the activity, formatted in Windows Regional Settings Short Date style and Time style.

iType A short integer representing the type of activity to be added.

The following table lists the values for this parameter.

Value	Setting	Value	Setting
0	Call	2	To-do
1	Meeting

iTimeless A short integer representing the timeless status of the activity to be added.

The following table lists the values for this parameter.

Value	Setting
0	Not timeless
1	Timeless

szRegarding A string representing the description of the activity.

lDuration A long integer representing the duration in minutes of the activity.

Return type String/BSTR

GetLastError S_ACTIVITY_INIT_FAIL, S_CON_DOC, S_HELPER_EEDIT_FAIL, S_INVALID_INPUT, S_PROPS_NOT_FOUND, S_UNKNOWN

Example 'This example adds a high priority to-do to the current contact, dated '10/20/98, at 10:00 AM, duration 45 minutes, regarding "A Meeting".

'Initialize the application object.

Set objApp = CreateObject("ACTOLE.APPOBJECT")

'Create the Views object.

Set objViews = objApp.Views

'Create the Contacts view.

Set objCView = objViews.Create(1, "CV")

'Get the Unique ID of the current contact.

sContact = objCView.GetCurrentID

'Set Activities to be the Active Tab

objCView.SetActiveTab "Activities"

'Create the Grid object.

Set objActiv = objCView.Activities

'Get Activities filter values.

objActiv.GetFilter x, y, z

j = 1 or 2 or 4 or 8 or 16 or 32 or 64 or 128

objActiv.SetFilter j, 1, " "

'Add an activity. Its Unique ID is returned in uid as a string.

uid = objCView.AddNewActivityEx(sContact, "10/20/98 10:00AM",

activitytype_meeting,0,"A meeting", "45")

'Get the row number.

RN = objActiv.GetRowNumber(uid)

'Set other parameters in the activity.

objActiv.SetField AF_Priority, RN, activitypriority_medium

'Reset the Activities filter values.

objActiv.SetFilter x, y, z

Set objActiv = Nothing

Set objCView = Nothing

AddNewContact Method

Description Displays a new contact with all fields blank. Use SetField to populate the contact fields.

Object ContactView

Syntax object.AddNewContact

Return type Long Integer

GetLastError S_UNKNOWN

Value	Setting	Value	Setting
0	Call attempted	7	Meeting not held
1	Call completed	8	To-do done
2	Call received	9	To-do not done
6	Meeting held	17	Left message

Value	Status		Value	Status
0	Open		2	Lost
1	Won

Value	Setting
0	Add to the current lookup
1	Narrow the current lookup
n	Specify any other number to replace the current lookup

See also GetField

Example See AddNewContact.

TriggerActivitySeries Method (requires ACT! 2000 or later)

Description Runs the specified activity series. Returns 0 if successful or an error code if unsuccessful. For a list of error codes, see the following chapter.

Object ContactView

Syntax object.TriggerActivitySeries (iLookupType, SeriesDate, szActivitySeriesName)

Parameters iLookupType A short integer representing the lookup type.

The following table lists the values for this parameter:

Value	Type	Value	Type
0	All records	2	Current Lookup
1	Current record	3	Selected Group

SeriesDate A date representing the start date or due date for the activity series, formatted in Windows Regional Settings Short Date style.

szActivitySeriesName A string specifying the file name and path for the activity series. Activity series files are stored in \ACT\Macro. The file extension must be .SER.

Return type Long Integer

Example 'This example code schedules the "Test.ser" series with the current lookup

'and a start date of 9/11/99.

Set objViews = objApp.Views

Set objContactView = objViews.Create(1, "CL")

ret = objContactView.TriggerActivitySeries(1, "9/11/99",

"c:\Program Files\ACT\Macro\Test.ser")

Set objContactView = Nothing

EmailView object methods

The EmailView object provides an interface to use the E-mail Inbox view in the ACT! application. The following methods apply only to the EmailView object. See “Common properties and methods” for properties and additional methods that apply to the EmailView object.

Methods

Method name	Parameter(s)	Parameter type(s)	Return type
GetActiveInbox	None	¾	String/BSTR
GetInboxCount	None	¾	Short Integer
GetInboxName	iInbox	Short Integer	String/BSTR
GetOpenFolderMessageCount	None	¾	Short Integer
MsgComposeView	None	¾	Object/LPDISPATCH
OpenInbox	szName	String	Long Integer
SetActiveInbox	szName	String	Long Integer
Sort	iColumn, True\|False	Short Integer, Boolean	Long Integer

GetActiveInbox Method

Description Returns the name of the currently active inbox in the E-mail view. The name returned is exactly as it appears on the view. Returns NULL on error.

Object EmailView

Syntax object.GetActiveInbox

Return type String/BSTR

GetLastError S_GET_SELECTION_FAIL, S_NO_EMAIL

ExplorerView object methods

The ExplorerView object provides an interface to use an Explorer view that was added to the ACT! application using the Adding Extensible Views and Tabs to ACT! component of the ACT! SDK. The following methods apply only to the ExplorerView object. See “Common properties and methods” for properties and additional methods that apply to the ExplorerView object.

Methods

Method name	Parameter(s)	Parameter type(s)	Return type
GetStartupURL	None	¾	String/BSTR
GetURL	None	¾	String/BSTR
GoBack	None	¾	Long Integer
GoForward	None	¾	Long Integer
Refresh	None	¾	Long Integer
SetURL	szURL	String	Long Integer
Stop	None	¾	Long Integer

The following sample Visual Basic code demonstrates how to use the ExplorerView object:

'A simple example demonstrating the use of the various methods.

Dim ExplView As object

'Get the Views object

Set objViews = objApp.Views

'Load the Floating View (7), which has MyWebSite as the title.

Set ExplView = objViews.FindExplorerView("MyWebSite", 7)

If objViews.GetLastError <> 0 Then

MsgBox "Error loading the floating Explorer View, exiting"

objViews.ClearError

Exit Sub

End If

List1.AddItem "View Type : (Should be 7)" & ExplView.Type

'Get the address currently open.

List1.AddItem "Get URL :" & ExplView.GetURL

'Load the URL www.actsoftware.com.

ExplView.SetURL "www.actsoftware.com"

ExplView.Close

Set ExplView = Nothing

Set objViews = Nothing

GetStartupURL Method

Description Returns the URL that the Explorer uses when it is launched.

Object ExplorerView

Syntax object.GetStartupURL

Return type String/BSTR

Grid object methods

The Grid object provides an interface to use the Grid view in the ACT! application. The following methods apply only to the Grid object.

Methods

Method name	Parameter(s)	Parameter type(s)	Return type
BOL	None	¾	Boolean
DeleteRow	lRowNo	Long Integer	Long Integer
EOL	None	¾	Boolean
GetColumnCount	None	¾	Long Integer
GetColumnID	lColNo	Long Integer	Long Integer
GetColumnName	lColNo	Long Integer	String/BSTR
GetCurrentRow	None	¾	Long Integer
GetField	lFieldID, lRowNo	Long Integer, Long Integer	String/BSTR
GetFilter	lFilters, vDate, vUserID	Long Integer, Variant, Variant	Long Integer
GetLastError	None	¾	Long Integer
GetRowCount	None	¾	Long Integer
GetRowNumber	szUniqueID	String	Long Integer
GetUniqueID	lRowNo	Long Integer	String/BSTR
Goto	lRowNo	Long Integer	Long Integer
MoveFirst	None	¾	Long Integer
MoveLast	None	¾	Long Integer
MoveNext	None	¾	Long Integer
Moveprevious	None	¾	Long Integer
RefreshGrid	None	¾	Long Integer
SelectRow	lRowNo, bReserved	Long Integer, Boolean	Long Integer
SetField	lFieldID, lRowNo, szFieldValue	Long Integer, Long Integer, String	Long Integer
SetFilter	lFilters, szDate, szUserID…	Long Integer String, String	Long Integer
Sort	lFieldID, True\|False	Long Integer, Boolean	Long Integer

BOL Method

Description Returns True if the current record is the first in the grid or False if it is not the first in the grid or on error.

Object Grid

Syntax object.BOL

Return type Boolean

GetLastError S_NO_DALLIST_VIEW, -2

See also EOL, Goto, MoveFirst, MoveLast, MoveNext, Moveprevious

Example Dim objApp as object

Dim objContactListView as object

Dim objContactListGrid as object

'Initialize the Application object.

'This starts ACT! if it is not already running.

Set objApp = CreateObject("ACTOLE.APPOBJECT")

'Open the database.

objApp.OpenFile C:\My Documents\ACT\Database\ACT5demo.dbf

Set objViews = objApp.Views

'Create the Contact List view.

Set objContactListView = objViews.Create(2, "CL")

'Create the Grid object for the Contact List.

Set objContactListGrid = objContactListView.GetGrid

If objContactListGrid.BOL <> True Then

objContactListGrid.MoveFirst

Else

MsgBox "Beginning of List"

End If

Set objContacttListGrid = Nothing

objContacttListView.Close

Set objCtListView = Nothing

Set objViews = Nothing

'Close the Application object.

Set objApp = Nothing

DeleteRow Method

Description Deletes the specified record from the grid and table. Use the SelectRow method or go to the row to be deleted before using this method. This method cannot be used on Grid object for Group Membership tab (Contact view) or Contact tab (Group view). Returns S_ERROR on failure.

Object Grid

Syntax object.DeleteRow(lRowNo)

Parameters lRowNo A long integer representing the row of the record to be deleted, in the range between 0 (zero) and one less than the value of the row count.

Return type Long Integer

GetLastError S_DELETE_FAIL, S_DELETE_NOTALLOWED, S_INVALID_INPUT, S_NO_DALLIST_VIEW, -2

Value	Option selected	Value	Option selected
1	Show data for All Users	8	Show Attachments
2	Show Notes	16	Show E-mail (requires ACT! 2000 or later)
4	Show Histories

Value	Option selected	Value	Option selected
1	Show data for All Users	32	Show High priority activities
2	Show Cleared Activities	64	Show Medium priority activities
4	Show Calls	128	Show Low priority activities
8	Show Meetings	256	Show Only Timeless activities
16	Show To-do’s	512	Show Outlook activities (requires ACT! 2000 or later and Outlook)

Value	Option selected	Value	Option selected
1	Show All	4	Show Today
2	Show Past	5	Show Tomorrow (not supported)
3	Show Today And Future	6	Show Date Range

See also GetField

Example See AddNewActivityEx in ContactView and TaskListView objects, AddNoteHistory in ContactView object, AddNote in GroupView object, AddNewContactEx in ContactListView object.

SetFilter Method (requires ACT! 4.0 or later)

Description Sets the filters on the Notes/History or Activities tab of the Contacts or Groups view, or the Task List view. This should be done before adding records into the grid. This method is recommended to avoid incorrect information getting added to newly added Notes/History and Activity records. Returns S_ERROR on failure.

Object Grid

Syntax object.SetFilter(lFilters, szDate, szUserID…)

Parameters lFilters A long integer obtained by ORing 0 with the values for filters on the Notes/History tab, Activities tab, or Task List view that you want selected.

The following table lists the values that are included in the total for lFilters for the Notes/History tab.

Value	Option selected	Value	Option selected
1	Show data for All Users	8	Show Attachments
2	Show Notes	16	Show E-mail (requires ACT! 2000)
4	Show Histories

The following table lists the values that are included in the total for lFilters for the Activities tab or the Task List view.

Value	Option selected	Value	Option selected
1	Show data for All Users	32	Show High priority activities
2	Show Cleared Activities	64	Show Medium priority activities
4	Show Calls	128	Show Low priority activities
8	Show Meetings	256	Show Only Timeless activities
16	Show To-do’s	512	Show Outlook activities (requires ACT! 2000 or later and Outlook)

szDate A string representing the dates for the items to be filtered, specified in the format:

Type\StartDate\EndDate

The following table lists values for the Type field. For types 1 to 5 the StartDate and EndDate fields are omitted. For type 6, specify the StartDate and EndDate in mm/dd/yy format.

Value	Option selected	Value	Option selected
1	Show All	4	Show Today
2	Show Past	5	Show Tomorrow (not supported)
3	Show Today And Future	6	Show Date Range

szUserID A string representing the Unique ID(s) of users specified for the filter. Specify szUserID in the following format:

ID1\ID2\ID3…

Note: Specify multiple Unique IDs as a continuous string of 12‑character values, with no delimiters between the Unique ID values.

Return type Long Integer

GetLastError S_INVALID_INPUT, S_NO_DALLIST_VIEW

See also GetField

Example See GetFilter

Sort Method

Description Sorts the display grid by the specified column.

Object Grid

Syntax object.Sort(lFieldID, True|False)

Parameters lFieldID A long integer representing the field ID of the column in the grid to be used for the sort. See the ACT! Database File Formats Reference appendix for lists of field IDs and names (Field constants).

True|False Specify True to sort the specified column in descending order or False to sort it in ascending order.

Return type Long Integer

GetLastError S_BUILD_ERROR, S_NO_DALLIST_VIEW, S_NO_SCHEMA, S_NOT_SORTABLE, -2

Example See AddNewActivityEx in TaskListView object.

GroupView object methods

The GroupView object provides an interface to use the Group view in the ACT! application. The following methods apply only to the GroupView object. See “Common properties and methods” for properties and additional methods that apply to the GroupView object.

Methods

Method name	Parameter(s)	Parameter type(s)	Return type
Activities	None	¾	Object/LPDISPATCH
AddMemberToGroup	szContactID	String	Long Integer
AddNew	None	¾	Long Integer
AddNewSubGroup	szUniqueID	String	Long Integer
AddNoteEx	None	¾	String/BSTR
AttachFile	szFilename	String	String/BSTR
BOL	None	¾	Boolean
ChangeToParentGroup	None	¾	Long Integer
ChangeToSubGroup	szUniqueID	String	Long Integer
Collapse	None	¾	Long Integer
ContactMembers	None	¾	Object/LPDISPATCH
Delete	None	¾	Long Integer
DeleteGroupFast	None	¾	Long Integer
EOL	None	¾	Boolean
Expand	None	¾	Long Integer
GetActiveTab	None	¾	String/BSTR
GetCount	None	¾	Short Integer
GetCurrentID	None	¾	String/BSTR
GetField	lFieldID	Long Integer	String/BSTR
GetSubGroupCount	None	¾	Long Integer
GetTabCount	None	¾	Short Integer
GetTabName	iTabNo	Short Integer	String/BSTR
Goto	szGroupID	String	Long Integer
GroupType	None	¾	Short Integer
IsExpanded	None	¾	Boolean
LookupAll	None	¾	Long Integer
LookupFieldEx	lFieldID, szFieldValue, iType	Long Integer, String, Short Integer	Long Integer
LookupPrevious	None	¾	Long Integer
MoveFirst	None	¾	Long Integer
MoveLast	None	¾	Long Integer
MoveNext	None	¾	Long Integer
Moveprevious	None	¾	Long Integer
NotesHistory	None	¾	Object/LPDISPATCH
RunQuery	szQueryFile	String	Long Integer
SaveQuery	szQueryFile	String	Long Integer
SetActiveTab	szTabName	String	Long Integer
SetField	lFieldID, szFieldValue	Long Integer, String	Long Integer

Activities Method

Description Returns a dispatch pointer to a Grid object for the Activities tab. It does not make the Activities tab the active tab. The Activities tab must be the active tab before calling this method. Returns NULL on error.

Object GroupView

Syntax object.Activities

Return type Object/LPDISPATCH

GetLastError S_NO_DALLIST_VIEW, S_MEM_ERROR, S_CON_DOC, S_FRM_VW_SYS

See also GetActiveTab, NotesHistory, SetActiveTab

Example 'This example opens the Activities tab and returns the

'number of activities for the group.

Dim objGrp as object

Dim objActivities as object

Dim objContacts as object

Set objViews = objApp.Views

'Open the database.

objApp.OpenFile C:\My Documents\ACT\Database\ACT5demo.dbf

Set objGrp = objViews.Create(3, "Group")

'Set Activities to be the active tab.

objGrp.SetActiveTab "Activities"

objGrp.MoveFirst

Set objActivities = objGrp.Activities

'Print the row count, which is the same as the number of

'activities for the first group.

List1.AddItem "This group has " & objActivities.GetRowCount & " activities"

Set objActivities = Nothing

objGrp.Close

Set objGrp = Nothing

'Close the application.

Set objActivities = Nothing

Set objApp = Nothing

AddMemberToGroup Method

Description Makes the specified contact as a member of the current group. The specified contact will appear in the Contacts tab of the Group view. This function fails if the specified contact is an existing member of the current group. Returns S_ERROR on failure.

Object GroupView

Syntax object.AddMemberToGroup(szContactID)

Parameters szContactID A string representing the ID of the contact to be added.

Return type Long Integer

GetLastError S_INVALID_ID, S_ADD_CONTACT, S_DUPLICATE_CONTACT

See also AddContactToGroup in ContactView object

Example 'This example adds sContact to the current group.

Dim objApp as object

Dim objGrp as object

Dim objGrid as object

Dim sContact as string

'Initialize the Application object.

'This starts ACT! if it is not already running.

Set objApp = CreateObject("ACTOLE.APPOBJECT")

'Open the database.

objApp.OpenFile C:\My Documents\ACT\Database\ACT5demo.dbf

'Create a Group view.

Set objViews = objApp.Views

Set objGrp = objViews.Create(3, "Group")

'Set the active tab to Contacts.

objGrp.SetActiveTab "Contacts"

Set objGrid = objGrp.ContactMembers

objGrp.AddMemberToGroup (sContact)

objGrp.Close

Set objGrp = Nothing

'Close the Application object.

Set objApp = Nothing

AddNew Method

Description Displays a new group with all fields blank. Return S_ERROR on failure.

Object GroupView

Syntax object.AddNew

Return type Long Integer

GetLastError S_MAIN_WND

Value	Setting
0	Add to the current lookup
1	Narrow the current lookup
n	Specify any other number to replace the current lookup

See also GetField

Example 'This example goes to a specific group by its group ID and

'sets the address fields.

Dim objApp as object

Dim objViews as object

Dim objGroup as object

'Initialize the Application object.

'This starts ACT! if it is not already running.

Set objApp = CreateObject("ACTOLE.APPOBJECT")

'Open the database.

objApp.OpenFile C:\My Documents\ACT\Database\ACT5demo.dbf

'Create a Views object.

Set objViews = App.Views

'Create the GroupView object. This brings up the Group view.

Set objGroup = objViews.Create(3, "MyGroup")

'Go to the Group with group Unique ID of GUID.

objGrp.Goto GUID

'Set the Address, City, State, and Zip fields.

objGrp.SetField GF_Address1, "20300 Stevens Creek Blvd"

objGrp.SetField GF_City, "Cupertino"

objGrp.SetField GF_State, "CA"

objGrp.SetField GF_Zip, "95014"

'Close the Group view.

objGroup.Close

objViews.CloseAll

Set objGroup = Nothing

Set objViews = Nothing

'Close the Application object.

Set objApp = Nothing

MailComposeView object methods

The MailComposeView object provides an interface to use the E-mail Compose view in the ACT! application. The following methods apply only to the MailComposeView object. See “Common properties and methods” for properties and additional methods that apply to the MailComposeView object.

Methods

Method name	Parameter(s)	Parameter type(s)	Return type
AddAttachment	szFileName	String	Long Integer
AddBccRecepient	szRecepient	String	Long Integer
AddCcRecepient	szRecepient	String	Long Integer
AddRecepient	szRecName	String	Long Integer
ClearAll	None	¾	Long Integer
ClearAttachments	None	¾	Long Integer
ClearBodyText	None	¾	Long Integer
ClearRecepients	None	¾	Long Integer
ClearSubject	None	¾	Long Integer
Send	None	¾	Long Integer
SetBodyText	szBody	String	Long Integer
SetSubject	szSubject	String	Long Integer

The following sample Visual Basic code demonstrates how to use the MailComposeView object.

'The following example opens the mail Inbox , sets cc:Mail to be

'the active inbox, opens the MsgCompose view, adds recipients, sets

'the subject and body, adds an attachment, sends the message, and

'closes the E-mail view.

Dim objApp as object

Dim objViews as object

Dim objEmail as object

Dim objMailCompView as object

'Initialize the Application object.

'This starts ACT! if it is not already running.

Set objApp = CreateObject("ACTOLE.APPOBJECT")

'Open the database.

objApp.OpenFile C:\My Documents\ACT\Database\ACT5demo.dbf

'Initialize the Views object.

Set objViews = objApp.Views

'Initialize the EmailView object – The E-mail view should be opened.

Set objEmail = objViews.Create(6, "MyMail")

objEmail.SetActiveInbox ("cc:Mail") 'Set cc:Mail to be the active Inbox.

'Set the MsgComposeView – This view should open now.

Set objMailCompView = objEmail.MsgComposeView

'Add Contact1 as the recipient.

objMailCompView.AddRecepient ("Contact1")

'Add Subject1 as the subject of the message.

objMailCompView.SetSubject ("Subject1")

'Body1 is the body of the message.

objMailCompView.SetBodyText ("Body1")

'Add an attachment c:\attachment.txt.

objMailCompView.AddAttachment ("c:\attachment.txt")

'Send the message.

objMailCompView.Send

'Clear all fields.

objMailCompView.ClearAll

objMailCompView.Close

'Close the E-mail view.

objEmail.Close

Set objEmail = Nothing

'Close the application.

Set objViews = Nothing

Set objApp = Nothing

AddAttachment Method

Description Adds the specified file name as an attachment to the message. Returns S_ERROR on failure.

Object MailComposeView

Syntax object.AddAttachment(szFileName)

Parameters szFileName A string representing the file name (with path) to attach to the message.

Return type Long Integer

GetLastError S_NO_COMPOSE_VW

Preferences object properties and methods

The Preferences object provides an interface to manipulate user preferences in the ACT! application. The following properties and methods apply only to the Preferences object.

Note: The Preferences object cannot be used by users with Browse security level. Users must have Standard or Administrator security level to use the Preferences object.

Properties

Property name	Parameter(s)	Parameter type(s)	Value type	Access
AttachMsgToContact	[= True\|False]	Boolean	Boolean	Read/Write
AttachToMsgUsing	[= iFormat]	Short Integer	Short Integer	Read/Write
CalendarStartTime	[= szTime]	String/BSTR	String/BSTR	Read/Write
CalendarWeekStartsOn	[= szDay]	String/BSTR	String/BSTR	Read/Write
CalMinDurationForBanner	[= lDuration]	Long Integer	Long Integer	Read/Write
CheckScheduleConflicts	[= True\|False]	Boolean	Boolean	Read/Write
ContactSalutation	[= lSalutation]	Long Integer	Long Integer	Read/Write
DefaultContactLayout	[= szLayout]	String/BSTR	String/BSTR	Read/Write
DefaultGroupLayout	[= szLayout]	String/BSTR	String/BSTR	Read/Write
DisplayCountryCode	[= True\|False]	Boolean	Boolean	Read/Write
EnableSpeedLoader	[= True\|False]	Boolean	Boolean	Read/Write
ExitPrompt	[= True\|False]	Boolean	Boolean	Read/Write
GenerateSynchReport	[= True\|False]	Boolean	Boolean	Read/Write
NewActivitiesPrivate	[= True\|False]	Boolean	Boolean	Read/Write
NewActivitiesSeparate	[= True\|False]	Boolean	Boolean	Read/Write
NewContactsPrivate	[= True\|False]	Boolean	Boolean	Read/Write
NewGroupsPrivate	[= True\|False]	Boolean	Boolean	Read/Write
PromptToPrintEnvelope	[= True\|False]	Boolean	Boolean	Read/Write
ReceivedSynchLocation	[= szLocation]	String/BSTR	String/BSTR	Read/Write
RememberPassword	[= True\|False]	Boolean	Boolean	Read/Write
RemindToBackup	[= lDays]	Long Integer	Long Integer	Read/Write
ReturnReceipt	[= True\|False]	Boolean	Boolean	Read/Write
SecondGroupColumn	[= szClName]	String/BSTR	String/BSTR	Read/Write
ShowContactParsingDialog	[= True\|False]	Boolean	Long Integer	Read/Write
ShowCurrentMonthOnly	[= True\|False]	Boolean	Boolean	Read/Write
StartupDatabase	[= szDBName]	String/BSTR	String/BSTR	Read/Write
StartupMacro	[= szMacroName]	String/BSTR	String/BSTR	Read/Write
TabNavigation	[= True\|False]	Boolean	Boolean	Read/Write
UseAct20Keys	[= True\|False]	Boolean	Boolean	Read/Write
UseDialer	[= True\|False]	Boolean	Boolean	Read/Write
UseLastDBonStartup	[= True\|False]	Boolean	Boolean	Read/Write
UseTypeahead	[= True\|False]	Boolean	Boolean	Read/Write
WaitTime	[= lMinutes]	Long Integer	Long Integer	Read/Write

Methods

Method name	Parameter(s)	Parameter type(s)	Return type
ClearError	None	¾	Void
GetActivityCleanupStyle	None	¾	Short Integer
GetAttachmentInfo	None	¾	String/BSTR
GetCalendarIncrements	iType	Short Integer	Short Integer
GetDataToSynch	None	¾	Long Integer
GetDBMaintReminderInfo	bEnabled, lDayInterval	Boolean, Long Integer	Boolean, Long Integer
GetDefaultApplication	iType	Short Integer	String/BSTR
GetDefaultLocation	iType	Short Integer	String/BSTR
GetEmailInboxSettings	iDelete, iPollTime	Short Integer, Short Integer	Long Integer
GetEmailNewMsgInfo	None	¾	String/BSTR
GetEmailSystem	None	¾	String/BSTR
GetLastError	None	¾	Long Integer
GetNameSettings	iType	Short Integer	String/BSTR
GetSchdActivityDefaults	iType	Short Integer	String/BSTR
GetSchdAutoRollover	None	¾	Short Integer
GetStyle	iWindowType	Short Integer	String/BSTR
GetSynchScheduleInfo	None	¾	String/BSTR
GetSynchSettings	None	¾	String/BSTR
GetSynchUpdateInfo	None	¾	Long Integer
SetActivityCleanupStyle	iStyle	Short Integer	Long Integer
SetAttachmentInfo	szNewInfo	String	Long Integer
SetCalendarIncrements	iType, iIncrement	Short Integer, Short Integer	Long Integer
SetDataToSynch	lInfo	Long Integer	Long Integer
SetDBMaintReminderInfo	True\|False, lDayInterval	Boolean, Long Integer	Void
SetDefaultApplication	iType, szAppName	Short Integer, String	Long Integer
SetDefaultLocation	iType, szLocation	Short Integer, String	Long Integer
SetEmailInboxSettings	iDelete, iPollTime	Short Integer, Short Integer	Long Integer
SetEmailNewMsgInfo	szInfo	String	Long Integer
SetEmailSystem	szSystem	String	Long Integer
SetNameSettings	iType, szList	Short Integer, String	Long Integer
SetSchdActivityDefaults	iType, szDefaults	Short Integer, String	Long Integer
SetSchdAutoRollover	iRollover	Short Integer	Long Integer
SetStyle	iWindowType, szFontName	Short Integer, String	Long Integer
SetSynchScheduleInfo	szInfo	String	Long Integer
SetSynchSettings	szInfo	String	Long Integer
SetSynchUpdateInfo	lInfo	Long Integer	Long Integer

AttachMsgToContact Property (requires ACT! 4.0 or later)

Description Gets and sets the mode for attaching new e-mail messages to contacts. Use this property to get, select, or deselect (that is, enable or disable) the Attach To Contact(s) option under New Message Settings in the E-mail tab of the Preferences dialog box. Returns True if the Attach To Contact(s) option is selected or False if this option is deselected. Returns False on failure.

Object Preferences

Syntax object.AttachMsgToContact [= True|False]

Parameters True|False Specify True to select the Attach To Contact(s) option or False to deselect this option. Omit this optional parameter to get the setting (selected or deselected) of the Attach To Contact(s) option.

Value type Boolean, Read/Write

GetLastError S_NO_SECURITY, S_NO_USER, S_NOT_PRIVILEGED, S_PROPS_NOT_FOUND

Example Dim objApp As Object

Dim objPref As Object

'Open the database with the default database.

Set objApp = CreateObject("ACTOLE.APPOBJECT")

'Open a database.

objApp.OpenDB C:\My Documents\ACT\Database\ACT5demo.dbf

'Get the Preferences object from the Application object.

Set objPref = objApp.Preferences

'Set the property AttachMsgToContact to True.

objPref.AttachMsgToContact True

Set objPref = Nothing

Set objApp = Nothing

AttachToMsgUsing Property (requires ACT! 4.0 or later)

Description Gets and sets the mode for the format to use when attaching contacts or activities to e-mail messages. Use this property to get, select, or deselect (that is, enable or disable) the Attaching Contacts/activities To Messages options in the General tab of the Preferences dialog box. Returns S_ERROR on failure.

Object Preferences

Syntax object.AttachToMsgUsing [= iFormat]

Parameters iFormat A short integer representing the format to use when attaching contacts or activities to e-mail messages.

The following table lists the values that are set or returned for this property.

Value	Option
1	ACT! data (for use with other ACT! users)
2	vCard/vCalendar (MS Outlook compatible)
3	Attach using both formats

Value type Short Integer, Read/Write

GetLastError S_INVALID_INPUT, S_NO_SECURITY, S_NO_USER, S_NOT_PRIVILEGED, S_PROPS_NOT_FOUND, S_WRITE_FAIL

Example Dim objApp As Object

Dim objPref As Object

'Open the database with the default database.

Set objApp = CreateObject("ACTOLE.APPOBJECT")

'Open a database.

objApp.OpenDB C:\My Documents\ACT\Database\ACT5demo.dbf

'Get the Preferences object from the Application object.

Set objPref = objApp.Preferences

'Set the property AttachToMsgUsing to 1 (use ACT! data format).

objPref.AttachToMsgUsing 1

Set objPref = Nothing

Set objApp = Nothing

CalendarStartTime Property

Description Gets and sets the time of day to begin the daily and weekly calendars. Returns NULL on error.

Object Preferences

Syntax object.CalendarStartTime [= szTime]

Parameters szTime A string that specifies the time of day to start the daily and weekly calendars. Omit this optional parameter to get the starting time for the calendars. The format of szTime is "hh:mm AM|PM".

Value type String/BSTR, Read/Write

TaskListView object methods

The TaskListView object provides an interface to use the Task List view in the ACT! application. The following methods apply only to the TaskListView object. See “Common properties and methods” for properties and additional methods that apply to the TaskListView object.

Method

Method name	Parameter(s)	Parameter type(s)	Return type
AddNewActivityEx	szContactID…, szDateTime, iType, iTimeless, szRegarding, lDuration	String, String, Short Integer, Short Integer, String, Long Integer	String/BSTR
GetGrid	None	¾	Object/LPDISPATCH

AddNewActivity Method (obsolete)

Use AddNewActivityEx instead of this method.

AddNewActivityEx Method (requires ACT! 4.0 or later)

Description Adds a new activity for the specified contact to the grid in the Task List view. Activity defaults set in the Scheduling tab of the Preferences dialog box are used to create the new activity. Use GetFilter and SetFilter in the Grid object before using this method. Returns S_ERROR on failure.

Object TaskListView

Syntax object.AddNewActivityEx(szContactID…, szDateTime, iType, iTimeless, szRegarding,
lDuration)

Note: Specify multiple Unique IDs as a continuous string of 12‑character values, with no delimiters between the Unique ID values.

szDateTime A string representing the starting date and time of the activity, formatted in Windows Regional Settings Short Date style and Time style.

iType A short integer indicating the type of activity to be added.

lType must be one of the following values:

Value	Activity type	Value	Activity type
0	Call	2	To-do
1	Meeting

iTimeless A short integer indicating the timeless status of the activity to be added. Specify 0 for not timeless or 1 for timeless.

szRegarding A string representing the description of the activity.

lDuration A long integer representing the duration in minutes for the activity.

Return type String/BSTR

GetLastError S_ACTIVITY_INIT_FAIL, S_CON_DOC, S_EEDIT_FAIL, S_INVALID_INPUT, S_MEM_ERROR, S_NO_DALLIST_VIEW, S_PROPS_NOT_FOUND

Comments If any Unique ID specified in szContactID is invalid, this method returns S_OK. GetLastError returns S_INVALID_INPUT.

Return type Long Integer

Example 'This example adds an activity through the Task List.

'Create the TaskListView object.

Set objTask = objViews.Create(4, "TL")

'Get the Grid object.

Set objTaskGrid = objTask.GetGrid

List1.AddItem objTaskGrid.GetCurrentRow

List1.AddItem "There are " & objTaskGrid.GetRowCount & " Activities"

Dim x As Long

Dim y, z As Variant

'Get the filter values.

objTaskGrid.GetFilter x, y, z

j = 0 Or 1 Or 2 Or 8 Or 4 Or 64 Or 128 Or 16 Or 32

'Set filter to select all priorities, all types, cleared activities,

'all users, and all dates.

objTaskGrid.SetFilter j, 1, ""

'Add a new activity.

uid = objTask.AddNewActivityEx(sContact, "1/31/98 8:29PM",

activitytype_meeting, 0, "Test ABC", "15")

RN = objTaskGrid.GetRowNumber(uid)

'Set the activity priority.

objTaskGrid.SetField AF_Priority, RN, activitypriority_medium

'Reset the filter back to what the user had selected.

objTaskGrid.SetFilter x, y, z

objTaskGrid.Close

Set objTaskGrid = Nothing

Set objViews = Nothing

GetGrid Method

Description Returns a dispatch pointer to a grid object for the Task List view.

Object TaskListView

Syntax object.GetGrid

Return type Object/LPDISPATCH

GetLastError S_CON_DOC

Example See GetColumnCount (Grid object).

Views object property and methods

The following property and methods apply only to the Views object.

Property

Property name	Parameter(s)	Parameter type(s)	Value type	Access
Count	None	¾	Short Integer	Read Only

Methods

Method name	Parameter(s)	Parameter type(s)	Return type
Application	None	¾	Object/LPDISPATCH
ClearError	None	¾	Void
CloseAll	None	¾	Long Integer
Create	iViewType, szName	Short Integer, String	Object/LPDISPATCH
CreateBrowserView	szCtrlFile	String	Object/LPDISPATCH
CreateBrowserViewFromUrl	szCtrlFile szTitle iFlags	String, String, Short Integer
CreateEx	iViewType, iState	Short Integer, Short Integer	Long Integer
FindExplorerView	szName, iViewType	String, Short Integer	Object/LPDISPATCH
GetActive	None	¾	Object/LPDISPATCH
GetLastError	None	¾	Long Integer
GetView	iViewType	Short Integer	Object/LPDISPATCH
GetViewEx	True\|False, iViewType	Boolean Short Integer	Object/LPDISPATCH

Application Method

Description Returns a dispatch pointer to the application object containing the Views object.

Object Views

Syntax object.Application

Return type Object/LPDISPATCH

Example 'The following code can be put into a function that has been passed

'only the Views object – objViews. We assume in the main function

'that the Application object has already been created.

Dim objApp1 as object

'Get a pointer to the Application object.

Set objApp1 = objViews.Application

'Any Application object methods can manipulate the application.

'End the function.

Set objApp1 = Nothing

ClearError Method (requires ACT! 4.0 or later)

Description Clears the last error.

Object Views

Syntax object.ClearError

Return type Void

Value	Setting	Value	Setting
0	0 minutes	120	2 hours
5	5 minutes	180	3 hours
10	10 minutes	480	8 hours
15	15 minutes	1440	1 day
30	30 minutes	7200	5 days
45	45 minutes	43200	30 days
60	1 hour

Conventions used in this section

Syntax conventions

Terminology

Parameter types

Special considerations

Using properties in Visual C++

Changing the focus

System requirements

Development languages

Using the Application Object with Visual C++

Example C++ code

Understanding key files

ACT! OLE Application Object model

What’s new

Changes for ACT! 4.0

Modified methods

Added properties and methods

Changes for ACT! 2000

Added properties and methods

Changes for ACT! 2000 version 5.0.2

Modified methods

Added methods

Modified documentation

Common properties and methods

Application object properties and methods

CalendarView object methods

ContactListView object methods

ContactView object methods

EmailView object methods

ExplorerView object methods

Grid object methods

GroupView object methods

MailComposeView object methods

Preferences object properties and methods

TaskListView object methods

Views object property and methods

Value	Setting
0	Use Contact’s Last Name
1	Use Contact’s First Name
2	Do Not Fill Salutation

Value	Setting
0	Ask me (the user) before saving the attached file.
1	Always save the attached file.
2	Never save the attached file.

Value	Setting
0	Do not Synchronize Activities or Notes/Histories
1	Synchronize Activities only
2	Synchronize Notes/Histories only
3	Synchronize Activities and Notes/Histories

Value	Day of week	Value	Day of week
1	Sunday	16	Thursday
2	Monday	32	Friday
4	Tuesday	64	Saturday
8	Wednesday

Value	Setting
0	Do not Send or Receive Updates
1	Send Updates only
2	Receive Updates only
3	Send and Receive Updates

Value	View type	Value	View type
1	Contacts view	4	Task List view
2	Contact List view	5	Calendar view
3	Groups view	6	E-mail view (To create an E-mail view, the E-mail system must have been set up in the ACT! application.)

Value	View State	Value	View State
1	Normal	3	Minimized
2	Maximized	4	Hidden

Value	Error code	Description
-1		General error
-2		Row is not visible in window
-10	S_UNKNOWN	Unknown internal error
100	S_ERROR	General error
101	S_NONE	No more items
102	S_NOT_FOUND	File not found
103	S_MAIN_WND	Application window not found
104	S_FRM_VW_SYS	Internal error
105	S_CON_DOC	No open database
106	S_GRP_FRM	Internal error
107	S_JUMP_TO_REC	Internal error
108	S_LOOKUP_FAIL	Internal error
109	S_ACTIVE_REC	Internal error
110	S_ACTIVE_TAB	Not used
111	S_ACTIVATE_TAB	Not used
112	S_GETFIELD_FAIL	Internal error
113	S_SETFIELD_FAIL	Internal error
114	S_INTERNAL	Not used
115	S_LIST_ERR	Internal error
116	S_VW_NOT_FOUND	Specified view does not exist
117	S_INVALID_INPUT	Invalid input
118	S_NO_COMPOSE_VW	Mail Compose view does not exist
119	S_GET_SELECTION_FAIL	Internal error
120	S_FOLDER_OPEN_FAIL	Internal error
121	S_VW_CREATE_FAIL	Not used
122	S_PROPS_NOT_FOUND	Preferences not found (internal error)
123	S_WRITE_FAIL	Failed to change user preferences (internal error)
124	S_NO_WP_DRVMGR	Internal error
125	S_NO_WP_DRIVER	No word processor driver (internal error)
126	S_NO_FAX_DRVMGR	Internal error
127	S_NO_FAX_DRIVER	No fax driver (internal error)
128	S_NO_DB	No open database
129	S_NO_SECURITY	Internal error
130	S_NOT_PRIVILEGED	Not enough privileges to perform operation
131	S_CREATE_NEWUSER	Internal error
132	S_NO_USER	No current user
133	S_NO_MATCH	Old and new passwords do not match
134	S_MEM_ERROR	Error allocating memory
135	S_NOMENU	Internal error
136	S_INVALID_CMD	Invalid command
137	S_CON_LIST	Internal error
138	S_FILE_OPEN	Unable to open specified file
139	S_MACRO_ERROR	Error running specified macro (internal error)
140	S_NO_CONTAINER	Not used
141	S_NO_DALLIST_VIEW	Internal error
142	S_VIEW_EXISTS	A view of the specified type already exists
143	S_NO_EMAIL	E-mail view does not exist
144	S_NO_CALVW	Calendar view does not exist
145	S_INVALID_VWTYPE	View type is invalid
146	S_NO_OPENDB	No open database
147	S_NO_TAB_CONTAINER	Internal error
148	S_DEFAULT_USED	Input was invalid. Default was used. (SetSynchSettings method)
148	S_INVALID_TAB	Invalid tab specified (SetActiveTab method)
149	S_ACTIVITY_INIT_FAIL	Internal error
150	S_HELPER_EEDIT_FAIL	Internal error
151	S_ADD_CONTACT	Internal error
152	S_NO_RECORD	No active record
153	S_RECORD_HISTORY	Could not record history
154	S_DUPLICATE_CONTACT	Duplicate contact
155	S_DUPLICATE_GRP	Duplicate group
156	S_DELETE_FAIL	Delete failed (internal error)
157	S_DUPLICATE	Internal error
158	S_BUILD_ERROR	Error building list (internal error)
159	S_CANT_SORT	Not used
160	S_STOP_EDIT	Internal error
161	S_NO_SCHEMA	Internal error
162	S_NOT_SORTABLE	Specified field is not sortable
163	S_INVALID_ID	Invalid ID specified
164	S_SET_NOT_ALLOWED	Set not allowed on specified field
165	S_DELETE_NOTALLOWED	Row cannot be deleted from the specified grid
166	S_NOT_IMPLEMENTED	Method not implemented
167	S_NO_OVERWRITE	File could not be overwritten
168	S_ASK_OVRWRITE	Not used
169	S_NOT_READY	Destination device is not ready
170	S_OPEN_FILE	Not used
171	S_ADD_FILE	Not used
172	S_SERVER_BUSY	ACT! application is waiting for user response
173	S_FILE_EXISTS	Destination file exists
174	S_WRITE_PROTECT	Destination file is write protected
175	S_NO_EMAIL_SYSTEM	E-mail system is not setup
176	S_NOT_SUPPORTED	Method is not supported
177	S_NO_OUTLOOK	No Outlook on the system
178	S_BAD_PARAM	Invalid parameter values
179	S_GRP_HAS_SUBGRP	The group has a subgroup (Delete method in GroupView object))
180	S_BAD_FILENAME	Invalid pathname, filename, or extension.
181	S_SCRIPT_ERROR	Script file for the TriggerActivitySeries method encountered an error.