Click here to Skip to main content
15,860,861 members
Articles / Programming Languages / C#
Article

Use the Free USkin Toolkit to Skin your Application

Rate me:
Please Sign up or sign in to vote.
3.39/5 (51 votes)
10 Nov 2008CPOL4 min read 1.7M   43.2K   208   181
USkin provides a free library and tools to developers for easily adding skins to their software UI.

The current version (V3.0 beta) does not need skinbuilder, the next version will provide one.

Sample Image

Introduction

As we know, Windows XP adds support for themes for applications. When we change the Windows theme, all the Windows standard applications change into the same theme. How can we add skin support to our own software and make our software different from others? Here, I suggest a way: use the USkin toolkit.

Why USkin?

  1. Saves your development time. You don't have to care too much about your software UI. After finishing your functions, add three lines of code to support a skin. It's very easy, and will save you time.
  2. Makes your app look and feel good:), that's it.
  3. Supports color themes. This can make a skin file look like a 100 different skins. Save your UI design time.
  4. USkin provides a free version. Save your money!
  5. Free powerful SkinStudio included that you can use to design your own skin file.

Image 2

USkin Features

  • Supports more than 20 Windows standard controls
  • Supports system standard dialogs, such as file dialogs, color dialogs, print dialogs
  • Supports custom defined controls/third party controls
  • Supports WYSIWYG style skin file editing
  • Supports MDI/SDI/Dialog style apps
  • Supports window blinds skin file importing. More than 10000 skin files can be used
  • Supports color themes
  • Supports VC/SDK/VB/.NET, no language limitations
  • Supports multithreading
  • Supports changing skin at runtime
  • Supports all popup menus, including the edit control context menu!
  • Only two lines required to add skin support
  • Supports all scrollbar skins
  • Small skin file size, around 30 KB

Using the Code

Using USkin functions is very easy. Let's begin.

First, include the USkin.h file in your app:

C++
#include "uskin.h"

Then, in the InitInstance function, call USkinInit to initiate the USkin library:

C++
BOOL CSDIApp::InitInstance()
{
    InitCommonControls();

    CWinApp::InitInstance();

    if (!AfxOleInit())
    {
        AfxMessageBox(IDP_OLE_INIT_FAILED);
        return FALSE;
    }
    AfxEnableControlContainer();
    // Init USkin lib and load media skin file
    USkinInit(NULL,NULL,_T("..\\Skins\\vista.msstyles"));
    SetRegistryKey(_T("Local App"));
    LoadStdProfileSettings(4);

    CSingleDocTemplate* pDocTemplate;
    pDocTemplate = new CSingleDocTemplate(
        IDR_MAINFRAME,
        RUNTIME_CLASS(CSDIDoc),
        RUNTIME_CLASS(CMainFrame),
        RUNTIME_CLASS(CSDIView));
    if (!pDocTemplate)
        return FALSE;
    AddDocTemplate(pDocTemplate);

    this->RegisterShellFileTypes();
    TCHAR sz[500];
    ::GetModuleFileName(NULL,sz,500);
    AfxMessageBox(sz);

    CCommandLineInfo cmdInfo;
    ParseCommandLine(cmdInfo);

    if (!ProcessShellCommand(cmdInfo))
        return FALSE;

    m_pMainWnd->ShowWindow(SW_SHOW);
    m_pMainWnd->UpdateWindow();

    //if you want do your own subclass,call USkinInit here
    //USkinInit(NULL,NULL,_T("vista.msstyles"));

    return TRUE;
}

In the end, call USkinExit before your app exits:

C++
int CSDIApp::ExitInstance()
{
    USkinExit();
    return CWinApp::ExitInstance();
}

Using the Code in .NET

The sample code is in C#. You can easily change to other .NET languages. OK, let's begin. First add USkinSDK.cs to your project. Then in the Main entry, add one line of code like this:

C#
//First Declare a skin object
    [STAThread]
	static void Main()
	{
        USkinSDK.USkinInit("", "", "..\\Skins\\DiyGreen.msstyles");
		Application.Run(new Form1());
	}
}

For skinning the Button (GroupBox, CheckBox, RadioButton) object correctly, you need to change the FlatStyle property into System.

The resulting screen will look like this:

Image 3

Points of Interest

This article does not focus on the technical side of the implementation. If you want to know how it works, you can try these CodeProject articles:

History

  • Updates in version 3.0 beta [2008-11-10]
    • New render engine. I rewrote the core render engine such that it is faster, of high quality, and safer.
    • Added Microsoft Window's Theme file format (*.msstyles) support. The user does not need to convert or edit the skin file. There are many skin files to use.
    • Added Multi-Monitor support.
    • Fixed USkin2.2 known bugs.
    • Removed custom draw functions in this version because it was using the Microsoft theme file.
  • Updates in version 2.2 [2006-08-07]
    • Fixed the menubar update error.
    • Added the USkinUpdateMenuBar function. When the user modifies the menu by USkinGetMenu, the user should call USkinUpdateMenuBar to update the menubar.
    • Added RightToLeft text support.
    • Added Winamp like player sample.
    • USkin file format compatible.
    • Enhanced the SkinBuilder.
    • Added SkinBuilder Help document.
    • Added multilanguage support to SkinBuilder.
    • Enhanced ScrollBar control.
  • Updates in version 2.1
    • Fixed the MultiLine style in Button/CheckBox/RadioBox.
    • Added .NET skin support. Now you can use USkin with your .NET applications!
    • Added a new library called USkinCom. Easy for .NET use.
    • Added two C# samples. One is MDI, the other is SDI. You can see the power of USkin in these samples.
    • Added color replace feature. Now, you can replace standard system colors.
    • Enhanced the USkinApplyColorTheme function. Everything will change when calling the USkinApplyColorTheme function.
    • Added the USkinDrawFrameControl function to replace the standard DrawFrameControl.
    • Added six skin files to the pack. All skin files are carefully edited.
    • Enhanced many functions.

Special Thanks

  • Thanks to The Code Project for providing a good platform for developers
  • Thanks to you guys who use uskin
  • Thanks AlecJames - He found a multi-monitor bug. Sorry man, I took a long time to make v3.0

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Web Developer
China China
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
Generalwould you support unicode version,pls Pin
rabbiruby21-Aug-09 0:05
rabbiruby21-Aug-09 0:05 
Questionwhy Windows xp can not run under the correct Pin
maotree7-Aug-09 13:36
maotree7-Aug-09 13:36 
Generalvb 2008 sqlCE problem Pin
Roxdes16-Jul-09 23:15
Roxdes16-Jul-09 23:15 
QuestionHow to exclude controls from skinning? Pin
User 58422374-Jul-09 0:02
User 58422374-Jul-09 0:02 
GeneralCommand Line Argu Pin
john563221-Apr-09 20:06
john563221-Apr-09 20:06 
QuestionCompatible with MS Visual Studio 2008? Pin
hoe198615-Mar-09 5:48
hoe198615-Mar-09 5:48 
AnswerRe: Compatible with MS Visual Studio 2008? Pin
Transgenic7-Jan-10 6:42
Transgenic7-Jan-10 6:42 
GeneralUse it(V3.0 beta) with MFC Grid control 2.26 Pin
hbg03085-Feb-09 17:52
hbg03085-Feb-09 17:52 
hi,

i try to use it(V3.0 beta) with MFC Grid control 2.26,when the configuration is debug,error dispaly.but release will not. why?
Please let me know how can I resolve the problem.

Thanks in advance!!!
GeneralRe: Use it(V3.0 beta) with MFC Grid control 2.26 Pin
thirdwolf5-Feb-09 22:31
thirdwolf5-Feb-09 22:31 
GeneralC#停靠栏(自适应的)被菜单盖住了一部分 Pin
jokerangel198221-Dec-08 17:20
jokerangel198221-Dec-08 17:20 
Generalcan't download USkinDemo.zip Pin
kryptun18-Dec-08 11:41
kryptun18-Dec-08 11:41 
GeneralStyle not applied to all parts of application. Pin
ashesman30-Nov-08 21:09
ashesman30-Nov-08 21:09 
GeneralRe: Style not applied to all parts of application. Pin
thirdwolf30-Nov-08 23:19
thirdwolf30-Nov-08 23:19 
GeneralRe: Style not applied to all parts of application. Pin
ashesman1-Dec-08 8:43
ashesman1-Dec-08 8:43 
GeneralRe: Style not applied to all parts of application. Pin
thirdwolf1-Dec-08 21:00
thirdwolf1-Dec-08 21:00 
GeneralRe: Style not applied to all parts of application. Pin
ricomp27-Feb-09 4:44
ricomp27-Feb-09 4:44 
GeneralRe: Style not applied to all parts of application. Pin
ashesman27-Feb-09 7:54
ashesman27-Feb-09 7:54 
GeneralRe: Style not applied to all parts of application. Pin
Jean-Francois Goulet20-Jul-09 5:42
Jean-Francois Goulet20-Jul-09 5:42 
GeneralRe: Style not applied to all parts of application. Pin
jberenguer15-Sep-09 7:06
jberenguer15-Sep-09 7:06 
GeneralUSkin Develope Progress Pin
thirdwolf30-Nov-08 14:53
thirdwolf30-Nov-08 14:53 
GeneralRegd: FUISkinStudio Pin
techiearc24-Nov-08 4:01
techiearc24-Nov-08 4:01 
GeneralRe: Regd: FUISkinStudio Pin
thirdwolf24-Nov-08 17:01
thirdwolf24-Nov-08 17:01 
GeneralRE: Couple of questions Pin
jberenguer20-Nov-08 4:17
jberenguer20-Nov-08 4:17 
GeneralRe: RE: Couple of questions Pin
thirdwolf20-Nov-08 14:39
thirdwolf20-Nov-08 14:39 
GeneralRe: RE: Couple of questions Pin
jberenguer21-Nov-08 9:45
jberenguer21-Nov-08 9:45 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.