Click here to Skip to main content
15,861,168 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

 
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 
Hi,

I have a similar effect: My application is a c# project which shows a main window. On button press I open further windows that are created over a COM mechanism. Some of the new windows are from projects also written in C#, others are written in VB6 btw. C++. The skinning is started before the first window opens.

Now the effect: On some machines, the skinning works in all windows like expected. But on some other machines only the VB6 and c++ dialogs get fully skinned - in the C# dialogs the window border is still the windows default luna.

Do you have any idea what could be the reason?

I've tried to find out what's the difference between the machines but found nothing helpful.
But I can observe the same effect if I start the application in visual studio debugger: If I enable "unmanaged debugging" then all works fine, but when I debug without this option then all looks like described above.

Perhaps you can reproduce this with the debugger.
Help ist apprecated.
Thanks,
Jan
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 
GeneralRe: RE: Couple of questions Pin
thirdwolf24-Nov-08 16:59
thirdwolf24-Nov-08 16:59 
GeneralRe: RE: Couple of questions Pin
jberenguer25-Nov-08 4:46
jberenguer25-Nov-08 4:46 
GeneralRE: Couple of questions Pin
jberenguer3-Mar-09 16:44
jberenguer3-Mar-09 16:44 
GeneralIS 高薪诚聘UI界面 VC++开发高级工程师. Pin
roger_long6-Nov-08 17:42
roger_long6-Nov-08 17:42 
GeneralUnable to register dll Pin
techiearc28-Oct-08 19:15
techiearc28-Oct-08 19:15 
GeneralRe: Unable to register dll Pin
thirdwolf9-Nov-08 15:43
thirdwolf9-Nov-08 15:43 
GeneralRE: Latest Version Pin
jberenguer19-Oct-08 14:17
jberenguer19-Oct-08 14:17 
GeneralRe: RE: Latest Version Pin
thirdwolf9-Nov-08 15:50
thirdwolf9-Nov-08 15:50 

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.