</ iframe > </noscript> <!-- End Google Tag Manager (noscript) --> <div id="BeforeHeaderContent"> </div> <div id="HeaderContent"> <div id="ProjectTitle">Themes for WinForms</div> <div id="PageTitle"><div id="PageTitleText">Applying a Built-In Theme to your Application</div></div> </div> <div id="AfterHeaderContent"> <!-- Spacing --> <span id="ToggleAllSectionsLink" class="FunctionLink"> <label id="CollapseAllLabel">Collapse All</label> <label id="ExpandAllLabel" style="display: none;">Expand All</label> </span> </div> <div class="BreadcrumbsContainer"><table><tr><td> <a href="QuickStartIntro.html">Themes for WinForms Quick Start</a> > Applying a Built-In Theme to your Application</td></tr></table></div> <div id="BodyContent"> <p class="MsoBodyText">To simply theme the controls in your application use C1ThemeController like the following:</p> <ol> <li> <div> Open a form belonging to your application in the Visual Studio's forms designer. In this example we will open a ComponentOne WinForms sample, <strong>SimpleTextEditor.</strong> </div> </li> <li> <div> From the designer's toolbox, drag a C1ThemeController and drop it on your form. (The C1ThemeController is provided by the C1.Win.C1Themes.4 assembly; if you don't see it in your toolbox you can add it manually). </div> <div style="WIDTH: 100%"> <table class="hs-box"> <tbody> <tr> <td class="hs-box-icon" valign="top"><img src="images/hs-note.gif"></td> <td class="hs-box-content" valign="top"><strong>Note:</strong> Reference to C1.C1Zip.4.dll is required in a project that uses C1ThemeController.</td> </tr> </tbody> </table> </div>A ThemeController dialog box appears.<br> <br> <img border="0" alt="" src="DocumentGraphics/QSThemeController.png"> <div align="left"></div> </li> </ol> <blockquote style="MARGIN-RIGHT: 0px" dir="ltr"> <p class="C1HContinue">This enables you to select the application-wide default theme, the current controller’s default theme, and themes for all supporting controls already on the form. Note: The same dialog is also available via the <strong>Set Themes</strong> action on the C1ThemeController tasks menu.</p> <p dir="ltr">Initially in the dialog that pops up, the theme is specified as "(none)" for all supporting controls already on the form. This is done to prevent unintentional loss of property settings on those controls.</p> </blockquote> <ol style="COUNTER-RESET: item 2" start="3"> <li> <div> Click the <strong>All to (default)</strong> button in the dialog so that the default theme is set on all controls. If you have deliberately customized some of the controls already this will not need to be done. </div> </li> </ol> <blockquote> <div style="WIDTH: 100%"> <table class="hs-box"> <tbody> <tr> <td class="hs-box-icon" valign="top"><img src="images/hs-note.gif"></td> <td class="hs-box-content" valign="top"> (When new controls are dropped on the form already containing a C1ThemeController component, theme is set to "(default)" on them automatically.)</td> </tr> </tbody> </table> </div> </blockquote> <p> </p> <blockquote style="MARGIN-RIGHT: 0px" dir="ltr"> <p><img border="0" alt="" src="DocumentGraphics/QSAllToDefaultResult.png"></p> </blockquote> <ol style="COUNTER-RESET: item 3" start="4"> <li> <div> Select the default application theme from the list of available prebuilt themes. For example, This theme name will be automatically stored in the App.config file. </div> </li> </ol> <blockquote style="MARGIN-RIGHT: 0px" dir="ltr"> <p><img border="0" alt="" src="DocumentGraphics/QS3DefaultTheme.png"></p> </blockquote> <ol style="COUNTER-RESET: item 3" start="4"> <li> <div class="C1HNumber" style="mso-list: l0 level1 lfo1"> Leave the theme on the current theme controller ('c1ThemeController1 theme') at its default "(default)" value (which means that the application theme, <strong>GreenHouse</strong>, will be used). </div> </li> <li> <div class="C1HNumber" style="mso-list: l0 level1 lfo1"> Click the <strong>All to (default)</strong> button as mentioned above, to set the default theme on all supporting controls on the form. </div> </li> <li> <div class="C1HNumber" style="mso-list: l0 level1 lfo1"> Finally, click the <strong>OK</strong> button to close the dialog and apply the specified<span style="mso-spacerun: yes"> </span>theme to the controls on the form. </div> </li> <li> <div class="C1HNumber" style="mso-list: l0 level1 lfo1"> If your application contains multiple forms, repeat the steps above (with the exception of specifying the default ApplicationTheme as it will already be pre-selected for you) for all forms in your application. </div> </li> </ol> <p class="C1HContinue">When you are done, the selected application theme will be applied to controls on your forms both at design and runtime.</p> <p class="C1HContinue">The following image illustrates the GreenHouse theme applied to the SimpleTextEditor application:</p> <p class="C1HContinue"><img border="0" alt="" src="DocumentGraphics/QSSimpleThemeResult.png"></p> <a name="seealsobookmark"></a> </div> <div id="FooterContent"> <p> </p><p> </p><hr style="height: 1px"><p>Copyright © <script type="text/javascript"> var theDate=new Date() document.write(theDate.getFullYear()) </script> GrapeCity, inc. All rights reserved. <script> $(document).ready(function() { if (!(window.self !== window.top)) { // Not running in a frameset // Get the page name var pageName = location.href.substring(location.href.lastIndexOf("/") + 1); if (pageName.indexOf("#") != -1) { pageName = pageName.substring(0, pageName.indexOf("#")); } // Append to webframe.html var framePage = "webframe.html#" + pageName; location.href = framePage; } }); </script> </p> <a target="_blank" href="http://our.componentone.com/groups/">Product Support Forum</a> | <a target="_blank" href="http://feedback.componentone.com/forums/255782-winforms-documentation">Documentation Feedback</a> </div> </body> </html>