IRUNOBJ.CPP

/* 
* IRUNOBJ.CPP
* Polyline Component Chapter 19
*
* Implementation of the IRunnableObject interface which allows
* us to enter the "running" state which means Polyline's dialog
* box is created, but not visible. This is necessary so that
* containers can ask for our extents before calling DoVerb.
*
* Copyright (c)1993-1995 Microsoft Corporation, All Rights Reserved
*
* Kraig Brockschmidt, Microsoft
* Internet : kraigb@microsoft.com
* Compuserve: >INTERNET:kraigb@microsoft.com
*/


#include "polyline.h"


/*
* CImpIRunnableObject::CImpIRunnableObject
* CImpIRunnableObject::~CImpIRunnableObject
*
* Parameters (Constructor):
* pObj PCPolyline of the object we're in.
* pUnkOuter LPUNKNOWN to which we delegate.
*/

CImpIRunnableObject::CImpIRunnableObject(PCPolyline pObj
, LPUNKNOWN pUnkOuter)
{
m_cRef=0;
m_pObj=pObj;
m_pUnkOuter=pUnkOuter;
return;
}

CImpIRunnableObject::~CImpIRunnableObject(void)
{
return;
}



/*
* CImpIRunnableObject::QueryInterface
* CImpIRunnableObject::AddRef
* CImpIRunnableObject::Release
*
* Purpose:
* Delegating IUnknown members for CImpIRunnableObject.
*/

STDMETHODIMP CImpIRunnableObject::QueryInterface(REFIID riid
, LPVOID *ppv)
{
return m_pUnkOuter->QueryInterface(riid, ppv);
}


STDMETHODIMP_(ULONG) CImpIRunnableObject::AddRef(void)
{
++m_cRef;
return m_pUnkOuter->AddRef();
}

STDMETHODIMP_(ULONG) CImpIRunnableObject::Release(void)
{
--m_cRef;
return m_pUnkOuter->Release();
}




/*
* CImpIRunnableObject::GetRunningClass
*
* Purpose:
* Returns the CLSID of the object.
*
* Parameters:
* pClsID LPCLSID in which to store the CLSID.
*
* Return Value:
* HRESULT NOERROR or a general error value.
*/

STDMETHODIMP CImpIRunnableObject::GetRunningClass(LPCLSID pClsID)
{
*pClsID=m_pObj->m_clsID;
return NOERROR;
}





/*
* CImpIRunnableObject::Run
*
* Purpose:
* Run an object in the given bind context, that is, put the object
* into the running state.
*
* Parameters:
* pBindCtx LPBINDCTX of the bind context to use.
*
* Return Value:
* HRESULT NOERROR or a general error value.
*/

STDMETHODIMP CImpIRunnableObject::Run(LPBINDCTX pBindCtx)
{
/*
* Create the dialog but not show it. This function is called
* from OleRun which is called from within OleCreate. So when
* a container creates this object, we'll create the dialog
* which is a basis for the object's extents (as returned from
* IViewObject2::GetExtent. Our IOleObject::DoVerb will later
* note that the dialog is already created and will just make
* it visible and not create it anew.
*
* Note that the dialog is unowned--it acts like an overlapped
* window.
*/

if (NULL!=m_pObj->m_hDlg)
return NOERROR;

//This stores the dialog handle in m_pObj.
CreateDialogParam(m_pObj->Instance()
, MAKEINTRESOURCE(IDD_EDITDIALOG), NULL, PolyDlgProc
, (LPARAM)m_pObj);

if (NULL==m_pObj->m_hDlg)
return ResultFromScode(E_OUTOFMEMORY);

return NOERROR;
}





/*
* CImpIRunnableObject::IsRunning
*
* Purpose:
* Answers whether an object is currently in the running state.
*
* Parameters:
* None
*
* Return Value:
* BOOL Indicates the running state of the object.
*/

STDMETHODIMP_(BOOL) CImpIRunnableObject::IsRunning(void)
{
return (NULL!=m_pObj->m_hDlg);
}






/*
* CImpIRunnableObject::LockRunning
*
* Purpose:
* Locks an already running object into the running state or unlocks
* it from such a state.
*
* Parameters:
* fLock BOOL indicating lock (TRUE) or unlock
* (FALSE)
* fLastUnlockCloses BOOL indicating if the last call to this
* function with fLock==FALSE closes the
* object.
*
* Return Value:
* HRESULT NOERROR or a general error value.
*/

STDMETHODIMP CImpIRunnableObject::LockRunning(BOOL fLock
, BOOL fLastUnlockCloses)
{
//Calling CoLockObjectExternal is all we have to do here.
return CoLockObjectExternal(this, fLock, fLastUnlockCloses);
}






/*
* CImpIRunnableObject::SetContainedObject
*
* Purpose:
* Informs the object (embedded object) that it is inside a
* compound document container.
*
* Parameters:
* fContained BOOL indicating if the object is now contained.
*
* Return Value:
* HRESULT NOERROR or a general error value.
*/

STDMETHODIMP CImpIRunnableObject::SetContainedObject(BOOL fContained)
{
//We can ignore this.
return NOERROR;
}