Lync 2010 Control Properties That Support Restyling

Article
01/20/2015

Use properties on Microsoft Lync 2010 Controls to control the appearance of a Lync 2010 Control. Lync 2010 Controls and the properties that support restyling appear in this topic.

Properties Used to Change Control Style

ContactList

The following properties on ContactList support restyling the control.

Property	Action
Background	Background color is painted to the entire area, including buttons and contact items.
BorderBrush	Placed around the entire control. Does not propagate to contact items or any other sub-control.
BorderThickness	Placed around the entire control. Does not propagate to contact items or any other sub-control.
FontFamily	Applies to all visible fonts including filter buttons, headers, contact items, and contact cards. Does not apply to menu items and tooltips.
FontWeight	Applies to all visible fonts including filter buttons, headers, contact items, and contact cards. Does not apply to menu items and tooltips.
Padding	Applies to the distance between the border controlled by the BorderBrush and BorderThickness properties, and the actual content of the ContactList control.

CustomContactList

The following properties on CustomContactList support restyling the control.

Property	Action
Background	Background color is painted to the entire area, including buttons and contact items.
BorderBrush	Placed around the entire control. Does not propagate to contact items or any other sub-control.
BorderThickness	Placed around the entire control. Does not propagate to contact items or any other sub-control.
FontFamily	Applies to all visible fonts including filter buttons, headers, contact items, and contact cards. Does not apply to menu items and tooltips.
FontWeight	Applies to all visible fonts including filter buttons, headers, contact items, and contact cards. Does not apply to menu items and tooltips.
Padding	Applies to the distance between the border controlled by the BorderBrush and BorderThickness properties, and the actual content of the CustomContactList control.

StartInstantMessagingButton

The following properties on StartInstantMessagingButton support restyling the control.

Property	Action
Background	The background color is painted to the entire area shown behind hover/pressed states.
Padding	Adds margins to the content of the StartInstantMessagingButton control. In this case, a margin is added to the control’s icon.
Content()	Enables the developer to assign a string or any other element. The Content property visually replaces the StartInstantMessagingButton control’s icon.

StartAudioCallButton

The following properties on StartAudioCallButton support restyling the control.

Property	Action
Background	Background color is painted to the entire area shown behind hover/pressed states. Does not apply to the split menu.
Padding	Adds margins to the leftmost content of the SplitButton control. In this case, the voice endpoint icon.
Content	Enables the developer to assign a string or any other element. The Content property visually replaces the StartAudioCallButton control icon.

ContactCard

The following properties on ContactCard support restyling the control.

Property	Action
Background	Background color is painted to the entire area including tab content and the tab itself, and is positioned within the exterior border including rounded corners. The unfocused tab should have a semi-transparent palette that darkens the background color. Does not apply to the note box.
BorderBrush	Placed around the circumference of the contact card, excluding the note border. The note obscures the top border when the contact card is open.
BorderThickness	Placed around the circumference of the contact card, excluding the note border. The note obscures the top border when it is open.
FontFamily	Applies to all visible fonts. Does not apply to menu items and tooltips.
FontWeight	Applies to all visible fonts. Does not apply to menu items and tooltips.

ContactSearchInputBox

The following properties on ContactSearchInputBox support restyling the control.

Property	Action
Background	Background color is painted to the entire area shown behind the text box. The text box remains white.
BorderBrush	Placed around the entire ContactSearchInputBox control.
BorderThickness	Placed around the entire ContactSearchInputBox control.
FontFamily	Applies to all visible text.
FontWeight	Applies to all visible text.
Padding	Applies to the distance between the border controlled by the BorderBrush and BorderThickness properties, and the actual content of the ContactSearchInputBox control.

ContactSearchResultList

The following properties on ContactSearchResultList support restyling the control.

Property	Action
Background	Background color is painted to the entire area, including list items.
BorderBrush	Placed around the entire control. Does not propagate to the list control or any other sub-control.
BorderThickness	Placed around the entire control. Does not propagate to the list control or any other sub-control.
FontFamily	Applies to all visible fonts, list items, and pop-up contact cards. Does not apply to menu items and tooltips.
FontWeight	Applies to all visible fonts, list items, and pop-up contact cards. Does not apply to menu items and tooltips.
Padding	Applies to the distance between the border controlled by the BorderBrush and BorderThickness properties, and the actual content of the ContactSearchResultList control.

MyNoteBox

The following properties on MyNoteBox support restyling the control.

Property	Action
Background	Background color is painted to the entire area of the MyNoteBox control.
BorderBrush	Placed around the entire MyNoteBox control. Does not propagate to the list control or any other sub-control.
BorderThickness	Placed around the entire MyNoteBox control. Does not propagate to the list control or any other sub-control.
FontFamily	Applies to all visible fonts, list items, and pop-up contact cards. Does not apply to menu items and tooltips.
FontWeight	Applies to all visible fonts, list items, and pop-up contact cards. Does not apply to menu items and tooltips.
Padding	Applies to the distance between the border controlled by the BorderBrush and BorderThickness properties, and the actual content of the MyNoteBox control.
Foreground	Applies to the text of the note, during editing or not, with a note already set or not.

MyPresenceChooser

The following properties on MyPresenceChooser support restyling the control.

Property	Action
Background	Background color is painted to the entire area behind the split button control.
BorderBrush	Placed around the entire control. Does not propagate to the list control or any other sub-control.
BorderThickness	Placed around the entire control. Does not propagate to the list control or any other sub-control.
FontFamily	Applies to the presence status text. Does not apply to tooltips.
FontWeight	Applies to the presence status text. Does not apply to tooltips.
Padding	Applies to the distance between the border controlled by the BorderBrush and BorderThickness properties, and the actual content of the MyPresenceChooser control.
Foreground	Applies to the text of the note, during editing or not, with a note set or not.
HorizontalContentAlignment	Applies to the position of the presence text within the MyPresenceChooser control.
VerticalContentAlignment	Applies to the position of the presence text within the MyPresenceChooser control.

MyStatusArea

The following properties on MyStatusArea support restyling the control.

Property	Action
Background	Background color is painted to the entire area.
BorderBrush	Placed around the entire control. Does not propagate to the list control or any other sub-control.
BorderThickness	Placed around the entire control. Does not propagate to the list control or any other sub-control.
FontFamily	Applies to all visible fonts, Note control, and PresenceChooser control. Does not apply to tooltips.
FontWeight	Applies to all visible fonts, MyNoteBox control, and MyPresenceChooser control. Does not apply to tooltips.
Padding	Applies to the distance between the border controlled by the BorderBrush and BorderThickness properties, and the actual content of the MyStatusArea control.
Foreground	Applies to the text of the note, during editing or not, with a note set or not. Does not apply to any other text, for example name, or status.