Step 1 of 3: Creating an Application with a C1TileListBox Control

In this step, you'll create a Windows Phone application in Visual Studio using TileListBox for Windows Phone.

Complete the following steps:

1.   In Visual Studio, select File | New | Project to open the New Project dialog box.

2.   In the New Project dialog box, select a language in the left pane, and in the templates list select Windows Phone Application. Enter a Name for your project and click OK. The New Windows Phone Application dialog box will appear.

3.   Click OK to close the New Windows Phone Application dialog box and create your project.

4.   Right-click the project in the Solution Explorer and select Add Reference.

5.   In the Add Reference dialog box, locate and select the C1.Phone.dll assembly and select OK.

6.   Add the XAML namespace to the <phone:PhoneApplicationPage> tag by adding xmlns:c1="clr-namespace:C1.Phone;assembly=C1.Phone" so it appears similar to the following:

<phone:PhoneApplicationPage x:Class="C1WP.MainPage"  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:phone="clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone" xmlns:shell="clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone" xmlns:d="http://schemas.microsoft.com/expression/blend/2008" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" xmlns:c1="clr-namespace:C1.Phone;assembly=C1.Phone" mc:Ignorable="d" d:DesignWidth="480" d:DesignHeight="768" FontFamily="{StaticResource PhoneFontFamilyNormal}" FontSize="{StaticResource PhoneFontSizeNormal}" Foreground="{StaticResource PhoneForegroundBrush}" SupportedOrientations="Portrait" Orientation="Portrait" shell:SystemTray.IsVisible="True">

7.   Edit the TitlePanel content to change the text in the TextBlock controls. It will appear similar to the following:

<!--TitlePanel contains the name of the application and page title-->

<StackPanel x:Name="TitlePanel" Grid.Row="0" Margin="12,17,0,28">

    <TextBlock x:Name="ApplicationTitle" Text="ComponentOne Studio for Windows Phone" Style="{StaticResource PhoneTextNormalStyle}"/>

    <TextBlock x:Name="PageTitle" Text="TileListBox" Margin="9,-7,0,0" Style="{StaticResource PhoneTextTitle1Style}"/>

</StackPanel>

8.   In the XAML window of the project, place the cursor between the <Grid x:Name="ContentPanel"></Grid> tags and click once.

9.   Add the following <c1:C1TileListBox> tag to add and the control:

<c1:C1TileListBox x:Name="tileListBox" ItemsSource="{Binding}" ItemWidth="130" ItemHeight="130"></c1:C1TileListBox>

This gives the control a name, sets the ItemsSource property (you'll customize this in code in a later step), and sets the size of the control.

10.  Add markup between the <c1:C1TileListBox> and </c1:C1TileListBox> tags so it looks like the following:

<c1:C1TileListBox x:Name="tileListBox" ItemsSource="{Binding}" ItemWidth="130" ItemHeight="130">

    <c1:C1TileListBox.PreviewItemTemplate>

        <DataTemplate>

            <Grid Background="Gray" />

                </DataTemplate>

                </c1:C1TileListBox.PreviewItemTemplate>

                <c1:C1TileListBox.ItemTemplate>

                <DataTemplate>

                <Grid Background="LightBlue">

                    <Image Source="{Binding Thumbnail}" Stretch="UniformToFill" />

                    <TextBlock Text="{Binding Title}" Margin="4 0 0 4" VerticalAlignment="Bottom" />

               </Grid>

        </DataTemplate>

    </c1:C1TileListBox.ItemTemplate>

</c1:C1TileListBox>

This markup adds data templates for the C1TileListBox control's content. Note that you'll complete binding the control in code.

What You've Accomplished

You've successfully created a Windows Phone application containing a C1TileListBox control. In the next step, Step 2 of 3: Adding Data to the TileListBox, you will add data for C1TileListBox.