Step 6 of 8: Setting C1TileControl's Property Mappings

In this step you will add the property mappings to the PropertyMapping class using the C1TileControl.PropertyMappings collection editor at design time.

Select the C1TileControl on the form. In the C1TileControl’s Properties window click on the ellipsis button next to the PropertyMappings property. The C1TileControl.PropertyMappings Collection Editor appears.

1. Click Add. A C1.Win.C1Tile.PropertyMapping item will appear like the following.

3. Set the [*]->[None] member PropertyMapping.DataField to ProductID and PropertyMapping.TileProperty to Tag.

4. Click Add and set the [*]->[None] [1] properties to the following:

• PropertyMapping.DataField to CategoryID

• PropertyMapping.Lookup.DataSource to dataSet11

• PropertyMapping.Lookup.DisplayMember to Categories.CategoryName

• PropertyMapping.Lookup.ValueMember to Categories.CategoryID

• The CategoryID is a foreign key pointing to a category record in the Categories table. Here we create a lookup table which takes the CategoryID value in the Products record, and uses that value to navigate the relationship and return the more readable, category name.

• PropertyMapping.TileProperty to Group

This will display the categories name for each group of tiles. For example, Beverages, Condiments, Dairy Products, etc.

5. Click Add and set the [*]->[None] [2] properties to the following:

6. PropertyMapping.DataField to ProductName

7. PropertyMapping.TileProperty to Text

8. This will display the product’s name on each tile. For example, Chai, Chang, etc.

9. Click Add and set the [*]->[None] [3] properties to the following:

   • PropertyMapping.DataField to SupplierID

   • PropertyMapping.Lookup.DataSource to dataSet11

   • PropertyMapping.Lookup.DisplayMember to Suppliers.Country

   • PropertyMapping.Lookup.ValueMember to Suppliers.SupplierID

   • PropertyMapping.TileProperty to Text1

10. This will assign the country name to each tile.

11. Click Add and set the [*]->[None] [4] properties to the following:

• PropertyMapping.DataField

• PropertyMapping.Lookup.DataSource to dataSet11

• PropertyMapping.Lookup.DataMember to Suppliers.Country

• PropertyMapping.Lookup.ValueMember to Suppliers.SupplierID

• PropertyMapping.TileProperty to IntValue

12. Click Add and set the [*]->[None] [5] properties to the following:

13. PropertyMapping.DataField to Discontinue.

• PropertyMapping.TileProperty to BackColor.

The property mappings appear like the following in the members list: