JUCE  v6.1.6 (6.0.8-1114)
JUCE API
Looking for a senior C++ dev?
I'm looking for work. Hire me!
juce::Process Class Reference

Represents the current executable's process. More...

#include <juce_Process.h>

Public Types

enum  ProcessPriority {
  LowPriority = 0,
  NormalPriority = 1,
  HighPriority = 2,
  RealtimePriority = 3
}
 

Static Public Member Functions

static void * getCurrentModuleInstanceHandle () noexcept
 WINDOWS ONLY - This returns the HINSTANCE of the current module. More...
 
static void hide ()
 Hides the application (on an OS that supports this, e.g. More...
 
static bool isForegroundProcess ()
 Returns true if this application process is the one that the user is currently using. More...
 
static bool isRunningUnderDebugger () noexcept
 Returns true if this process is being hosted by a debugger. More...
 
static void lowerPrivilege ()
 Lowers the current process's privilege level. More...
 
static void makeForegroundProcess ()
 Attempts to make the current process the active one. More...
 
static bool openDocument (const String &documentURL, const String &parameters)
 Tries to launch the OS's default reader application for a given file or URL. More...
 
static bool openEmailWithAttachments (const String &targetEmailAddress, const String &emailSubject, const String &bodyText, const StringArray &filesToAttach)
 Tries to launch the OS's default email application to let the user create a message. More...
 
static void raisePrivilege ()
 Raises the current process's privilege level. More...
 
static void setCurrentModuleInstanceHandle (void *newHandle) noexcept
 WINDOWS ONLY - Sets a new module handle to be used by the library. More...
 
static bool setMaxNumberOfFileHandles (int maxNumberOfFiles) noexcept
 UNIX ONLY - Attempts to use setrlimit to change the maximum number of file handles that the app can open. More...
 
static void setPriority (const ProcessPriority priority)
 Changes the current process's priority. More...
 
static void terminate ()
 Kills the current process immediately. More...
 

Private Member Functions

 Process ()
 

Detailed Description

Represents the current executable's process.

This contains methods for controlling the current application at the process-level.

See also
Thread, JUCEApplicationBase

@tags{Core}

Member Enumeration Documentation

◆ ProcessPriority

Enumerator
LowPriority 
NormalPriority 
HighPriority 
RealtimePriority 

Constructor & Destructor Documentation

◆ Process()

juce::Process::Process ( )
private

Member Function Documentation

◆ getCurrentModuleInstanceHandle()

static void* juce::Process::getCurrentModuleInstanceHandle ( )
staticnoexcept

WINDOWS ONLY - This returns the HINSTANCE of the current module.

The return type is a void* to avoid being dependent on windows.h - just cast it to a HINSTANCE to use it.

In a normal JUCE application, this will be automatically set to the module handle of the executable.

If you've built a DLL and plan to use any JUCE messaging or windowing classes, you'll need to make sure you call the setCurrentModuleInstanceHandle() to provide the correct module handle in your DllMain() function, because the system relies on the correct instance handle when opening windows.

Referenced by juce::HiddenMessageWindow::HiddenMessageWindow(), and juce::WindowsHooks::WindowsHooks().

◆ hide()

static void juce::Process::hide ( )
static

Hides the application (on an OS that supports this, e.g.

OSX, iOS, Android)

◆ isForegroundProcess()

static bool juce::Process::isForegroundProcess ( )
static

Returns true if this application process is the one that the user is currently using.

◆ isRunningUnderDebugger()

static bool juce::Process::isRunningUnderDebugger ( )
staticnoexcept

Returns true if this process is being hosted by a debugger.

◆ lowerPrivilege()

static void juce::Process::lowerPrivilege ( )
static

Lowers the current process's privilege level.

Does nothing if this isn't supported by the current OS, or if process privilege level is fixed.

◆ makeForegroundProcess()

static void juce::Process::makeForegroundProcess ( )
static

Attempts to make the current process the active one.

(This is not possible on some platforms).

◆ openDocument()

static bool juce::Process::openDocument ( const String documentURL,
const String parameters 
)
static

Tries to launch the OS's default reader application for a given file or URL.

◆ openEmailWithAttachments()

static bool juce::Process::openEmailWithAttachments ( const String targetEmailAddress,
const String emailSubject,
const String bodyText,
const StringArray filesToAttach 
)
static

Tries to launch the OS's default email application to let the user create a message.

◆ raisePrivilege()

static void juce::Process::raisePrivilege ( )
static

Raises the current process's privilege level.

Does nothing if this isn't supported by the current OS, or if process privilege level is fixed.

◆ setCurrentModuleInstanceHandle()

static void juce::Process::setCurrentModuleInstanceHandle ( void *  newHandle)
staticnoexcept

WINDOWS ONLY - Sets a new module handle to be used by the library.

The parameter type is a void* to avoid being dependent on windows.h, but it actually expects a HINSTANCE value.

See also
getCurrentModuleInstanceHandle()

◆ setMaxNumberOfFileHandles()

bool juce::Process::setMaxNumberOfFileHandles ( int  maxNumberOfFiles)
staticnoexcept

UNIX ONLY - Attempts to use setrlimit to change the maximum number of file handles that the app can open.

Pass 0 or less as the parameter to mean 'infinite'. Returns true if it succeeds.

Referenced by juce::MaxNumFileHandlesInitialiser::MaxNumFileHandlesInitialiser().

◆ setPriority()

static void juce::Process::setPriority ( const ProcessPriority  priority)
static

Changes the current process's priority.

Parameters
prioritythe process priority, where 0=low, 1=normal, 2=high, 3=realtime

◆ terminate()

void juce::Process::terminate ( )
static

Kills the current process immediately.

This is an emergency process terminator that kills the application immediately - it's intended only for use only when something goes horribly wrong.

See also
JUCEApplicationBase::quit

The documentation for this class was generated from the following files: