APPENDIX D

Custom Screen Template View IDs

When you’re writing a custom screen template (as discussed in Chapter 13), you can call the host generator methods to add content items onto your screen. Once you’ve done this, you can call the SetContentItemView method to change the control that renders your data item. In effect, the SetContentItemView method provides the code equivalent of you using the drop-down box that appears next to a data item in the screen designer to select a different control type. Let’s say that you’ve added a local screen property called screenPropertyContentItem and want to change the control type from an autocomplete box (the default control) to a Rows Layout, here’s the code that you would use:

host.SetContentItemView(screenPropertyContentItem, "Microsoft.LightSwitch:RowsLayout");

"Microsoft.LightSwitch:RowsLayout" is the ViewID that identifies the RowsLayout control type. When you’re writing a custom screen template, you’ll need to know what ViewIDs to use, and this is summarized in the following table. The ViewIDs that you need to use will vary depending on whether the user has upgraded  their project to use the HTML client, and this is shown in the following table.