RunCPL procedure
Shell utilities routines
Return to Introduction  Previous page  Next page
Unit
acUtils  

Declaration
procedure RunCPL(FileName: String; CmdShow: Integer = SW_SHOWNORMAL);  

Description
The RunCPL routine executes the CPL files which used for system settings in Control Panel. FileName parameter specifies the CPL file name ('something.cpl') and CmdShow parameter specifies how a CPL window is to be shown.  

Parameters
FileNameCPL file name. For example, 'desk.cpl' (Display properties) or 'intl.cpl' (Regional settings properties)  
CmdShowSpecifies how the window is to be shown. The default value in this parameter is SW_SHOWNORMAL, but the possible values are following:  
 Value   Meaning  
 SW_HIDE   Hides the window and activates another window.  
 SW_MAXIMIZE   Maximizes the specified window.  
 SW_MINIMIZE   Minimizes the specified window and activates the next top-level window in the Z order.  
 SW_RESTOREActivates and displays the window. If the window is minimized or maximized, Windows restores it to its original size and position. An application should specify this flag when restoring a minimized window.  
 SW_SHOW   Activates the window and displays it in its current size and position.  
 SW_SHOWDEFAULTSets the show state based on the SW_ flag specified in the STARTUPINFO structure passed to the CreateProcess function by the program that started the application.  
 SW_SHOWMAXIMIZEDActivates the window and displays it as a maximized window.  
 SW_SHOWMINIMIZEDActivates the window and displays it as a minimized window.  
 SW_SHOWMINNOACTIVEDisplays the window as a minimized window. The active window remains active.  
 SW_SHOWNA   Displays the window in its current state. The active window remains active.  
 SW_SHOWNOACTIVATEDisplays a window in its most recent size and position. The active window remains active.  
 SW_SHOWNORMALActivates and displays a window. If the window is minimized or maximized, Windows restores it to its original size and position. An application should specify this flag when displaying the window for the first time.  

Examples (click the links to see demo)
RunCPL('desk.cpl');   Display properties  
RunCPL('main.cpl', sw_ShowNormal');   Mouse properties  
RunCPL('mmsys.cpl', sw_ShowNormal);   Multimedia properties  
RunCPL('modem.cpl', sw_ShowNormal);   Modems properties  

Original code
procedure RunCPL(FileName: String; CmdShow: Integer);  
begin  
  try  
    WinExec(PChar('rundll32 shell32,Control_RunDLL ' + FileName), CmdShow);  
  except  
  end;  
end;  

See also
RunControlPanel procedure.