Edit

Share via


ContactList Class

Definition

Use the ContactList control to display the Lync contacts list, and give users the ability to launch voice, instant messaging (IM), or e-mail conversations with any of their contacts.

public ref class ContactList : Microsoft::Lync::Controls::UCBase
[System.Windows.TemplatePart(Name="PART_SortByAvailabilityMenuItem", Type=typeof(Microsoft.Lync.Controls.Internal.MenuItem))]
[System.Windows.TemplatePart(Name="PART_ContactListMenu", Type=typeof(Microsoft.Lync.Controls.Internal.ContactListMenu))]
[System.Windows.TemplatePart(Name="PART_TreeControl", Type=typeof(Microsoft.Lync.Controls.UCTreeView))]
[System.Windows.TemplatePart(Name="PART_ViewLayoutMenu", Type=typeof(Microsoft.Lync.Controls.Internal.SplitButton))]
[System.Windows.TemplatePart(Name="PART_OneLineMenuItem", Type=typeof(Microsoft.Lync.Controls.Internal.MenuItem))]
[System.Windows.TemplatePart(Name="PART_TwoLinesMenuItem", Type=typeof(Microsoft.Lync.Controls.Internal.MenuItem))]
[System.Windows.TemplatePart(Name="PART_SortByDisplayNameMenuItem", Type=typeof(Microsoft.Lync.Controls.Internal.MenuItem))]
public class ContactList : Microsoft.Lync.Controls.UCBase
type ContactList = class
    inherit UCBase
Public Class ContactList
Inherits UCBase
Inheritance
ContactList
Attributes

Remarks

The control supports Group, Relationship, and Status views, in the same manner as Lync, and includes the option to switch between status only, and status with photo display modes. The ContactList control gives users the ability to copy, move, delete, multi-select and sort contacts, set status alerts, and manage privacy settings.

Constructors

ContactList()

Initializes a new instance of the ContactList class.

Fields

BotItemTemplateProperty

Identifies the BotItemTemplate dependency property.

BotTwoLineItemTemplateProperty

Identifies the BotTwoLineItemTemplate dependency property.

ContactLayoutViewProperty

Identifies the ContactLayoutView dependency property.

ContactsProperty

Identifies the Contacts dependency property.

ContextualInformationProperty

Identifies the ContextualInformation dependency property.

GroupItemContainerStyleProperty

Identifies the GroupItemContainerStyle dependency property.

GroupItemTemplateProperty

Identifies the GroupItemTemplate dependency property.

GroupTwoLineItemTemplateProperty

Identifies the GroupTwoLineItemTemplate dependency property.

GroupViewBySettingProperty

Identifies the GroupViewBySetting dependency property.

ItemContainerStyleProperty

Identifies the ItemContainerStyle dependency property.

ModelProperty

Identifies the Model dependency property.

PersonItemTemplateProperty

Identifies the PersonItemTemplate dependency property.

PersonTwoLineItemTemplateProperty

Identifies the PersonTwoLineItemTemplate dependency property.

ShowFrequentContactsProperty

Identifies the ShowFrequentContacts dependency property.

ShowFriendlyNameProperty

Identifies the ShowFriendlyName dependency property.

ShowPivotBarProperty

Identifies the ShowPivotBar dependency property.

SortBySettingProperty

Identifies the SortBySetting dependency property.

TelephoneItemTemplateProperty

Identifies the TelephoneItemTemplate dependency property.

TelephoneTwoLineItemTemplateProperty

Identifies the TelephoneTwoLineItemTemplate dependency property.

Properties

BotItemTemplate

Gets or sets the DataTemplate used for Bot-type contacts in OneLine mode. (See ContactLayoutView).

BotTwoLineItemTemplate

Gets or sets the DataTemplate used for Bot-type contacts in TwoLines mode. (See ContactLayoutView).

ContactLayoutView

Gets or sets the current layout view for all contact nodes.

Contacts

Reserved for internal use.

ContextMenu (Inherited from UCBase)
ContextualInformation

Gets or sets data structure which provides contextual information for use with the contextual conversation feature.

GroupItemContainerStyle

Gets or sets the Style which is applied to top-level group nodes in the contact list.

GroupItemTemplate

Gets or sets the DataTemplate used for Group-type contacts in OneLine mode. (See ContactLayoutView).

GroupTwoLineItemTemplate

Gets or sets the DataTemplate used for Group-type contacts in TwoLines mode. (See ContactLayoutView).

GroupViewBySetting

Gets or sets an enumerated value which determines the manner in which contacts are grouped on the contact list.

InitializationError (Inherited from UCBase)
InitializationErrorMessage (Inherited from UCBase)
InitializationFailed (Inherited from UCBase)
IsInResiliencyMode (Inherited from UCBase)
IsLoaded (Inherited from UCBase)
IsLoadedAndIsInVisualTree (Inherited from UCBase)
IsSignedIn (Inherited from UCBase)
ItemContainerStyle

Gets or sets the Style which is applied to contact nodes in the contact list.

Model

Reserved for internal use.

PersonItemTemplate

Gets or sets the DataTemplate used for Person-type contacts in OneLine mode. (See ContactLayoutView).

PersonTwoLineItemTemplate

Gets or sets the DataTemplate used for Person-type contacts in TwoLines mode. (See ContactLayoutView).

SelectedContactUris

Gets a collection of strings which represent the set of contacts that are currently selected in the ContactList.

ShowFrequentContacts

Gets or sets whether the Frequent Contacts Group is shown when GroupViewBySetting is set to Groups.

ShowFriendlyName

Gets or sets whether contacts in the list are shown using their displaynames or their SIPURI's.

ShowPivotBar

Gets or sets whether the pivot bar is visible.

SortBySetting

Gets or sets an enumerated value which determines the sort order of contacts within the group nodes on the contact list.

TelephoneItemTemplate

Gets or sets the DataTemplate used for Telephone-type contacts in OneLine mode. (See ContactLayoutView).

TelephoneTwoLineItemTemplate

Gets or sets the DataTemplate used for Telephone-type contacts in TwoLines mode. (See ContactLayoutView).

UCClientModel (Inherited from UCBase)

Methods

ExtractTemplatePart<T>(String) (Inherited from UCBase)
ExtractTemplatePart<T>(String, Boolean) (Inherited from UCBase)
OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call ApplyTemplate. In simplest terms, this means the method is called just before a UI element displays in an application.

OnClientDisconnected() (Inherited from UCBase)
OnContactManagerPropertyChanged(IContactsAndGroupsManagerModel, IContactsAndGroupsManagerModel)

Reserved for internal use.

OnCreateAutomationPeer()

Overrides OnCreateAutomationPeer to return the ContactListAutomationPeer object.

OnIsInResiliencyModePropertyChanged(Boolean, Boolean)

Reserved for internal use.

OnIsSignedPropertyChanged(Boolean, Boolean)

Reserved for internal use.

OnLoaded() (Inherited from UCBase)
OnSelfModelPropertyChanged(ISelfModel, ISelfModel) (Inherited from UCBase)
OnUnloaded()

Reserved for internal use.

UnwireUCClient()

Reserved for internal use.

WireUCClient(IUCClientModel)

Reserved for internal use.

Events

InitializationCompleted (Inherited from UCBase)
SelectedContactUrisChanged

Fired when the content of SelectedContactUris has changed.

Applies to