ABDIALOGINFO

This structure contains information used by the Address Book API.

Syntax

typedef struct {
CEOID
ceoid;
DWORD
dwEnabled;
DWORD
dwParam;
WORD
wInitView;
WORD
wFieldOrd;
WORD
wCard;
BSTR
bstrHelpIndexFile;
BSTR
bstrHelpTopicFile;
BSTR
bstrMainFormCaption;
BSTR bstrCardFormCaption;
BSTR
bstrParam1;
BSTR bstrParam2;
IVerifyContactSink *pVerifyListSink;
IVerifyContactSink *pVerifySelectionSink;
} ABDIALOGINFO, *LPDIALOGINFO;

Members

ceoid
Contact object identifier. This member is read/write.
dwEnabled
Specifies which features are enabled. This read member is one or a combination of the following flags:
Flag
Value
Description
ABE_BACK 0x0001 Allows the user to return to the main view after changing to another view.
ABE_CARDPHONE 0x0002 Enables the card view for the phone tab.
ABE_CARDHOME 0x0004 Enables the card view for the home tab.
ABE_CARDWORK 0x0008 Enables the card view for the work tab.
ABE_CARDNOTES 0x0010 Enables the card view for the notes tab.
ABE_DELETE 0x0020 Notifies the Address Book that the user is allowed to delete cards.
ABE_DIAL 0x0040 Notifies the Address Book that the user is allowed to dial phone numbers from a card.
ABE_EDIT 0x0080 Notifies the Address Book that the user is allowed to edit, or create new cards.
ABE_EXITMAIN 0x4000 Notifies the Address Book that the user is allowed to exit the main form.
ABE_NEW 0x0100 Notifies the Address Book that the user is allowed to add cards.
ABE_OPTIONMENU 0x1000 Enables the Address Book option menu.
ABE_PRESERVEAPPFOCUS 0x200000 Forces the Address Book API to leave the application in the foreground and to exit the address book when the login fails.
ABE_RECEIVE 0x0200 Notifies the Address Book that the user is allowed to receive contact information via the infrared port.
ABE_SENDONE 0x0400 Notifies the Address Book that the user is allowed to send contact information via the infrared port.
ABE_SENDALL 0x0800 Notifies the Address Book that the user is allowed to send all contact information via the infrared port.
ABE_VOICEMENU 0x2000 Allows the user to interact with the Address Book through speech.
ABE_TTS 0x8000 Makes the user interface (UI) behave as if it were invoked with speech commands instead of the keyboard.
ABE_ALL 0x0fff Combination flag that enables all address book functions.
ABE_CARDALL 0x001e Combination flag that enables the card view for phone, home, work, and notes tabs.
ABE_EDITALL 0x01a0 Combination flag that allows the user to delete, edit, or create new cards.
ABE_IRALL 0x0e00 Combination flag that allows the user to receive, send one, or send all messages.

dwParam
Specifies a DWORD that indicates the user's actions while in the card view. It is one of the flags shown in the following table. This member must be zero if unused.
Flag
Value
Description
ABN_RECORDS_ADDED 0x0001 The user has added records since the Address Book API started.
ABN_RECORDS_DELETED 0x0002 The user has deleted records since the Address Book API started.
ABN_EXIT_USING_VOICE 0x0004 The user exited the Address Book API by using speech commands.
ABN_RESORT_DB 0x0008 The user changed database fields, affecting the sort sequence.

wInitView
Unsigned 16-bit character that indicates the initial or final view. This member is one of the following values:
Flag
Value
Description
ABV_MAINVIEW 1 Displays main contacts list with tabber index. Focus is set to ceoid.
ABV_LOCATE 2 Displays same screen as ABV_MAINVIEW unless the user has already said, “Locate.”
ABV_CARDPHONE 3 Displays card view at the phone tab.
ABV_CARDHOME 4 Displays card view at the home information tab.
ABV_CARDWORK 5 Displays card view at the work information tab.
ABV_CARDNOTES 6 Displays card view at the notes tab. This value is not currently implemented.
ABV_DIAL 7 Displays screen asking the user, “Dial preferred number?” If the user replies, “No,” then ABV_CARDPHONE is shown on the Auto PC display.
ABV_RECEIVE 8 Displays the infrared Receive form. The Auto PC is waiting for an infrared connection.
ABV_SEND 9 Displays the infrared Send form. The Auto PC attempts to send dwParam contacts starting at ceoid by means of infrared.

wFieldOrd
Unsigned 16-bit integer that indicates the field ordinal. This member is read/write.
wCard
Unsigned 16-bit character that indicates the default or final view. This member uses the same flags listed for the wInitView member.
bstrHelpIndexFile
Unicode string that contains the name of the Help index file. If this string or the topic is NULL, use Address Book Help.
bstrHelpTopicFile
Unicode string that contains the name of the initial Help topic file. If NULL, start at index.
bstrMainFormCaption
Unicode string that contains the main form caption to use if ABV_MAINVIEW is shown.
bstrCardFormCaption
Unicode string that contains the card form caption use if ABV_CARD* is shown.
bstrParam1
Unicode string that contains the name of the contact shown in the Dial dialog box.
bstrParam2
Unicode string that contains the location of the contact shown in the Dial dialog box.
pVerifyListSink
Reserved for future use.
pVerifySelectionSink
Pointer to a sink. If specified, this sink is called when the user makes a selection to determine if selection should be accepted.

See Also

IVerifyContactSink