Skip to main content

TabPageItem.HeaderIcon Property

Gets an icon displayed in the item header.

Namespace: DevExpress.XamarinForms.Navigation

Assembly: DevExpress.XamarinForms.Navigation.dll

NuGet Package: DevExpress.XamarinForms.Navigation

Declaration

public ImageSource HeaderIcon { get; }

Property Value

Type Description
ImageSource

The item header icon’s source.

Remarks

In the item’s header, the TabPage displays the icon and text assigned to the Icon and Title properties of the item’s Content page.

The tab item’s HeaderIconColor and SelectedHeaderIconColor properties allow you to specify colors used to paint the header icon depending on whether the item is selected or not.

Tab Item Sample

Example

The following code configures a TabPage‘s item according to Material Design guidelines.

<dxn:TabPage xmlns="http://xamarin.com/schemas/2014/forms"
         xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
         xmlns:local="clr-namespace:TabPageExample"
         xmlns:dxn="http://schemas.devexpress.com/xamarin/2014/forms/navigation"
         x:Class="TabPageExample.MainPage">
    <dxn:TabPageItem HeaderFontSize="14"
                     HeaderFontAttributes="Bold"
                     HeaderTextColor="#99191919"
                     HeaderIconColor="#99191919"
                     HeaderIconPosition="Top"
                     HeaderIconSpacing="4"
                     HeaderWidth="*"
                     HeaderMinWidth="90"
                     HeaderMaxWidth="360"
                     HeaderPadding="16,0,16,0"
                     HeaderVisibleElements="TextAndIcon"
                     SelectedHeaderTextColor="#1e88e5"
                     SelectedHeaderIconColor="#1e88e5"
                     SelectedHeaderBackgroundColor="Transparent">
        <dxn:TabPageItem.Content>
            <ContentPage Title="MAIL" Icon="ic_mail.png">
                <Label Text="Mail List Here" 
                       HorizontalOptions="Center" 
                       VerticalOptions="CenterAndExpand"/>
            </ContentPage>
        </dxn:TabPageItem.Content>
    </dxn:TabPageItem>
</dxn:TabPage>

The markup above uses the following properties of the TabPageItem object:

Property

Description

HeaderFontSize

Gets or sets the size of the font for the item header’s text.

HeaderFontAttributes

Gets or sets a value that indicates whether the font for the item header’s text is bold, italic, or neither.

HeaderTextColor

Gets or sets the color the tab item uses in the default state to paint its header text.

HeaderIconColor

Gets or sets the color the tab item uses in the default state to paint its header icon.

HeaderIconPosition

Gets or sets the position of the icon relative to the text in the item header.

HeaderIconSpacing

Gets or sets spacing between the icon and the text in the item header.

HeaderWidth

Gets or sets the item header width when TabView.HeaderPanelPosition is set to Top or Bottom.

HeaderMinWidth

Gets or sets the minimum width of the item header when TabView.HeaderPanelPosition is set to Top or Bottom.

HeaderMaxWidth

Gets or sets the maximum width of the item header when TabView.HeaderPanelPosition is set to Top or Bottom.

HeaderPadding

Gets or sets the inner padding of the item header.

HeaderVisibleElements

Gets or sets a value that specifies elements the item header shows.

SelectedHeaderTextColor

Gets or sets the color the tab item uses in the selected state to paint its header text.

SelectedHeaderIconColor

Gets or sets the color the tab item uses in the selected state to paint its header icon.

SelectedHeaderBackgroundColor

Gets or sets the background color of the tab item header in the selected state.

Content

Gets or sets a page that the TabPage displays in the content area when the item is selected.

Note

TabPage contains the majority of the visual settings that TabPageItem provides. TabPage’s properties simultaneously configures the appearance of all tab items the page contains.

See Also