example_sudatapage.cpp

This is an example of how to add custom data pages in ShapeUp. In this particular example, a page containing a singe tree control is created and populated with some dummy data.

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

SURESULT __cdecl HookFunc(SUHANDLE hWorkspace, int hookType, SUHookData *args);
SURESULT __cdecl OnWorkspaceReady(SUHANDLE hWorkspace);

// 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 a workspace has been initialized
    // We cannot add a data page before this event has occurred!
    ShapeUp_AddWorkspaceReadyHook(0);

    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_WORKSPACEREADY:
        // At this point, it's ok to add a data page!
        return OnWorkspaceReady(hWorkspace);
    default:
        break;
    }

    return SURESULT_OK;
}

SURESULT __cdecl OnWorkspaceReady(SUHANDLE hWorkspace)
{
    try
    {
        SUWorkspace workspace(hWorkspace);
        SUDataPage page = workspace.AddDataPage("Tree data");

        // Create a tree view control
        VERIFY(AfxDeferRegisterClass(AFX_WNDCOMMCTL_TREEVIEW_REG));

        // The style to be. WS_CHILD is important.
        DWORD dwStyle = WS_VISIBLE | WS_TABSTOP | WS_CHILD
                    | TVS_HASBUTTONS | TVS_LINESATROOT | TVS_HASLINES
                    | TVS_DISABLEDRAGDROP;

        // Ask the data page for its windows handle to use as the new
        // controls parent
        HWND hwndParent = page.GetHWND();

        // Ctrl id. Any id is good.
        UINT nID = 42001;

        // Create the control
        HWND hWnd = ::CreateWindowEx(0, WC_TREEVIEW,
            NULL, dwStyle, 0, 0, 100, 100,
            hwndParent, (HMENU)(UINT_PTR)nID, AfxGetInstanceHandle(), NULL);

        if (hWnd != NULL)
        {
            // Populate the control
            TV_INSERTSTRUCT is;
            is.hInsertAfter = NULL;
            is.hParent = NULL;
            is.item.mask = TVIF_TEXT;
            is.item.pszText = "First line";
            
            HTREEITEM hRoot = TreeView_InsertItem(hWnd, &is);
            is.hParent = hRoot;
            is.item.pszText = "Another line";
            for (int i = 0; i < 400; ++i)
                TreeView_InsertItem(hWnd, &is);
        }
        else
            page.Remove();
    }
    catch (SUException &ex)
    {
        AfxMessageBox(ex.GetErrorDesc().c_str(), 0, 0);
    }

    return SURESULT_OK;
}

---