Use properties on Lync Controls to control the appearance of a control. In this topic see the Lync Controls that can be restyled, and the properties that control styling on each control.

Properties Used to Change Control Style

Lync Controls and the properties that support restyling are listed in this section.

ContactList

The following properties on ContactList support restyling the control.

Property

Behavior

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

Behavior

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

Behavior

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

Behavior

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 left-side-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's icon.

ContactCard

The following properties on ContactCard support restyling the control.

Property

Behavior

Background

Background color is painted to the entire area including tab content and the tab itself, and is placed 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

Behavior

Background

Background color is painted to the entire area shown behind the textbox. The textbox 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

Behavior

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

Behavior

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

Behavior

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

Behavior

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, the MyNoteBox and MyPresenceChooser controls. 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.

See Also

Other Resources