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 ¶meters) |
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 () | |
Represents the current executable's process.
This contains methods for controlling the current application at the process-level.
@tags{Core}
|
private |
|
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().
|
static |
Hides the application (on an OS that supports this, e.g.
OSX, iOS, Android)
|
static |
Returns true if this application process is the one that the user is currently using.
|
staticnoexcept |
Returns true if this process is being hosted by a debugger.
|
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.
|
static |
Attempts to make the current process the active one.
(This is not possible on some platforms).
|
static |
Tries to launch the OS's default reader application for a given file or URL.
|
static |
Tries to launch the OS's default email application to let the user create a message.
|
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.
|
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.
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().
|
static |
Changes the current process's priority.
priority | the process priority, where 0=low, 1=normal, 2=high, 3=realtime |
|
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.