Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
These flags define the behavior of the Contact Chooser.
A bitmask created from the Contact Chooser flags is passed to the ChooseContactfunction in the dwFlagsmember of the CHOOSECONTACT Structure.
Flag | Value | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
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.
|
||||||||||
CCF_RETURNCONTACTNAME |
0x0008 |
When set, the contact name is returned in the CHOOSECONTACT::bstrContactName property.
|
||||||||||
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.
|
||||||||||
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. |
||||||||||
|
|
|
||||||||||
|
|
|
||||||||||
|
|
RemarksThe individual values (constants) in a set of flags follows the sequence 2 0, 2 1, 2 2, …2 n. 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:
Requirements
See AlsoReferencePocket Outlook Object Model FlagsChooseContact CHOOSECONTACT Structure Contact Property IDs PIMPR_CONTACTTYPE Internal Server ErrorThe server encountered an internal error or misconfiguration and was unable to complete your request. Please contact the server administrator at webmaster@systemmanager.forsenergy.ru to inform them of the time this error occurred, and the actions you performed just before this error. More information about this error may be available in the server error log. Additionally, a 500 Internal Server Error error was encountered while trying to use an ErrorDocument to handle the request. |