Blackbox.h File Reference

#include "API\BBApi.h"
#include "Graphics\BImage.h"
#include "Messaging\Broams.h"
#include "Console\Console.h"
#include "Desktop\Desktop.h"
#include "Dock\Dock.h"
#include "Hotkeys\Hotkeys.h"
#include "Menu\MenuCommon.h"
#include "Menu\Menu.h"
#include "Menu\PreviewItem.h"
#include "Messaging\MessageManager.h"
#include "Plugins\PluginManager.h"
#include "Toolbar\Taskbar.h"
#include "Toolbar\Toolbar.h"
#include "Workspaces\Workspaces.h"
#include "Settings\Themes.h"
#include "Dialogs\PopupDialog.h"
#include "Settings\Settings.h"
#include "Sounds\Sounds.h"
#include "Desktop\Wallpaper.h"
#include "Resources\resource.h"
#include <process.h>
#include <commdlg.h>
#include <time.h>
#include <shlobj.h>
#include <locale.h>

Macros
#define	SESSION_DURATION_TIMER   1
#define	CHECK_EXPLORER_HIDDEN_TIMER   2
#define	CHECK_FOR_UPDATES_DELAY_TIMER   3

Functions
LRESULT CALLBACK	MainWndProc (HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
LRESULT CALLBACK	ShellHookProc (int nCode, WPARAM wParam, LPARAM lParam)
void	startBlackbox ()
void	exitBlackbox ()
void	restartBlackboxStop ()
void	restartBlackboxStart ()
void	ExecuteRootCommand (void *)
void	ShutdownWindows (int state, bool skipAsking)
void	ShutdownThread (void *)
void	HideDesktopIcons (bool hide)
void	SessionTimeStamp (bool beginSession)
void	CheckForUpdates ()

Macro Definition Documentation

SESSION_DURATION_TIMER

#define SESSION_DURATION_TIMER   1

CHECK_EXPLORER_HIDDEN_TIMER

#define CHECK_EXPLORER_HIDDEN_TIMER   2

CHECK_FOR_UPDATES_DELAY_TIMER

#define CHECK_FOR_UPDATES_DELAY_TIMER   3

Function Documentation

MainWndProc()

LRESULT CALLBACK MainWndProc	(	HWND	hwnd,
		UINT	uMsg,
		WPARAM	wParam,
		LPARAM	lParam )

{
    switch (uMsg)
    {
        //====================
 
        case WM_HELP:
        {
            BBExecute(GetDesktopWindow(), NULL, "http://xoblite.net/docs/", "", "", SW_SHOWNORMAL, true);
            return TRUE;
        }
 
        //====================
 
        case WM_HOTKEY:
        {
            if (pHotkeys) pHotkeys->ExecuteHotkey((int)wParam);
        }
        break;
 
        //====================
 
        case WM_QUERYENDSESSION:
        {
            if (lParam & ENDSESSION_CRITICAL)
            {
                if (lParam & ENDSESSION_LOGOFF) debugLogoff = true;
                else debugShutdown = debugReboot = true;
                if (pSettings->debugLogging) Log("xoblite", "WM_QUERYENDSESSION | SYSTEM/CRITICAL");
                return TRUE;
            }
            else if (debugLogoff || debugReboot || debugShutdown)
            {
                if (pSettings->debugLogging)
                {
                    if (debugLogoff) Log("xoblite", "WM_QUERYENDSESSION | XOBLITE/LOGOFF");
                    else if (debugReboot) Log("xoblite", "WM_QUERYENDSESSION | XOBLITE/REBOOT");
                    else Log("xoblite", "WM_QUERYENDSESSION | XOBLITE/SHUTDOWN");
                }
                return TRUE;
            }
            else
            {
                if (pSettings->debugLogging)
                {
                    if (lParam & ENDSESSION_CLOSEAPP) Log("xoblite", "WM_QUERYENDSESSION | SYSTEM/CLOSEAPP");
                    else if (lParam & ENDSESSION_LOGOFF) Log("xoblite", "WM_QUERYENDSESSION | SYSTEM/LOGOFF");
                    else Log("xoblite", "WM_QUERYENDSESSION | SYSTEM/SHUTDOWN_or_REBOOT");
                }
/*
                if (pSettings->debugLogging)
                {
                    if (MessageBox(GetBBWnd(), "Windows has requested a logoff/reboot/shutdown.   \n\nAre you sure you want to quit?   \n", "xoblite", MB_YESNO | MB_ICONQUESTION | MB_SETFOREGROUND | MB_TOPMOST) != IDYES)
                    {
                        Log("xoblite", "WM_QUERYENDSESSION | === BLOCKED BY USER ===");
                        return FALSE;
                    }
                }
*/
            }
 
            if (lParam & ENDSESSION_LOGOFF) debugLogoff = true;
            else debugShutdown = debugReboot = true;
//          PostMessage(hMainWnd, WM_CLOSE, 0, 0);
            return TRUE;
        }
 
        case WM_ENDSESSION:
        {
            if ((wParam == TRUE) && pSettings->debugLogging) Log("xoblite", "WM_ENDSESSION");
//          exitBlackbox();
            return 0;
        }
 
        //====================
 
        case WM_SYSCOMMAND:
        case WM_KEYDOWN:
        {
            if (wParam == SC_CLOSE)
            {
                if (pSettings->debugLogging) Log("xoblite", "SC_CLOSE");
                PostMessage(GetBBWnd(), BB_SHUTDOWN, 255, 0); // Open the standard Windows shutdown menu...
                return 0;
            }
            else return DefWindowProc(hWnd, uMsg, wParam, lParam);
        }
 
        //====================
 
        case WM_CLOSE:
        case BB_QUIT:
        {
            if (pSettings->debugLogging && (uMsg==WM_CLOSE)) Log("xoblite", "SC_CLOSE");
            exitBlackbox();
            PostQuitMessage(0);
        }
        break;
 
        //====================
 
        case BB_SHUTDOWN:
        {
            switch (wParam)
            {
                case 0: // Shutdown
                    ShutdownWindows(0, ((int)lParam == 1));
                break;
                case 1: // Reboot
                    ShutdownWindows(1, ((int)lParam == 1));
                break;
                case 2: // Log off
                    ShutdownWindows(2, ((int)lParam == 1));
                break;
                case 3: // Hibernate (a.k.a. "safe sleep" and "suspend to disk")
                    ShutdownWindows(3, ((int)lParam == 1));
                break;
                case 4: // Standby (a.k.a. "sleep" and "suspend to RAM")
                    ShutdownWindows(4, ((int)lParam == 1));
                break;
                case 5: // LockWorkstation
//                  BBExecute(GetDesktopWindow(), NULL, "rundll32.exe", "user32.dll,LockWorkStation", NULL, SW_HIDE, false);
                    LockWorkStation();
                    PlaySoundFX(SFX_LOCK_WORKSTATION);
                break;
                default: // Standard Windows shutdown menu (does not work from the xoblite main menu)
                    MSWinShutdown(hMainWnd);
                break;
            }
            return 0;
        }
 
        //====================
 
        case BB_RESTART:
        {
            if (exitInProgress) // Restart after a failed shutdown/reboot/etc attempt...
            {
                exitInProgress = false;
                startBlackbox();
            }
            else if (!pausedRestart) // Regular restart...
            {
                // Lock the dock to avoid repeated SLIT_REMOVE/ADD
                // messages from plugins when restarting...
                pDock->ReconfigureLock(true);
                if (wParam) pausedRestart = true;
                restartBlackboxStop();
                restartBlackboxStart();
                SendMessage(pDesktop->hDesktopWnd, BB_RECONFIGURE, 0, 0);
            }
        }
        break;
 
        //====================
 
        case BB_SETTHEME: // Introducing xoblite *THEMES*! :D
        {
            if (lParam != 0)
            {
                char themePath[MAX_LINE_LENGTH];
                strcpy_s(themePath, (LPCSTR)lParam);
                SetTheme(themePath, false);
            }
        }
        break;
 
        //====================
 
        case BB_SETSTYLE:
        {
            // Load a new style or refresh the current one?
            if (lParam != 0)
            {
                char style[MAX_LINE_LENGTH];
                strcpy_s(style, (LPCSTR)lParam);
                if (strchr(style, '\"')) StrRemoveEncap(style);
                if (strchr(style, '$')) ReplaceShellFolders(style);
                if (strchr(style, '%')) ReplaceEnvVars(style);
 
                if (!FileExists(style))
                {
                    MBoxErrorFile(style);
                    break;
                }
                stylePath(style); // Save the new style path to blackbox.rc etc.
            }
 
            // Read the new style settings...
            pSettings->ReadStyle();
 
            // Show style change message in the console...
            char msg[MAX_LINE_LENGTH], a1[MAX_LINE_LENGTH], a2[MAX_LINE_LENGTH]; // , a3[MAX_LINE_LENGTH];
            strcpy_s(a1, ReadString(pSettings->styleFile, "style.name:", "[Style name not specified]"));
            strcpy_s(a2, ReadString(pSettings->styleFile, "style.author:", "[Author not specified]"));
//          strcpy_s(a3, ReadString(pSettings->styleFile, "style.wallpaper:", ""));
//          if (strlen(a3)) sprintf(msg, "Applying \"%s\" by %s... (suggested wallpaper -> %s )", a1, a2, a3);
//          else sprintf(msg, "Applying \"%s\" by %s...", a1, a2);
            sprintf(msg, "Applying \"%s\" by %s...", a1, a2);
            SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_REGULAR_MESSAGE, (LPARAM)msg);
 
            // Update global menu settings (item heights, fonts...)
            pMenuCommon->Configure();
 
            // Temporarily lock the dock to avoid repeated SLIT_UPDATE messages from plugins... (i.e. repeated repaints of the dock window)
            pDock->ReconfigureLock(true);
 
            // Reconfigure...
            SendMessage(GetBBWnd(), BB_RECONFIGURE, 0, 0);
 
            // As a "security precausion", we also move the desktop window to the bottom...
//          SetWindowPos(pDesktop->hDesktopWnd, HWND_BOTTOM, 0, 0, 0, 0, SWP_NOSIZE | SWP_NOMOVE | SWP_NOACTIVATE | SWP_SHOWWINDOW | SWP_NOSENDCHANGING);
            SetWindowPos(pDesktop->hDesktopWnd, GetDesktopWindow(), 0, 0, 0, 0, SWP_NOSIZE | SWP_NOMOVE | SWP_NOACTIVATE | SWP_SHOWWINDOW | SWP_NOSENDCHANGING);
 
            // Finally, we execute the rootCommand (nb. only "bsetbg" or "bsetroot", now internally parsed, allowed!) in a separate thread...
            if (!wParam && !pSettings->disableRootCommands) _beginthread(ExecuteRootCommand, 0, NULL);
 
            pSettings->Statistics.changedStyle++; // Update statistics...
        }
        break;
 
        //====================
 
        case WM_DISPLAYCHANGE:
        {
            if (!pSettings->disableRootCommands) _beginthread(ExecuteRootCommand, 0, NULL); // Refresh the desktop wallpaper by re-running the current style's rootCommand...
        }
        break;
 
        //====================
 
        case WM_DPICHANGED:
        {
            int dpiValue = (int)LOWORD(wParam);
            int scaleFactor = 0;
 
            switch (dpiValue)
            {
                case 384: { scaleFactor = 400; } break; // 384 DPI -> 400%
                case 336: { scaleFactor = 350; } break; // 336 DPI -> 350%
                case 288: { scaleFactor = 300; } break; // 288 DPI -> 300%
                case 240: { scaleFactor = 250; } break; // 240 DPI -> 250%
                case 216: { scaleFactor = 225; } break; // 216 DPI -> 225%
                case 192: { scaleFactor = 200; } break; // 192 DPI -> 200%
                case 168: { scaleFactor = 175; } break; // 168 DPI -> 175%
                case 144: { scaleFactor = 150; } break; // 144 DPI -> 150%
                case 120: { scaleFactor = 125; } break; // 120 DPI -> 125%
                case 96: { scaleFactor = 100; } break; // 96 DPI -> 100%
                default: break; // Unknown DPI value
            }
 
            char msg[350];
            if (scaleFactor > 0) sprintf(msg, "Windows UI scaling factor has changed to %d%%. xoblite HiDPI scaling factor is set to %dx. ", scaleFactor, pSettings->scalingFactorHiDPI);
            else sprintf(msg, "Windows UI scaling resolution has changed to %d DPI. xoblite HiDPI scaling factor is set to %dx. ", dpiValue, pSettings->scalingFactorHiDPI);
            SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_INFORMATION_MESSAGE, (LPARAM)msg);
 
            return 0;
        }
 
        //====================
 
        case BB_EDITFILE:
        {
            switch (wParam)
            {
                case 0: // Open the current style file for editing
                    BBExecute(GetDesktopWindow(), NULL, pSettings->preferredEditor, pSettings->styleFile, NULL, SW_SHOWNORMAL, false);
                break;
                case 1: // Open the current menu.rc file for editing
                    BBExecute(GetDesktopWindow(), NULL, pSettings->preferredEditor, pSettings->menuFile, NULL, SW_SHOWNORMAL, false);
                break;
                case 2: // Open the current plugins.rc file for editing
                    BBExecute(GetDesktopWindow(), NULL, pSettings->preferredEditor, pSettings->pluginsFile, NULL, SW_SHOWNORMAL, false);
                break;
                case 3: // Open the current theme's xoblite.rc (or if used, legacy extensions.rc) file for editing
                    BBExecute(GetDesktopWindow(), NULL, pSettings->preferredEditor, pSettings->xobrcFile, NULL, SW_SHOWNORMAL, false);
                break;
                case 4: // Open the default xoblite.rc (or if used, legacy blackbox.rc) file for editing
                    BBExecute(GetDesktopWindow(), NULL, pSettings->preferredEditor, pSettings->xobrcDefaultFile, NULL, SW_SHOWNORMAL, false);
                break;
                default:
                break;
            }
            return 0;
        }
        break;
 
        //====================
 
        case BB_TOGGLEPLUGINS:
        {
            if (pSettings->pluginsHidden)
            {
                SendMessage(hMainWnd, BB_BROADCAST, 0, (LPARAM)"@BBShowPlugins");
                pSettings->pluginsHidden = false;
            }
            else
            {
                SendMessage(hMainWnd, BB_BROADCAST, 0, (LPARAM)"@BBHidePlugins");
                pSettings->pluginsHidden = true;
            }
 
            // Move the console->dock->toolbar, if not hidden, back to the top... (i.e. so they're not covered by any non-alwaysontop plugins)
            if (!pSettings->consoleHidden) SetForegroundWindow(pConsole->hConsoleWnd);
            if (!pSettings->dockHidden) SetForegroundWindow(pDock->hDockWnd);
            if (!pSettings->toolbarHidden) SetForegroundWindow(pToolbar->hToolbarWnd);
 
            WriteBool(pSettings->xobrcFile, "xoblite.plugins.hidden:", pSettings->pluginsHidden);
        }
        break;
 
        //====================
 
        case BB_RUN: // This is called e.g. from a menu [run] item...
        {
            if ((int)lParam == 1) BBSmartExecute("@xoblite Run"); // -> The xoblite super-powered run box... (i.e. this includes support for bro@ms, @script as well as regular commands, but lacks a "Browse..." function etc)
            else RunDlg( NULL, NULL, NULL, NULL, NULL, 0 ); // -> The regular Windows run dialog... (i.e. this lacks support for bro@ms and @script of course, but has a "Browse..." function etc)
        }
        break;
 
        case WM_CTLCOLOREDIT: // Used by the xoblite run box edit window... (nb. for menu string item edit windows this is handled by the item's parent menu)
        {
            // SetTextColor((HDC)wParam, pSettings->Toolbar->TextColor);
            // SetBkColor((HDC)wParam, pSettings->Toolbar->Color);
            SetTextColor((HDC)wParam, 0x000000);
            SetBkColor((HDC)wParam, 0xffffff);
            return (LRESULT)GetStockObject(NULL_BRUSH);
        }
        break;
 
        //====================
 
        case BB_REGISTERMESSAGE:
        {
            UINT *msgArray = (UINT*)lParam;
            for (int size = 0; msgArray[size] != 0; size++)
            {
                pMessageManager->AddMessage(msgArray[size], (HWND)wParam);
            }
            break;
        }
 
        case BB_UNREGISTERMESSAGE:
        {
            UINT *msgArray = (UINT*)lParam;
            for (int size = 0; msgArray[size] != 0; size++)
            {
                pMessageManager->RemoveMessage(msgArray[size], (HWND)wParam);
            }
            break;
        }
 
        //====================
 
        case WM_COPYDATA: // Used by Blackbox.exe -broam <string>
        {
            PCOPYDATASTRUCT pcds = (PCOPYDATASTRUCT)lParam;
            if (pcds->dwData == BB_BROADCAST) SendMessage(GetBBWnd(), BB_BROADCAST, 0, (LPARAM)pcds->lpData);
            else if (pcds->dwData == BB_SETSTYLE) PostMessage(GetBBWnd(), BB_SETSTYLE, 0, (LPARAM)pcds->lpData);
            break;
        }
 
        //====================
 
        case WM_DROPFILES:
        {
            // Forward any drag'n'drop messages to the Desktop for parsing...
            if (pDesktop) return PostMessage(pDesktop->hDesktopWnd, WM_DROPFILES, wParam, lParam);
        }
        break;
 
        //====================
 
        case WM_TIMER:
        {
            // CHECK_EXPLORER_HIDDEN_TIMER:
            // -> Timer to check whether the Explorer taskbar has gone visible again,
            // despite having been previously hidden... (read: I'm not 100% sure why/when
            // this happens yet, so continuously checking is more "foolproof" for now ;) )
            if (wParam == CHECK_EXPLORER_HIDDEN_TIMER)
            {
                if (pSettings->explorerHidden)
                {
                    if (pSettings->underExplorer && IsWindowVisible(FindWindow("Shell_TrayWnd", NULL)))
                    {
                        HideExplorer(true);
                        HideDesktopIcons(true);
                    }
                }
            }
 
            // SESSION_DURATION_TIMER:
            // -> Timer to measure the length of the session in minutes...
            // (used to calculate the duration of the session when it ends)
            else if (wParam == SESSION_DURATION_TIMER) sessionDuration++;
 
            // CHECK_FOR_UPDATES_DELAY_TIMER:
            // -> On first launch, and when resuming from sleep/hibernate,
            // we perform a check for updates, but only after a certain delay
            // to allow all other things as well as the user to warm up first... ;)
            else if (wParam == CHECK_FOR_UPDATES_DELAY_TIMER)
            {
                KillTimer(GetBBWnd(), CHECK_FOR_UPDATES_DELAY_TIMER);
                CheckForUpdates();
            }
 
            return 0;
        }
 
        //====================
 
        case BB_BROADCAST:
        {
            char broam[MAX_LINE_LENGTH];
            strcpy_s(broam, (LPCSTR)lParam);
            if (ExecuteBroam(broam, hMainInstance)) return 0;
        }
 
        //====================
 
        case BB_TRAYICONMESSAGE:
        {
            switch (LOWORD(lParam))
            {
                case WM_LBUTTONUP:
                {
                    if ((GetAsyncKeyState(VK_CONTROL) & 0x8000) && pWorkspaces) pWorkspaces->NextWorkspace();
                    else if (pToolbar)
                    {
//                      pToolbar->UpdatePosition();
                        SetWindowPos(pToolbar->hToolbarWnd, HWND_TOP, 0, 0, 0, 0, SWP_NOSIZE | SWP_NOMOVE);
                        SetForegroundWindow(pToolbar->hToolbarWnd);
                        PlaySoundFX(SFX_MENU_CLICK);
                    }
                    break;
                }
 
                case WM_RBUTTONDOWN:
                {
                    if ((GetAsyncKeyState(VK_CONTROL) & 0x8000) && pWorkspaces) pWorkspaces->PreviousWorkspace();
                    else if (pTaskbar) pTaskbar->MinimizeAllWindows();
                    break;
                }
 
                case WM_MOUSEWHEEL: // TEMPORARY "FOR TESTING" PLACEHOLDER
                {
                    PlaySoundFX(SFX_MENU_NAVIGATE);
                    break;
                }
 
                default: { break; }
            }
        }
 
        //====================
 
        default:
        {
            if (uMsg == WM_TASKBARCREATED_MESSAGE)
            {
                if (pSettings->underExplorer)
                {
                    // The Explorer system tray has been recreated (e.g. due to Explorer crashing), so we need to re-add the xoblite icon to the system tray...
                    DestroyIcon(xobIconData.hIcon);
                    ZeroMemory(&xobIconData, sizeof(NOTIFYICONDATA));
                    xobIconData.cbSize = sizeof(NOTIFYICONDATA); // Older Windows versions -> NOTIFYICONDATA_V3_SIZE
                    xobIconData.hIcon = LoadIcon(hMainInstance, MAKEINTRESOURCE(IDI_XOBLITE));
//                  LoadIconMetric(hMainInstance, MAKEINTRESOURCE(IDI_XOBLITE), LIM_SMALL, &(xobIconData.hIcon));
                    strcpy(xobIconData.szTip, "xoblite");
                    xobIconData.hWnd = GetBBWnd();
                    xobIconData.uID = 0;
                    xobIconData.uVersion = NOTIFYICON_VERSION_4; // // Older Windows versions -> 3
                    xobIconData.uCallbackMessage = BB_TRAYICONMESSAGE;
                    xobIconData.uFlags = NIF_ICON | NIF_TIP | NIF_MESSAGE;
                    Shell_NotifyIcon(NIM_ADD, &xobIconData);
                }
                return 0;
            }
 
            //====================
 
            if (pMessageManager)
            {
                unsigned int shellMessage = uMsg;
                WPARAM replaceParam = wParam;
 
                if (shellMessage == WM_SHELLHOOKMESSAGE)
                {
                    if (wParam == HSHELL_WINDOWCREATED) shellMessage = BB_ADDTASK;
                    else if (wParam == HSHELL_WINDOWDESTROYED) shellMessage = BB_REMOVETASK;
                    else if (wParam == HSHELL_ACTIVATESHELLWINDOW) shellMessage = BB_ACTIVATESHELLWINDOW;
                    else if (wParam == HSHELL_WINDOWACTIVATED) shellMessage = BB_ACTIVETASK;
                    else if (wParam == HSHELL_RUDEAPPACTIVATED)
                    {
                        // Could there be a better way to support fullscreen windows?
                        // (e.g. unloading everything or disable alwaysontop elements)
                        shellMessage = BB_ACTIVETASK;
/*
                        if (pTaskbar)
                        {
                            HWND window = (HWND)lParam;
                            if (pTaskbar->FindTask(window) >= 0) shellMessage = BB_ACTIVETASK;
                            else shellMessage = BB_ADDTASK;
                        }
                        else shellMessage = BB_ACTIVETASK;
 
                        if (pSettings->debugLogging && pTaskbar)
                        {
                            char msg[MAX_LINE_LENGTH], windowText[MAX_LINE_LENGTH], windowClass[MAX_LINE_LENGTH];
                            GetWindowText((HWND)lParam, windowText, sizeof(windowText));
                            if (!strlen(windowText)) strcpy(windowText, "NULL");
                            GetClassName((HWND)lParam, windowClass, sizeof(windowClass));
                            if (!strlen(windowClass)) strcpy(windowClass, "NULL");
                            sprintf(msg, "WM_SHELLHOOKMESSAGE -> HSHELL_RUDEAPPACTIVATED -> %s | %s | Already on taskbar: ", windowText, windowClass);
                            HWND window = (HWND)lParam;
                            if (pTaskbar->FindTask(window) >= 0) strcat(msg, "Yes");
                            else strcat(msg, "No");
 
                            SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_INFORMATION_MESSAGE, (LPARAM)msg);
                            Log("xoblite", msg);
                        }
*/
                    }
                    else if (wParam == HSHELL_GETMINRECT) shellMessage = BB_MINMAXTASK;
                    else if (wParam == HSHELL_REDRAW) shellMessage = BB_REDRAW;
                    else if (wParam == HSHELL_FLASH)
                    {
                        // Insert flashing code here...
                        shellMessage = BB_REDRAW;
                        pTaskbar->flashingHwnd = (HWND)lParam;
                    }
                    else // -> Unsupported HSHELL message received!
                    {
/*
                        if (pSettings->debugLogging)
                        {
                            char msg[MAX_LINE_LENGTH], windowText[MAX_LINE_LENGTH], windowClass[MAX_LINE_LENGTH];
                            GetWindowText((HWND)lParam, windowText, sizeof(windowText));
                            if (!strlen(windowText)) strcpy(windowText, "NULL");
                            GetClassName((HWND)lParam, windowClass, sizeof(windowClass));
                            if (!strlen(windowClass)) strcpy(windowClass, "NULL");
 
                            if (wParam == HSHELL_TASKMAN) strcpy(msg, "Unsupported HSHELL message -> HSHELL_TASKMAN");
                            else if (wParam == HSHELL_LANGUAGE) strcpy(msg, "Unsupported HSHELL message -> HSHELL_LANGUAGE");
                            else if (wParam == HSHELL_SYSMENU) strcpy(msg, "Unsupported HSHELL message -> HSHELL_SYSMENU");
                            else if (wParam == HSHELL_ENDTASK) sprintf(msg, "Unsupported HSHELL message -> HSHELL_ENDTASK -> %s | %s", windowText, windowClass);
                            else if (wParam == HSHELL_ACCESSIBILITYSTATE) strcpy(msg, "Unsupported HSHELL message -> HSHELL_ACCESSIBILITYSTATE");
                            else if (wParam == HSHELL_APPCOMMAND) strcpy(msg, "Unsupported HSHELL message -> HSHELL_APPCOMMAND");
                            else if (wParam == HSHELL_WINDOWREPLACED) sprintf(msg, "Unsupported HSHELL message -> HSHELL_WINDOWREPLACED -> %s | %s", windowText, windowClass);
                            else if (wParam == HSHELL_WINDOWREPLACING) sprintf(msg, "Unsupported HSHELL message -> HSHELL_WINDOWREPLACING -> %s | %s", windowText, windowClass);
                            else if (wParam == HSHELL_MONITORCHANGED) sprintf(msg, "Unsupported HSHELL message -> HSHELL_MONITORCHANGED -> %s | %s", windowText, windowClass);
                            else sprintf(msg, "Unknown HSHELL message -> 0x%lx -> %s | %s", (LONG)wParam, windowText, windowClass);
 
                            SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_INFORMATION_MESSAGE, (LPARAM)msg);
                            Log("xoblite", msg);
                        }
*/
                        return DefWindowProc(hWnd, uMsg, wParam, lParam);
                    }
 
                    replaceParam = (WPARAM)lParam; // Replacement wParam set to the hwnd
                }
 
                //====================
 
                if (pMessageManager->HandlerExists(shellMessage))
                {
                    LRESULT lResult;
                    if (pMessageManager->SendMessage(shellMessage, replaceParam, lParam, &lResult)) return lResult;
                }
            }
 
            return DefWindowProc(hWnd, uMsg, wParam, lParam);
        }
 
        //====================
    }
 
    return DefWindowProc(hWnd, uMsg, wParam, lParam);
}

ShellHookProc()

LRESULT CALLBACK ShellHookProc	(	int	nCode,
		WPARAM	wParam,
		LPARAM	lParam )

{
    if (nCode < 0)
    {
        if (pSettings->debugLogging) Log("DEBUG -> ShellHookProc -> nCode < 0 (i.e. \"do not process this message\")", "");
        return CallNextHookEx(shellHook, nCode, wParam, lParam);
    }
 
    if (pSettings->debugLogging)
    {
        char msg[MAX_LINE_LENGTH];
        switch (nCode)
        {
            case HSHELL_WINDOWCREATED: { strcpy(msg, "DEBUG -> ShellHookProc -> HSHELL_WINDOWCREATED"); break; }
            case HSHELL_WINDOWDESTROYED: { strcpy(msg, "DEBUG -> ShellHookProc -> HSHELL_WINDOWDESTROYED"); break; }
            case HSHELL_ACTIVATESHELLWINDOW: { strcpy(msg, "DEBUG -> ShellHookProc -> HSHELL_ACTIVATESHELLWINDOW"); break; }
            case HSHELL_WINDOWACTIVATED: { strcpy(msg, "DEBUG -> ShellHookProc -> HSHELL_WINDOWACTIVATED"); break; }
            case HSHELL_GETMINRECT: { strcpy(msg, "DEBUG -> ShellHookProc -> HSHELL_GETMINRECT"); break; }
            case HSHELL_REDRAW: { strcpy(msg, "DEBUG -> ShellHookProc -> HSHELL_REDRAW"); break; }
            case HSHELL_TASKMAN: { strcpy(msg, "DEBUG -> ShellHookProc -> HSHELL_TASKMAN"); break; }
            case HSHELL_LANGUAGE: { strcpy(msg, "DEBUG -> ShellHookProc -> HSHELL_LANGUAGE"); break; }
 
            case HSHELL_ACCESSIBILITYSTATE: { strcpy(msg, "DEBUG -> ShellHookProc -> HSHELL_ACCESSIBILITYSTATE"); break; }
            case HSHELL_APPCOMMAND: { strcpy(msg, "DEBUG -> ShellHookProc -> HSHELL_APPCOMMAND"); break; }
            case HSHELL_WINDOWREPLACED: { strcpy(msg, "DEBUG -> ShellHookProc -> HSHELL_WINDOWREPLACED"); break; }
 
            default: { sprintf(msg, "DEBUG -> ShellHookProc -> Unknown HSHELL message -> 0x%lx", (LONG)nCode); break; }
        }
        strcat(msg, " -> Forwarding to the *box internal message bus for further processing.");
        PostMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_INFORMATION_MESSAGE, (LPARAM)msg);
        Log("xoblite", msg);
    }
 
    if (pMessageManager) PostMessage(GetBBWnd(), WM_SHELLHOOKMESSAGE, (WPARAM)nCode, (LPARAM)wParam);
 
    return CallNextHookEx(shellHook, nCode, wParam, lParam);
/*
    if (pMessageManager)
    {
        unsigned int shellMessage = nCode;
        WPARAM replaceParam = wParam;
 
        //====================
 
        if (nCode == HSHELL_WINDOWCREATED) shellMessage = BB_ADDTASK;
        else if (nCode == HSHELL_WINDOWDESTROYED) shellMessage = BB_REMOVETASK;
        else if (nCode == HSHELL_ACTIVATESHELLWINDOW) shellMessage = BB_ACTIVATESHELLWINDOW;
        else if (nCode == HSHELL_WINDOWACTIVATED) shellMessage = BB_ACTIVETASK;
        else if (nCode == HSHELL_RUDEAPPACTIVATED)
        {
            // Could there be a better way to support fullscreen windows?
            // (e.g. unloading everything or disable alwaysontop elements)
            shellMessage = BB_ACTIVETASK;
 
//          if (pTaskbar)
//          {
//              HWND window = (HWND)lParam;
//              if (pTaskbar->FindTask(window) >= 0) shellMessage = BB_ACTIVETASK;
//              else shellMessage = BB_ADDTASK;
//          }
//          else shellMessage = BB_ACTIVETASK;
//
//          if (pSettings->debugLogging && pTaskbar)
//          {
//              char msg[MAX_LINE_LENGTH], windowText[MAX_LINE_LENGTH], windowClass[MAX_LINE_LENGTH];
//              GetWindowText((HWND)lParam, windowText, sizeof(windowText));
//              if (!strlen(windowText)) strcpy(windowText, "NULL");
//              GetClassName((HWND)lParam, windowClass, sizeof(windowClass));
//              if (!strlen(windowClass)) strcpy(windowClass, "NULL");
//              sprintf(msg, "WM_SHELLHOOKMESSAGE -> HSHELL_RUDEAPPACTIVATED -> %s | %s | Already on taskbar: ", windowText, windowClass);
//              HWND window = (HWND)lParam;
//              if (pTaskbar->FindTask(window) >= 0) strcat(msg, "Yes");
//              else strcat(msg, "No");
//
//              SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_INFORMATION_MESSAGE, (LPARAM)msg);
//              Log("xoblite", msg);
//          }
        }
        else if (nCode == HSHELL_GETMINRECT) shellMessage = BB_MINMAXTASK;
        else if (nCode == HSHELL_REDRAW) shellMessage = BB_REDRAW;
        else if (nCode == HSHELL_FLASH)
        {
            // Insert flashing code here...
            shellMessage = BB_REDRAW;
            pTaskbar->flashingHwnd = (HWND)lParam;
        }
        else // -> Unsupported HSHELL message received!
        {
            if (pSettings->debugLogging)
            {
                char msg[MAX_LINE_LENGTH], windowText[MAX_LINE_LENGTH], windowClass[MAX_LINE_LENGTH];
                GetWindowText((HWND)wParam, windowText, sizeof(windowText));
                if (!strlen(windowText)) strcpy(windowText, "NULL");
                GetClassName((HWND)wParam, windowClass, sizeof(windowClass));
                if (!strlen(windowClass)) strcpy(windowClass, "NULL");
 
                if (nCode == HSHELL_TASKMAN) strcpy(msg, "Unsupported HSHELL message -> HSHELL_TASKMAN");
                else if (nCode == HSHELL_LANGUAGE) strcpy(msg, "Unsupported HSHELL message -> HSHELL_LANGUAGE");
                else if (nCode == HSHELL_SYSMENU) strcpy(msg, "Unsupported HSHELL message -> HSHELL_SYSMENU");
                else if (nCode == HSHELL_ENDTASK) sprintf(msg, "Unsupported HSHELL message -> HSHELL_ENDTASK -> %s | %s", windowText, windowClass);
                else if (nCode == HSHELL_ACCESSIBILITYSTATE) strcpy(msg, "Unsupported HSHELL message -> HSHELL_ACCESSIBILITYSTATE");
                else if (nCode == HSHELL_APPCOMMAND) strcpy(msg, "Unsupported HSHELL message -> HSHELL_APPCOMMAND");
                else if (nCode == HSHELL_WINDOWREPLACED) sprintf(msg, "Unsupported HSHELL message -> HSHELL_WINDOWREPLACED -> %s | %s", windowText, windowClass);
                else if (nCode == HSHELL_WINDOWREPLACING) sprintf(msg, "Unsupported HSHELL message -> HSHELL_WINDOWREPLACING -> %s | %s", windowText, windowClass);
                else if (nCode == HSHELL_MONITORCHANGED) sprintf(msg, "Unsupported HSHELL message -> HSHELL_MONITORCHANGED -> %s | %s", windowText, windowClass);
                else sprintf(msg, "Unknown HSHELL message -> 0x%lx -> %s | %s", (LONG)nCode, windowText, windowClass);
 
                SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_INFORMATION_MESSAGE, (LPARAM)msg);
                Log("xoblite", msg);
            }
 
            return CallNextHookEx(shellHook, nCode, wParam, lParam);
        }
 
        //====================
 
        if (pMessageManager->HandlerExists(shellMessage))
        {
            if (pSettings->debugLogging) Log("DEBUG -> In ShellHookProc, about to pMessageManager->SendMessage...", "");
 
            LRESULT lResult;
            if (pMessageManager->SendMessage(shellMessage, wParam, lParam, &lResult)) return lResult;
        }
    }
 
    return CallNextHookEx(shellHook, nCode, wParam, lParam);
*/
}

startBlackbox()

void startBlackbox

(

)

{
    // Get the paths to the default xoblite.rc or blackbox.rc/extensions.rc...
    pSettings->GetShellFolders();
 
    //====================
 
    // Read only those settings from the default .rc
    // that are required to set the correct theme at startup...
    strcpy_s(pSettings->themesFolder, ReadString(pSettings->xobrcDefaultFile, "xoblite.themesFolder:", "$Blackbox$\\themes"));
    if (strchr(pSettings->themesFolder, '\"')) StrRemoveEncap(pSettings->themesFolder);
    if (strchr(pSettings->themesFolder, '$')) ReplaceShellFolders(pSettings->themesFolder);
    if (strchr(pSettings->themesFolder, '%')) ReplaceEnvVars(pSettings->themesFolder);
    strcpy_s(pSettings->selectedTheme, ReadString(pSettings->xobrcDefaultFile, "xoblite.selected.theme:", "[Default]"));
    if (!_stricmp(pSettings->selectedTheme, "<Default>")) strcpy(pSettings->selectedTheme, "[Default]"); // (changed to avoid similarity to editable string/integer menu items, as it is also shown in the Themes menu)
 
    if (!_stricmp(pSettings->selectedTheme, "[Default]")) // -> Use the default theme...
    {
        SetTheme(pSettings->SF_blackboxPath, true);
    }
    else // -> Set a specific theme...
    {
        char themePath[MAX_PATH];
        strcpy_s(themePath, pSettings->themesFolder);
        strcat(themePath, "\\");
        strcat(themePath, pSettings->selectedTheme);
        SetTheme(themePath, true);
    }
 
    //====================
 
    // Read configuration settings and style parameters for the chosen theme...
    pSettings->ReadConfiguration();
    pSettings->ReadStyle();
    RegisterThemeFonts();
 
    // Set time locale if configured...
    if (strlen(pSettings->timeDateLocale) > 0) setlocale(LC_TIME, pSettings->timeDateLocale);
    else setlocale(LC_TIME, ""); // Not configured -> Set the time locale to the user default obtained from the operating system...
 
    // Should we hide the Explorer taskbar etc already on startup?
    if (pSettings->underExplorer && pSettings->explorerHidden) HideExplorer(true);
 
    //====================
 
    // ####################################################################
    // ##### Note: The order things are started below is important!!! #####
    // ####################################################################
 
    pBImage = new BImage;
    pDesktop = new Desktop(hMainInstance);
    pConsole = new Console(hMainInstance);
 
    // Display welcome message in the console...
    SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_SHELL_MESSAGE, (LPARAM)"Welcome to xoblite.");
    SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_PLAIN_MESSAGE, (LPARAM)" http://xoblite.net/");
    SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_PLAIN_MESSAGE, (LPARAM)" https://github.com/xoblite/");
 
    // Set time stamp for beginning of session...
    Log("----------------------------------------", "");
    SessionTimeStamp(true);
/*
    if (pSettings->debugLogging)
    {
        char msg[255];
        sprintf(msg, "Operating system: %s ", GetOSInfo());
        if (pSettings->runningUnderWOW64) strcat(msg, "(64-bit).");
        else strcat(msg, "(32-bit).");
        SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_REGULAR_MESSAGE, (LPARAM)msg);
 
//      char msg[255];
//      sprintf(msg, "Time locale set to %s.", setlocale(LC_TIME, NULL));
//      SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_REGULAR_MESSAGE, (LPARAM)msg);
    }
*/
/*
    if (useLegacyShellHook) SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_ERROR_MESSAGE, (LPARAM)"xShellHook .DLL not found (or disabled) -> Falling back to legacy shell hook implementation.");
    else if (hShellHookDLL != NULL) SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_INFORMATION_MESSAGE, (LPARAM)"xShellHook .DLL found -> Using alternative new shell hook implementation.");
    if (pSettings->debugLogging)
    {
        if (hShellHookDLL != NULL)
        {
            // SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_INFORMATION_MESSAGE, (LPARAM)"DEBUG -> xShellHook.dll loaded.");
            if (PrepareShellHook != NULL) SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_INDENTED_MESSAGE, (LPARAM)"... PrepareShellHook() function found.");
            if (StartShellHook != NULL) SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_INDENTED_MESSAGE, (LPARAM)"... StartShellHook() function found.");
            if (StopShellHook != NULL) SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_INDENTED_MESSAGE, (LPARAM)"... StopShellHook() function found.");
            if (ShellHookProcInDLL != NULL) SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_INDENTED_MESSAGE, (LPARAM)"... ShellHookProc() function found.");
        }
    }
*/
    pWorkspaces = new Workspaces(hMainInstance);
    pMenuCommon = new MenuCommon;
    pPreviewItem = new PreviewItem(hMainInstance);
    pDock = new Dock(hMainInstance);
    pTooltips = new Tooltips();
    pTaskbar = new Taskbar();
 
    pPluginManager = new PluginManager(hMainInstance);
    pToolbar = new Toolbar(hMainInstance);
    pPopupDialog = new PopupDialog(hMainInstance);
 
    pMenuCommon->Initialize(hMainInstance);
    pTaskbar->InitializeTaskList(); // Enumerate tasks for the taskbar...
 
    pHotkeys = new Hotkeys(hMainInstance);
 
    if (pSettings->underExplorer)
    {
        // Add the xoblite icon to the system tray... =]
        ZeroMemory(&xobIconData, sizeof(NOTIFYICONDATA));
        xobIconData.cbSize = sizeof(NOTIFYICONDATA); // Older Windows versions -> NOTIFYICONDATA_V3_SIZE
        xobIconData.hIcon = LoadIcon(hMainInstance, MAKEINTRESOURCE(IDI_XOBLITE));
//      LoadIconMetric(hMainInstance, MAKEINTRESOURCE(IDI_XOBLITE), LIM_SMALL, &(xobIconData.hIcon));
        strcpy(xobIconData.szTip, "xoblite");
        xobIconData.hWnd = GetBBWnd();
        xobIconData.uID = 0;
        xobIconData.uVersion = NOTIFYICON_VERSION_4; // // Older Windows versions -> 3
        xobIconData.uCallbackMessage = BB_TRAYICONMESSAGE;
        xobIconData.uFlags = NIF_ICON | NIF_TIP | NIF_MESSAGE;
        Shell_NotifyIcon(NIM_ADD, &xobIconData);
 
    }
 
    WM_TASKBARCREATED_MESSAGE = RegisterWindowMessage(TEXT("TaskbarCreated"));
 
//  SendMessage(GetDesktopWindow(), 0x400, 0, 0); // ...hmm, not quite sure what this did anymore...?! ;)
 
    // Show/hide the plugins based on the related xoblite.rc setting...
    if (pSettings->pluginsHidden) SendMessage(hMainWnd, BB_BROADCAST, 0, (LPARAM)"@BBHidePlugins");
    else SendMessage(hMainWnd, BB_BROADCAST, 0, (LPARAM)"@BBShowPlugins");
 
    // Finally, as a "security precausion" we move the xoblite desktop window to the bottom...
    SetWindowPos(pDesktop->hDesktopWnd, HWND_BOTTOM, 0, 0, 0, 0, SWP_NOSIZE | SWP_NOMOVE | SWP_NOACTIVATE | SWP_SHOWWINDOW | SWP_NOSENDCHANGING);
 
    // Execute the current style's rootCommand...
    _beginthread(ExecuteRootCommand, 0, NULL);
 
    PlaySoundFX(SFX_STARTUP);
 
    if (pSettings->debugLogging) Log("xoblite", "All subsystems started successfully.");
 
    //====================
 
    // Check if the Blackbox font pack is installed, and if not display a warning message...
    HFONT checkPackFont = CreateFont(12, 0, 0, 0, FW_NORMAL, false, false, false, DEFAULT_CHARSET, OUT_DEFAULT_PRECIS, CLIP_DEFAULT_PRECIS, DEFAULT_QUALITY, DEFAULT_PITCH|FF_DONTCARE, "mints-strong");
    if (checkPackFont)
    {
        HDC temphdc = CreateCompatibleDC(NULL);
        HGDIOBJ oldfont = SelectObject(temphdc, checkPackFont);
        char createdFontName[33];
        GetTextFace(temphdc, 32, createdFontName);
        if (_stricmp(createdFontName, "mints-strong"))
        {
            SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_INFORMATION_MESSAGE, (LPARAM)"The Blackbox font pack does not seem to be installed. Get it from the xoblite website! -> http://xoblite.net/");
        }
 
        DeleteObject(checkPackFont);
        DeleteObject(SelectObject(temphdc, oldfont));
        DeleteDC(temphdc);
    }
 
    //====================
/*
    if (pSettings->debugLogging) // ### DEPRECATED (read: old boundary failsafe introduced by BlackboxZero, nowadays outgrown [>300 bytes] anyway...) ###
    {
        char msg[255];
        sprintf(msg, "Debug: Size of StyleItem struct -> %d bytes.", sizeof(StyleItem));
        SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_INFORMATION_MESSAGE, (LPARAM)msg);
    }
*/
    //====================
 
    // Once everything else is up and running, we first wait another 3 seconds, then perform a check for updates...
    SetTimer(GetBBWnd(), CHECK_FOR_UPDATES_DELAY_TIMER, 3000, (TIMERPROC)NULL);
}

exitBlackbox()

void exitBlackbox

(

)

{
    // Just a security precausion... ;)
    if (exitInProgress) return;
    else exitInProgress = true;
 
    // Set time stamp for end of session...
    SessionTimeStamp(false);
 
    ClearSticky();
 
    DestroyRunBox(); // ...just in case the user left the run box open upon exit...
 
    pSettings->accessLock = true;
 
    if (pSettings->underExplorer) Shell_NotifyIcon(NIM_DELETE, &xobIconData);
 
    if (pHotkeys) delete pHotkeys;
    if (pPopupDialog) delete pPopupDialog;
    if (pToolbar) delete pToolbar;
    if (pPluginManager) delete pPluginManager;
    if (pTaskbar) delete pTaskbar;
    if (pTooltips) delete pTooltips;
    if (pDock) delete pDock;
    if (pPreviewItem) delete pPreviewItem;
    if (pMenuCommon) delete pMenuCommon;
    if (pWorkspaces) delete pWorkspaces;
    if (pConsole) delete pConsole;
    if (pDesktop) delete pDesktop;
    if (pBImage) delete pBImage;
 
    UnregisterThemeFonts();
 
    if (pSettings->underExplorer)
    {
        Shell_NotifyIcon(NIM_DELETE, &xobIconData);
        DestroyIcon(xobIconData.hIcon);
    }
 
    if (pSettings->underExplorer && pSettings->explorerHidden) ShowExplorer();
 
//  if (pSettings->debugLogging) Log("xoblite", "exitBlackbox() completed successfully.");
}

restartBlackboxStop()

void restartBlackboxStop

(

)

{
    // Disable dock transparency (for some reason this needs to be 
    // done to avoid visual artifacts) and hide the dock window...
    if (pDock)
    {
        SetTransparency(pDock->hDockWnd, 255);
        ShowWindow(pDock->hDockWnd, SW_HIDE);
    }
 
    // Unload all plugins...
    if (pPluginManager) delete pPluginManager;
 
    // Shall we pause the restart to let the user do something before continuing?
    if ((GetAsyncKeyState(VK_SHIFT) & 0x8000) || pausedRestart)
    {
        MessageBox(GetBBWnd(), "Restart paused, press OK to continue...   ", "xoblite", MB_OK | MB_ICONINFORMATION | MB_TOPMOST);
        pausedRestart = false;
    }
}

restartBlackboxStart()

void restartBlackboxStart

(

)

{
    int existingWorkspaces = pSettings->numberOfWorkspaces;
 
    // Stop applicable subsystems...
    if (pHotkeys) delete pHotkeys;
    if (pPreviewItem) delete pPreviewItem;
    if (pMenuCommon) delete pMenuCommon;
 
    // Read configuration settings and style parameters...
    pSettings->ReadConfiguration();
    pSettings->ReadStyle();
 
    // Set time locale if configured...
    if (strlen(pSettings->timeDateLocale) > 0) setlocale(LC_TIME, pSettings->timeDateLocale);
    else setlocale(LC_TIME, ""); // Not configured -> Reset the time locale to the user default obtained from the operating system...
    pToolbar->GetClockText(true);
/*
    if (pSettings->debugLogging)
    {
        char msg[255];
        sprintf(msg, "Time locale set to %s.", setlocale(LC_TIME, NULL));
        SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_REGULAR_MESSAGE, (LPARAM)msg);
    }
*/
    //====================
 
    if (existingWorkspaces != pSettings->numberOfWorkspaces)
    {
//      if (pWorkspaces) delete pWorkspaces;
//      pWorkspaces = new Workspaces(hMainInstance);
        pWorkspaces->GatherWindows();
        if (pSettings->currentWorkspace > (pSettings->numberOfWorkspaces - 1))
        {
            pWorkspaces->SwitchToWorkspace(pSettings->numberOfWorkspaces - 1);
        }
    }
 
    pWorkspaces->UpdateWorkspaceNames();
 
    //====================
 
    // Start applicable subsystems again...
    pMenuCommon = new MenuCommon();
    pMenuCommon->Initialize(hMainInstance);
    pPreviewItem = new PreviewItem(hMainInstance);
    pPluginManager = new PluginManager(hMainInstance);
    pHotkeys = new Hotkeys(hMainInstance);
 
    // Update toolbar+dock+console size, position and alpha transparency...
    pToolbar->UpdatePosition();
    pDock->UpdateDockWindow();
    pConsole->UpdatePosition();
    pPopupDialog->UpdatePopupDialog();
 
    // Show/hide the toolbar, console and plugins based on their applicable .rc settings...
    ShowWindow(pToolbar->hToolbarWnd, pSettings->toolbarHidden ? SW_HIDE : SW_SHOWNOACTIVATE);
    ShowWindow(pConsole->hConsoleWnd, pSettings->consoleHidden ? SW_HIDE : SW_SHOWNOACTIVATE);
    if (pSettings->pluginsHidden) SendMessage(hMainWnd, BB_BROADCAST, 0, (LPARAM)"@BBHidePlugins");
    else SendMessage(hMainWnd, BB_BROADCAST, 0, (LPARAM)"@BBShowPlugins");
 
    // Force update of any external system tray plugins... (nb. as of xoblite bb5, the internal systray has been discontinued, but keeping this "just in case"... ;))
    PostMessage(hMainWnd, BB_TRAYUPDATE, NULL, (LPARAM)TRAYICON_REFRESH);
 
    // Ask the desktop to update...
    pDesktop->GetClockText(true);
    pDesktop->UpdateDesktopWindow();
    // Finally, as a "security precausion" we move the xoblite desktop window to the bottom...
    SetWindowPos(pDesktop->hDesktopWnd, HWND_BOTTOM, 0, 0, 0, 0, SWP_NOSIZE | SWP_NOMOVE | SWP_NOACTIVATE | SWP_SHOWWINDOW | SWP_NOSENDCHANGING);
    // ...and move the console->dock->toolbar, if not hidden, to the top...
    if (!pSettings->consoleHidden) SetForegroundWindow(pConsole->hConsoleWnd);
    if (!pSettings->dockHidden) SetForegroundWindow(pDock->hDockWnd);
    if (!pSettings->toolbarHidden) SetForegroundWindow(pToolbar->hToolbarWnd);
 
    // Should we hide or show the Explorer taskbar etc? (i.e. if the related setting has changed)
    if (pSettings->underExplorer && pSettings->explorerHidden) HideExplorer(true);
    else ShowExplorer();
 
    // Start Designer Mode (i.e. load the xDesignerGUI.dll privileged plugin) again if it was enabled before the core restart...
    if (pSettings->designerModeEnabled)
    {
        char xDGUIpath[MAX_PATH];
        sprintf(xDGUIpath, "%s\\%s", pSettings->SF_blackboxPath, "xDesignerGUI.dll");
        if (!pPluginManager->IsPluginLoaded("xDesignerGUI.dll")) pPluginManager->LoadPlugin(xDGUIpath);
    }
 
    //====================
 
    _beginthread(ExecuteRootCommand, 0, NULL);
}

ExecuteRootCommand()

void ExecuteRootCommand

(

void *

)

{
    if (!pSettings->disableRootCommands)
    {
        if (!(GetAsyncKeyState(VK_CONTROL) & 0x8000)) // -> Do not run the rootCommand if the control key is held down...
        {
            char temp[MAX_LINE_LENGTH] = "", param[32];
 
            if (pSettings->wallpaperPerWorkspace && (pSettings->currentWorkspace > 0))
            {
                sprintf(param, "rootCommand%d:", (pSettings->currentWorkspace + 1));
                strcpy(temp, ReadString(stylePath(), param, ""));
            }
 
            if (strlen(temp) == 0) strcpy(temp, ReadString(stylePath(), "rootCommand:", ""));
 
            if (strlen(temp) > 0)
            {
                strcpy(pSettings->rootCommand, temp);
                pWallpaper->ExecuteRootCommand();
            }
        }
    }
    else SystemParametersInfo(SPI_SETDESKWALLPAPER, 0, NULL, SPIF_SENDCHANGE); // Trigger desktop repaint under Windows Vista (...iirc?)
 
    _endthread();
}

ShutdownWindows()

void ShutdownWindows	(	int	state,
		bool	skipAsking )

{
    if (!skipAsking)
    {
        PlaySoundFX(SFX_MENU_CLICK);
 
        if (state == 0) SendMessage(GetBBWnd(), BB_POPUPMESSAGE, (WPARAM)"Are you sure you want to shut down your computer?", (LPARAM)"@xoblite System Shutdown");
        else if (state == 1) SendMessage(GetBBWnd(), BB_POPUPMESSAGE, (WPARAM)"Are you sure you want to reboot your computer?", (LPARAM)"@xoblite System Reboot");
        else if (state == 2) SendMessage(GetBBWnd(), BB_POPUPMESSAGE, (WPARAM)"Are you sure you want to log off?", (LPARAM)"@xoblite System LogOff");
        else if (state == 3) SendMessage(GetBBWnd(), BB_POPUPMESSAGE, (WPARAM)"Are you sure you want to hibernate?", (LPARAM)"@xoblite System Hibernate");
        else if (state == 4) SendMessage(GetBBWnd(), BB_POPUPMESSAGE, (WPARAM)"Are you sure you want to standby?", (LPARAM)"@xoblite System Standby");
        else return;
    }
    else
    {
        if (state < 3)
        {
            // To avoid a hanging Blackbox.exe due to e.g. slow unloading
            // plugins or certain hooks we perform the shell exit procedure
            // before initiating shutdown/reboot/logoff. Note that we can
            // always startBlackbox() again if the shutdown fails! (see below)
            exitBlackbox();
        }
        else
        {
            // Hibernate or standby -> Set time stamp for end of session...
            SessionTimeStamp(false);
        }
 
        // Run the shutdown functions in their own thread...
        shutdownState = state;
        _beginthread(ShutdownThread, 0, NULL);
    }
}

ShutdownThread()

void ShutdownThread

(

void *

)

{
    // Log off?
    if (shutdownState == 2)
    {
        if (!ExitWindowsEx(EWX_LOGOFF, SHTDN_REASON_FLAG_PLANNED))
        {
            MBoxErrorValue("Log off failed");
            PostMessage(GetBBWnd(), BB_RESTART, 0, 0);
        }
        else
        {
            debugLogoff = true;
//          PostMessage(hMainWnd, WM_CLOSE, 0, 0);
            PostQuitMessage(0);
        }
 
        _endthread();
    }
 
    //====================
 
    HANDLE hToken = NULL; 
    TOKEN_PRIVILEGES tkp; 
        
    OSVERSIONINFO osInfo;
    ZeroMemory(&osInfo, sizeof(osInfo));
    osInfo.dwOSVersionInfoSize = sizeof(osInfo);
    GetVersionEx(&osInfo);
 
    // Under WinNT/2k/XP we need to adjust priviliges to be able to shutdown/reboot/hibernate/standby...
    if (osInfo.dwPlatformId == VER_PLATFORM_WIN32_NT)
    {
        // Get a token for this process...
        if (!OpenProcessToken(GetCurrentProcess(), TOKEN_ADJUST_PRIVILEGES | TOKEN_QUERY, &hToken))
        {
            MBoxErrorValue("OpenProcessToken failed");
            PostMessage(GetBBWnd(), BB_RESTART, 0, 0);
            _endthread();
        }
 
        // Get the LUID for the shutdown privilege... 
        LookupPrivilegeValue(NULL, SE_SHUTDOWN_NAME, &tkp.Privileges[0].Luid); 
        tkp.PrivilegeCount = 1;  // one privilege to set    
        tkp.Privileges[0].Attributes = SE_PRIVILEGE_ENABLED; 
 
        // Get the shutdown privileges for this process...
        AdjustTokenPrivileges(hToken, false, &tkp, 0, (PTOKEN_PRIVILEGES)NULL, 0); 
        if (GetLastError() != ERROR_SUCCESS)
        {
            MBoxErrorValue("AdjustTokenPrivileges failed");
            PostMessage(GetBBWnd(), BB_RESTART, 0, 0);
            _endthread();
        }
    }
    
    //====================
 
    if (shutdownState == 0) // Shutdown?
    {
        if (!ExitWindowsEx(EWX_SHUTDOWN | EWX_POWEROFF, SHTDN_REASON_FLAG_PLANNED))
        {
            MBoxErrorValue("Shutdown failed!");
            PostMessage(GetBBWnd(), BB_RESTART, 0, 0);
        }
        else
        {
            debugShutdown = true;
//          PostMessage(hMainWnd, WM_CLOSE, 0, 0);
            PostQuitMessage(0);
        }
    }
    else if (shutdownState == 1) // Reboot?
    {
        if (!ExitWindowsEx(EWX_REBOOT, SHTDN_REASON_FLAG_PLANNED))
        {
            MBoxErrorValue("Reboot failed!");
            // As the (un)installer may initiate a reboot we need to check
            // if the reboot was initiated by the (un)installer before
            // attempting to restart the shell... (see ShutdownWindows above)
            PostMessage(GetBBWnd(), BB_RESTART, 0, 0);
        }
        else
        {
            debugReboot = true;
//          PostMessage(hMainWnd, WM_CLOSE, 0, 0);
            PostQuitMessage(0);
        }
    }
    else if (shutdownState == 3) // Hibernate? (a.k.a. "safe sleep" and "suspend to disk")
    {
        if (!SetSystemPowerState(FALSE, FALSE)) MBoxErrorValue("Hibernate failed!");
//      ZeroMemory(&pSettings->Statistics, sizeof(pSettings->Statistics)); // Reset statistics...
        Sleep(3000); // Allow system clock some time to update after waking up... (note that we're running in a separate thread)
        SessionTimeStamp(true); // Begin new session...
        SetTimer(GetBBWnd(), CHECK_FOR_UPDATES_DELAY_TIMER, 3000, (TIMERPROC)NULL); // Wait 3 seconds, then perform a check for updates...
    }
    else if (shutdownState == 4) // Standby? (a.k.a. "sleep" and "suspend to RAM")
    {
        if (!SetSystemPowerState(TRUE, FALSE)) MBoxErrorValue("Standby failed!");
//      ZeroMemory(&pSettings->Statistics, sizeof(pSettings->Statistics)); // Reset statistics...
        Sleep(3000); // Allow system clock some time to update after waking up... (note that we're running in a separate thread)
        SessionTimeStamp(true); // Begin new session...
        SetTimer(GetBBWnd(), CHECK_FOR_UPDATES_DELAY_TIMER, 3000, (TIMERPROC)NULL); // Wait 3 seconds, then perform a check for updates...
    }
 
    // Disable shutdown privilege...
    tkp.Privileges[0].Attributes = 0; 
    AdjustTokenPrivileges(hToken, FALSE, &tkp, 0, (PTOKEN_PRIVILEGES) NULL, 0);
 
    _endthread();
}

HideDesktopIcons()

void HideDesktopIcons

(

bool

hide

)

{
    HWND window = FindWindow("Progman", "Program Manager");
    if (window != NULL)
    {
        window = FindWindowEx(window, NULL, "SHELLDLL_DefView", "");
        if (window != NULL)
        {
            window = FindWindowEx(window, NULL, "SysListView32", "FolderView");
            if (window != NULL)
            {
                if (hide)
                {
                    if (IsWindowVisible(window))
                    {
                        ShowWindow(window, SW_HIDE);
                        desktopIconsPreviouslyHidden = true;
                    }
                }
                else if (desktopIconsPreviouslyHidden) ShowWindow(window, SW_SHOWNOACTIVATE);
                return;
            }
        }
    }
/*
    window = FindWindow("", "WorkerW");
    if (window != NULL)
    {
        window = FindWindowEx(window, NULL, "SHELLDLL_DefView", "");
        if (window != NULL)
        {
            window = FindWindowEx(window, NULL, "SysListView32", "FolderView");
            if (window != NULL)
            {
                if (hide) ShowWindow(window, SW_HIDE);
                else ShowWindow(window, SW_SHOWNOACTIVATE);
                return;
            }
        }
    }
*/
}

SessionTimeStamp()

void SessionTimeStamp

(

bool

beginSession

)

{
    time_t systemSessionTime;
    struct tm *localSessionTime;
    char timeStampString[MAX_LINE_LENGTH], msg[MAX_LINE_LENGTH];
 
    time(&systemSessionTime);
    localSessionTime = localtime(&systemSessionTime);
 
    //====================
 
    _locale_t timestampLocale = _create_locale(LC_TIME, "en-US"); // -> Always use en-US format for the console timestamp...
    if (strstr(pSettings->toolbarClockFormat, "%p"))
    {
        // 12-hour clock including the current locale's AM/PM indicator
        _strftime_l(timeStampString, MAX_LINE_LENGTH, "%a %#d %b at %I:%M %p", localSessionTime, timestampLocale);
    }
    else
    {
        // 24-hour clock
        _strftime_l(timeStampString, MAX_LINE_LENGTH, "%a %#d %b at %H:%M", localSessionTime, timestampLocale);
    }
    _free_locale(timestampLocale);
 
    //====================
 
    if (beginSession)
    {
        sessionDuration = 0;
        SetTimer(GetBBWnd(), SESSION_DURATION_TIMER, 60000, (TIMERPROC)NULL);
        sprintf(msg, "Session begins %s.", timeStampString);
    }
    else
    {
        KillTimer(GetBBWnd(), SESSION_DURATION_TIMER);
        int durHours = sessionDuration / 60;
        int durMinutes = sessionDuration % 60;
//      sprintf(msg, "Session ends %s (duration %d hour(s) %d minute(s)).", timeStampString, durHours, durMinutes);
        sprintf(msg, "Session ends %s (duration %d:%02d).", timeStampString, durHours, durMinutes);
    }
 
    SendMessage(GetBBWnd(), BB_CONSOLEMESSAGE, (WPARAM)CONSOLE_REGULAR_MESSAGE, (LPARAM)msg);
    Log("TimeStamp", msg);
}

CheckForUpdates()

void CheckForUpdates

(

)

{
    if (pPluginManager && _stricmp(pSettings->checkedForUpdates, "*Disabled*")) _beginthread(periodicCheckForUpdates, 0, NULL);
}