added wxTLS_TYPE() macro

[wxWidgets.git] / interface / wx / msw / ole / activex.h

/////////////////////////////////////////////////////////////////////////////
// Name:        msw/ole/activex.h
// Purpose:     interface of wxActiveXEvent
// Author:      wxWidgets team
// RCS-ID:      $Id$
// Licence:     wxWindows license
/////////////////////////////////////////////////////////////////////////////

/**
    @class wxActiveXEvent

    An event class for handling activex events passed from wxActiveXContainer.

    ActiveX events are basically a function call with the parameters passed
    through an array of wxVariants along with a return value that is a wxVariant
    itself. What type the parameters or return value are depends on the context
    (i.e. what the .idl specifies).

    Note that unlike the third party wxActiveX function names are not supported.

    @onlyfor{wxmsw}

    @library{wxbase}
    @category{FIXME}
*/
class wxActiveXEvent : public wxCommandEvent
{
public:
    /**
        Returns the dispatch id of this activex event. This is the numeric value from
        the .idl file specified by the id().
    */
    DISPID GetDispatchId(int idx) const;

    /**
        Obtains the number of parameters passed through the activex event.
    */
    size_t ParamCount() const;

    /**
        Obtains the param name of the param number idx specifies as a string.
    */
    wxString ParamName(size_t idx) const;

    /**
        Obtains the param type of the param number idx specifies as a string.
    */
    wxString ParamType(size_t idx) const;

    /**
        Obtains the actual parameter value specified by idx.
    */
    wxVariant operator[](size_t idx);
};



/**
    @class wxActiveXContainer

    wxActiveXContainer is a host for an activex control on Windows (and
    as such is a platform-specific class). Note that the HWND that the class
    contains is the actual HWND of the activex control so using dynamic events
    and connecting to wxEVT_SIZE, for example, will recieve the actual size
    message sent to the control.

    It is somewhat similar to the ATL class CAxWindow in operation.

    The size of the activex control's content is generally gauranteed to be that
    of the client size of the parent of this wxActiveXContainer.

    You can also process activex events through wxEVT_ACTIVEX or the
    corresponding message map macro EVT_ACTIVEX.

    @onlyfor{wxmsw}

    @library{wxbase}
    @category{FIXME}

    @see wxActiveXEvent
*/
class wxActiveXContainer : public wxControl
{
public:
    /**
        Creates this activex container.

        @param parent
            parent of this control.  Must not be @NULL.
        @param iid
            COM IID of pUnk to query. Must be a valid interface to an activex control.
        @param pUnk
            Interface of activex control.
    */
    wxActiveXContainer(wxWindow* parent, REFIID iid, IUnknown* pUnk);
};