example_sutoolbar.cpp

This is an example of how to use the SUToolBar class. It assumes there is a toolbar resource named IDR_TOOLBAR, with two buttons, ID_LOAD_TBBUTTON and ID_SAVE_TBBUTTON.

#include <ShapeUpAPI.h>
#include "./resource.h"

SURESULT __cdecl HookFunc(SUHANDLE hWorkspace, int hookType, SUHookData *args);
SURESULT __cdecl OnToolBarButton(SUHANDLE hWorkspace, SUToolBarButtonHookData* args);
SURESULT __cdecl OnIdle(SUHANDLE hWorkspace, SUHookData *args);

// Our toolbar
SUToolBar toolbar;

// Every plug-in needs an instance of SUExport called suapi
SUExport suapi;

size_t __cdecl fnVersion()
{
    return SHAPEUP_API_VERSION;
}

const GUID* __cdecl fnGUID()
{
    // CREATE YOUR OWN GUID !!
    // {97F4EA41-7D7E-42c1-B555-2D4C86C912A7}
    static const GUID guid = 
        { 0x97f4ea41, 0x7d7e, 0x42c1, { 0xb5, 0x55, 0x2d, 0x4c, 0x86, 0xc9, 0x12, 0xa7 } };
    return &guid;
}

SURESULT __cdecl fnInit(SUExport *pExport)
{
    AFX_MANAGE_STATE(AfxGetStaticModuleState());

    pExport->import.pszName = "Test of GPI and ShapeUp API";
    pExport->import.pszDescription = "Test of GPI and ShapeUp API\nGPI Test";
    pExport->import.pszInfo = "Copyright (c) 2007";
    pExport->import.pszPluginVersion = "1.00";

    // Now keep the entire struct which is the actual ShapeUp API
    // (we need the function pointers later)
    ::memcpy(&suapi, pExport, sizeof(SUExport));

    // Set-up our hook callback
    pExport->import.pfnHook = HookFunc;

    // We want to get notified when the user presses our toolbar buttons
    ShapeUp_AddToolBarButtonHook(0);
    // The idle hook is used to set the state of toolbar buttons (disabled/checked/...)
    ShapeUp_AddIdleHook(0);

    // Create our toolbar
    toolbar.Create(AfxGetInstanceHandle(), IDR_TOOLBAR, "Test of GPI Toolbar");

    return SURESULT_OK;
}

// ShapeUp will call this function when an event occurs
SURESULT __cdecl HookFunc(SUHANDLE hWorkspace, int hookType, SUHookData *args)
{
    AFX_MANAGE_STATE(AfxGetStaticModuleState());

    switch (hookType)
    {
    case HOOKTYPE_TOOLBARBUTTON:
        return OnToolBarButton(hWorkspace, (SUToolBarButtonHookData*) args);
    case HOOKTYPE_IDLE:
        return OnIdle(hWorkspace, args);
    default:
        break;
    }

    return SURESULT_OK;
}

SURESULT __cdecl OnToolBarButton(SUHANDLE hWorkspace, SUToolBarButtonHookData* args)
{
    try
    {
        switch (args->nCommandID)
        {
        case ID_LOAD_TBBUTTON:
            {
                CFileDialog dlg(TRUE);
                if (dlg.DoModal() == IDOK)
                {
                }
            }
            break;
        case ID_SAVE_TBBUTTON:
            {
                CFileDialog dlg(FALSE);
                if (dlg.DoModal() == IDOK)
                {
                }
            }
            break;
        default:
            break;
        }
    }
    catch (SUException &ex)
    {
        AfxMessageBox(ex.GetErrorDesc().c_str(), 0, 0);
    }

    return SURESULT_OK;
}


SURESULT __cdecl OnIdle(SUHANDLE hWorkspace, SUHookData *args)
{
    try
    {
        if (hWorkspace != NULL)
        {
            SUWorkspace workspace(hWorkspace);

            bool bChecked = /* some condition */;
            bool bEnabled = /* some condition */;

            toolbar.SetButtonChecked(ID_SAVE_TBBUTTON, bChecked);

            toolbar.SetButtonEnabled(ID_LOAD_TBBUTTON, bEnabled);
            toolbar.SetButtonEnabled(ID_SAVE_TBBUTTON, bEnabled);
        }
        else
        {
            // If there's no active workspace, we disable the buttons
            toolbar.SetButtonEnabled(ID_LOAD_TBBUTTON, false);
            toolbar.SetButtonEnabled(ID_SAVE_TBBUTTON, false);
        }
    }
    catch (SUException &/*ex*/)
    {
        // Do NOT open any message boxes from here
    }

    return SURESULT_OK;
}

---