Click here to Skip to main content
Click here to Skip to main content

Programmatically Turning on the Screen Saver

, 20 May 2009 CPL
Rate this:
Please Sign up or sign in to vote.
Learn how to programmatically turn on the screen saver with API via .NET and C#

I have also written this article in my blog, Just Like a Magic.

Overview

This lesson focuses on how to programmatically turn on the screen saver.

Background

In Windows, you can turn it on automatically by leaving the machine inactive for a specific period. You can control this period from the Screen Saver options from the desktop properties dialog. The following figure shows the Screen Saver Settings dialog.

Screen Saver Settings

Programmatically Turning on the Screen Saver

In this section, we will learn how to turn on the screen saver in .NET and C#. Of course you can write the code in any language you prefer, but here we will write it in C#. You can turn on the screen saver by sending the WM_SYSCOMMAND message with the parameter SC_SCREENSAVE. Sending a message can be done using the SendMessage() function that resides in the User32.dll library. The definition of this function is as follows:

LRESULT SendMessage(
    HWND hWnd,
    UINT Msg,
    WPARAM wParam,
    LPARAM lParam
);

This function takes four arguments:

  • hWnd: Handle to the window to send the message to. You can set this argument to a window handle, the desktop handle (HWND_DESKTOP), or the handle for all top-level windows (HWND_BROADCAST).
  • Msg: The message to send.
  • wParam: Additional message-specific options.
  • lParam: Additional message-specific options.

This function returns a value specific to the message sent. Usually, it returns non-zero if it succeeds or zero otherwise. Here is the full code:

[DllImport("User32.dll")]
public static extern int SendMessage
    (IntPtr hWnd,
    uint Msg,
    uint wParam,
    uint lParam);

public const uint WM_SYSCOMMAND = 0x112;
public const uint SC_SCREENSAVE = 0xF140;

public enum SpecialHandles
{
    HWND_DESKTOP = 0x0,
    HWND_BROADCAST = 0xFFFF
}

public static void TurnOnScreenSaver()
{
    SendMessage(
        new IntPtr((int)SpecialHandles.HWND_BROADCAST),
        WM_SYSCOMMAND,
        SC_SCREENSAVE,
        0);
}

Code Explanation

First, we created our PInvoke method. This method is decorated by the DllImportAttribute attribute specifying the library which the method resides in. Also PInvoke methods must be declared as "static" and "extern". Because LRESULT is defined as a signed 32-bit integer, it is marshaled as System.Int32 in .NET. Also, because System.IntPtr is the best type for marshaling any Win32 raw handle, we have used it for the first argument. UINT, WPARAM, AND LPARAM are all defined as an unsigned 32-bit integer, so we have marshaled them as System.UInt32. HWND_BROADCAST represents the handle for all top-level windows, so we have sent them the order to turn on the screen saver.

PInvoke stands for Platform Invocation, it is the process of creating a wrapper for the .NET to interact with unmanaged functions.

Marshaling is the process of creating a bridge between .NET types and unmanaged types.

You can use PostMessage() in place of SendMessage() if you want to send the message asynchronously and don't want to wait for a response.

History

  • 20th May, 2009: Initial post

License

This article, along with any associated source code and files, is licensed under The Common Public License Version 1.0 (CPL)

Share

About the Author

Mohammad Elsheimy
Technical Writer Just Like a Magic
Egypt Egypt
Independent technical writer from Egypt born in 1991.
 
I am a student of The Holy Quranic Sciences Institute. There, we study the Holy Quranic sciences and Islamic legislation.
 
I currently run two sites:
Follow on   Twitter

Comments and Discussions

 
QuestionProgramatically inhibiting the screensaver PinmemberSharjith17-Nov-11 10:14 
GeneralTurning on the screen saver Pinmemberandywawa2-Feb-11 0:25 
Questionstart the screensaver ? Pinmembergillardg21-May-09 4:10 
AnswerRe: start the screensaver ? PinmemberMohammad Elsheimy21-May-09 8:06 
Another way.
But, what if wanna to start the default screen saver.
May I need to access the registry?
 
Regards,
Mohammad Elsheimy
 
---------------------------
Just Like a Magic
http://JustLikeAMagic.Wordpress.com

GeneralGreat Example Pinmembertaloweb20-May-09 21:33 
GeneralRe: Great Example PinmemberMohammad Elsheimy21-May-09 8:07 
QuestionWhere's the code? PinmemberDewey20-May-09 15:50 

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

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

| Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.1411028.1 | Last Updated 20 May 2009
Article Copyright 2009 by Mohammad Elsheimy
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid