CCF_DEFAULT

0x0000

Default view. The Property Chooser dialog box will be used when the selected Contact item has values for two or more properties specified in CHOOSECONTACT::rgpropidRequiredProperties.

The New Contactmenu item is displayed.

CCF_HIDENEW

0x0001

Hides the New Contactmenu item, and disables the ability to create a new Contact item from the Contact Chooser control.

CCF_CHOOSECONTACTONLY

0x0002

When set, the Property Chooser dialog box does not appear.

The first non-blank property specified in CHOOSECONTACT::rgpropidRequiredPropertiesis chosen.

CCF_CHOOSEPROPERTYONLY

0x0004

When set, the Contact Chooser dialog box does not appear.

The OID of the Contact to use is retrieved from the CHOOSECONTACT::oidContactIDproperty.

Note:
When you set both the CCF_RETURNCONTACTNAMEand CCF_CHOOSEPROPERTYONLYflags, the contact name is not returned.

CCF_RETURNCONTACTNAME

0x0008

When set, the contact name is returned in the CHOOSECONTACT::bstrContactName property.

Note:
When you set both the CCF_RETURNCONTACTNAMEand CCF_CHOOSEPROPERTYONLYflags, the contact name is not returned.

CCF_RETURNPROPERTYVALUE

0x0010

When set, the property value is returned in the CHOOSECONTACT::bstrPropertyValueSelectedproperty.

CCF_FILTERREQUIREDPROPERTIES

0x0020

When set, contact items without Nameor FileAsvalues are dynamically filtered from the Contact Chooser List View (that is, they do not appear in the list). As such, contact items that have a value for any one of the following propertieswill appear in the Contact Chooser List View.

PIMPR_FIRST_NAME

PIMPR_LAST_NAME

PIMPR_YOMI_FIRSTNAME

PIMPR_YOMI_LASTNAME

PIMPR_FILEAS

PIMPR_YOMI_FILEAS

The Contact Chooser List View is filtered by the communication method specified in the rgpropidRequiredPropertiesmember of the CHOOSECONTACT Structure, when calling the ChooseContactfunction. For information on communication methods, see ChooseContact Property ID's.

For example, if some of your contacts just have e-mail addresses, and some of your contacts just have telephone numbers, then a rgpropidRequiredPropertiesvalue of ContactProperty.AllPhonewill allow only those contact items with phone numbers to appear in the Contact Chooser List Viewin addition to those that have Nameor FileAsvalues of CCF_FILTERREQUIREDPROPERTIESis set.

CCF_NOUIONSINGLEORNOMATCH

0x0040

When set, neither the Contact Chooser, nor the Property Chooser dialog boxes display for a single match, or for no matches.

CCF_NOUI

0x0080

When set, neither the Contact Chooser, nor the Property Chooser dialog boxes display.

Note:
When CCF_CHOOSECONTACTONLYand CCF_NOUIare both set, CCF_NOUItakes precedence.

CCF_ENABLEGAL

0x0100

When set, an entry point to Global Address Book (GAL) is added as a List View item, and also as a menu item. The List View item is located below New Contactif CCF_ALLOWNEWCONTACTSELECTIONis set.

CCF_ALLOWNEWCONTACTSELECTION

0x0200

When set, adds the New Contactoption to the top of the Contact Chooser List View.

Remarks

The individual values (constants) in a set of flags follows the sequence 2 ⁰, 2 ¹, 2 ², …2 ⁿ. This approach allows each value to be expressed as a byte with only one bit set (that is, one bit has a value of 1, and the other seven bits all have a value of 0). When an entire set of flags is expressed as bytes, and no two of them have a bit set in the same position, then you can combine these flags using the bitwise ORoperator. The result is a "complex bit mask"—a byte with a bit pattern in which the positions of the 1s indicates the flags you want. This is equivalent to adding multiple flags together (that is, I want to set this flag, plus that flag, plus that one…). The benefit is that you can use a complex bit mask in place of an individual flag.

This means you can load the CHOOSECONTACT Structure's dwFlagsmember with more than one Contact Chooser flag value. For example, if you wanted to give users the ability to create new contact items from the Contact Chooser control, and in addition you only wanted the required properties to appear in the control, then you would achieve it by logically OR-ing the following two flags together:

	Copy Code
(CCF_HIDENEW | CCF_FILTERREQUIREDPROPERTIES)

Requirements

See Also