Mastermind

Overview

This Windows Embedded Compact Silverlight sample application tutorial describes how to build and run the Mastermind code sample. This Microsoft code sample includes the C++ and XAML code that is required for a user to play a game that resembles the code-breaking game Mastermind against the computer. Note The name "Mastermind," the toy, and distinctive likenesses thereof are the properties of Hasbro Inc. This article describes an unofficial, not-for-profit version that is not endorsed by Hasbro in any way. Figure 1 Game Screen
When you build and run the Mastermind code sample, you step through the process of creating an OS design that supports Silverlight; building a Microsoft Expression Blend project and integrating it into a Silverlight application; and running the Silverlight application on a virtual CEPC (vCEPC).

Prerequisites

Visual Studio 2008 and Visual Studio 2008 Service Pack 1 (SP1) installed on your computer Windows Embedded Compact 7 installed on your computer A Virtual CEPC project that includes an OS design that is based on the Handheld Design Template and the Silverlight for Windows Embedded Compact (SYSGEN_XAML_RUNTIME) catalog item Microsoft Expression Blend 3 installed on your computer prior to installing Windows Embedded Compact 7 (required if you want to edit the Expression Blend portion of the Mastermind project)

Build and Run the Sample

Step 1: Create a Virtual CEPC OS Design That Supports Silverlight
If you already have a vCEPC OS design that supports Silverlight, you can skip to step 2. Otherwise, you can create a vCEPC OS design that supports Silverlight by following the instructions at Getting Started with Virtual CEPC. If you are following the instructions in the Getting Started with Virtual CEPC article, be sure to follow the step that adds Silverlight for Windows Embedded to your OS design. Follow all the steps until you reach the step in which you create a Platform Builder subproject. Dont create the subproject; instead, you will add the subproject that is included in this sample to the OS design as described in step 3.
Step 2: Copy the Code Sample Project Folder to Your Computer
To use the code sample at MSDN Code Gallery (http://go.microsoft.com/fwlink/?LinkId=219830) with your run-time image, you must download the code sample to your computer. To download the code sample project from MSDN Code Gallery 1. Follow the instructions on the MSDN Code Gallery webpage to download the.zip file that contains the code sample. 2. Extract the contents of the.zip file to %_WINCEROOT%\OSDesigns\<YourOSDesignName>, where <YourOSDesignName> is the name of the Silverlight OS design you created in step 1. Extracting the.zip file creates two new subdirectories: %_WINCEROOT%\OSDesigns\<YourOSDesignName>\Mastermind %_WINCEROOT%\OSDesigns\<YourOSDesignName>\BlendPrj
Step 3: Add the Code Sample Project as an Existing Project to Your OS Design
To run the Silverlight code sample on Windows Embedded Compact, you must first add the code sample to an OS design. To add the code sample to your OS design 1. Open Visual Studio 2008.
2. Open the vCEPC OS design project that you created in step 1. 3. In Solution Explorer, right-click Subprojects, and then click Add Existing Subproject. 4. Browse to MastermindGame.pbpxml in %_WINCEROOT%\OSDesigns\<YourOSDesignName>\Mastermind\ and then click Open.
Step 4: Build the Code Sample in Platform Builder
To run the Silverlight code sample on Windows Embedded Compact, you must build the code sample after you add it to your OS design. To run the code sample on a vCEPC 1. In Solution Explorer, expand Subprojects. 2. Right-click MastermindGame, and then click Build. 3. In the Output window, verify that the build succeeded.
Step 5: Run the Code Sample on a Virtual CEPC
You can run the Silverlight code sample on the vCEPC project you created in step 1. To run the code sample on a vCEPC 1. Open the Virtual PC console and start the instance of Virtual CEPC that you created in step 1. 2. In Visual Studio 2008, on the Target menu, click Attach Device to open the Ethernet Download Settings dialog box. 3. When your vCEPC appears in the Active target devices dialog box, click Apply. Visual Studio downloads your OS design. 4. When your OS design is running on the vCEPC, in Visual Studio 2008, on the Target menu, click Run Programs. Select MastermindGame.exe from the list, and then click Run. Tip If Virtual CEPC doesnt start, see the Troubleshooting section in Getting Started with Virtual CEPC.

Step 6: (Optional) Modify the Expression Blend Project and Then Rebuild the Code Sample
You can modify the UI for the Mastermind code sample and then update your OS project with the changes. To modify the UI 1. In Expression Blend 3, open the Mastermind.sln file located at %_WINCEROOT%\OSDesigns\<YourOSDesignName>\BlendPrj. 2. After you make the necessary changes, save the Expression Blend project. You do not need to rebuild the Expression Blend project to import your changes to your OS design subproject.
Tip If you have the Mastermind UI XAML file open in Visual Studio, Visual Studio displays a dialog box that asks you to reload one or more XAML files after saving the Expression Blend project. Although the MastermindGame subproject shares the Mastermind UI XAML files with the Expression Blend project, you should run Windows Embedded Silverlight Tools to ensure all of your changes to the UI have propagated to the MastermindGame subproject code files. To update the code sample project with your UI changes Windows Embedded Silverlight Tools incorporates changes to your Expression Blend project to your OS design subproject, and then updates the subproject code files as necessary. For Windows Embedded Silverlight Tools to update your subproject, it needs to be able to detect which subproject to update. 1. To indicate that the MastermindGame subproject is the correct subproject to update, select any of the code files in that project. 2. In Visual Studio 2008, on the Tools menu, click Windows Embedded Silverlight Tools, and then click Update Silverlight for Windows Embedded Project. You can verify your changes to the UI by rebuilding the subproject and then rerunning the application. To verify changes to the UI 1. If no errors are reported in the Summary Report Change Log, rebuild the subproject by following the instructions in step 4 and then rerun the application by following the instructions in step 5. You will be able to see the result of your UI changes in the running Mastermind application.
Mastermind Game Code Files
The Mastermind files are organized as follows:

BlendPrj\

Contains the Expression Blend user interface project for the Mastermind game The Mastermind UI Expression Blend solution file. The game shell. A reusable control that represents a row in which the player can make a guess and then receive feedback on their guess.

Mastermind.sln

MainPage.xml PlayerguessRow.xaml

MastermindGame\

Contains the game logic and user interface code Windows Embedded Silverlight Tools creates this file when you import the Expression Blend project that contains the Mastermind game UI. Contains the application object and the start and shutdown code. You use the GetWindowParameters() function to make the title bar visible and to customize it by adding a minimize button.

App.cpp

MainPage.cpp
Handles the Guess button click, which interfaces with the game logic about the players guess, displays the results of the guess, and handles game win or loss. The UI uses the GuessButton_Click() function to make calls to drive the game logic.

MastermindLogic.cpp

Contains the game logic that evaluates the players guesses and determines when the game is won or lost. Built by Silverlight. Contains the IDS_APP_TITLE string, which you can modify to change the text that appears on the Mastermind game title bar. Contains the event handling code by which the player can type a guess into the current Mastermind guessing row.

MastermindGame.rc

PlayerGuessRow.cpp
Tip To find code that is specific to the Mastermind game - that is, code that isnt boilerplate code generated by the project designer or by Windows Embedded Silverlight Tools - in the source code files, search for #pragma region Mastermind Specific.

Additional Resources

Windows Embedded website A Sample Application Tutorial Using Windows Embedded Silverlight Tools

Copyright

This document is provided as-is. Information and views expressed in this document, including URL and other Internet Web site references, may change without notice. You bear the risk of using it. This
document does not provide you with any legal rights to any intellectual property in any Microsoft product. You may copy and use this document for your internal, reference purposes. 2011 Microsoft. All rights reserved.