home *** CD-ROM | disk | FTP | other *** search
/ PC Press 1997 July / Sezamfile97_2.iso / windows / program / activex / axtsamp.exe / TSBRANCH.EXE / FRESERVE / BALL.H < prev    next >
C/C++ Source or Header  |  1997-01-04  |  8KB  |  219 lines
  1. /*+==========================================================================
  2.   File:      BALL.H
  3.  
  4.   Summary:   Include file for the aggregatable COBall COM object class.
  5.  
  6.              COBall offers a main standard IUnknown interface (basic COM
  7.              object features) and the custom IBall interface (moving
  8.              ball-related features).  This multiple interface COM Object
  9.              Class is achieved via the technique of nested classes.  The
  10.              implementation of the IBall interface is nested inside of the
  11.              COBall Class.
  12.  
  13.              This file also declares some internal C++ classes (CXForm and
  14.              CBallThread) that provide internal support for the custom
  15.              IBall interface.
  16.  
  17.              For a comprehensive tutorial code tour of this module's
  18.              contents and offerings see the tutorial FRESERVE.HTM file.
  19.              For more specific technical details on the internal workings
  20.              see the comments dispersed throughout the module's source code.
  21.  
  22.   Functions:
  23.  
  24.   Classes:   CXForm, CBallThread, COBall.
  25.  
  26.   Origin:    4-5-96: atrent - Editor-inheritance from CAR.H in
  27.              the DLLSERVE Tutorial Code Sample. Also borrows from
  28.              the GDIDEMO sample in the Win32 samples of the Win32 SDK.
  29.  
  30. ----------------------------------------------------------------------------
  31.   This file is part of the Microsoft ActiveX Tutorial Code Samples.
  32.  
  33.   Copyright (C) Microsoft Corporation, 1997.  All rights reserved.
  34.  
  35.   This source code is intended only as a supplement to Microsoft
  36.   Development Tools and/or on-line documentation.  See these other
  37.   materials for detailed information regarding Microsoft code samples.
  38.  
  39.   THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
  40.   KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  41.   IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
  42.   PARTICULAR PURPOSE.
  43. ==========================================================================+*/
  44.  
  45. #if !defined(BALL_H)
  46. #define BALL_H
  47.  
  48. #ifdef __cplusplus
  49.  
  50. enum { MAX_BALLTHREADS = 64, BALL_MOVE_SKEW = 5 };
  51.  
  52.  
  53. /*C+C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C
  54.   Class:    CXForm
  55.  
  56.   Summary:  A utility class with methods for performing point
  57.             transformations on points that represent space/location in two
  58.             dimensions.
  59.  
  60.   Methods:  Clear
  61.               Clears the transformation matrix.
  62.             Scale
  63.               Set transformation to multiply by a scale factor.
  64.             Trans
  65.               Perform transformation.
  66.             Point
  67.               Get point.
  68.             CXForm
  69.               Constructor.
  70.             ~CXForm
  71.               Destructor.
  72. C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C-C*/
  73. class CXForm
  74. {
  75.   private:
  76.     int XForm[3][3];
  77.  
  78.   public:
  79.     CXForm(void) {};
  80.     ~CXForm(void) {};
  81.     void Clear(void);
  82.     void Scale(int xScale, int yScale);
  83.     void Trans(int xTrans, int yTrans);
  84.     void Point(POINT* pPoint);
  85. };
  86.  
  87.  
  88. /*C+C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C+++C
  89.   Class:    CBallThread
  90.  
  91.   Summary:  A class for simple objects used to store properties of threads.
  92.             An array of these is used to remember the threads that came
  93.             visiting the CBall object.
  94.  
  95.   Methods:  CBallThread
  96.               Constructor.
  97.             ~CBallThread
  98.               Destructor.
  99. C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C---C-C*/
  100. class CBallThread
  101. {
  102.   public:
  103.     DWORD Id;
  104.     COLORREF Color;
  105.  
  106.     CBallThread(void) {};
  107.     ~CBallThread(void) {};
  108. };
  109.  
  110.  
  111. /*O+O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O
  112.   ObjectClass: COBall
  113.  
  114.   Summary:     COM object class for COBall COM objects.  COM objects of
  115.                this class offer IBall interface features, Reset, Move, and
  116.                GetBall. The mulitple interfaces on this COM object are
  117.                constructed via the nested interface classes technique.
  118.  
  119.   Interfaces:  IUnknown
  120.                  Standard interface providing COM object features.
  121.                IBall
  122.                  Basic Ball operation features.
  123.  
  124.   Aggregation: Yes, COBall COM Objects are aggregatable by passing
  125.                a non-NULL pUnkOuter IUnknown pointer into the constructor.
  126. O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O-O*/
  127. class COBall : public IUnknown, public CThreaded
  128. {
  129.   public:
  130.     // Main Object Constructor & Destructor.
  131.     COBall(IUnknown* pUnkOuter, CServer* pServer);
  132.     ~COBall(void);
  133.  
  134.     // IUnknown methods. Main object, non-delegating.
  135.     STDMETHODIMP         QueryInterface(REFIID, PPVOID);
  136.     STDMETHODIMP_(ULONG) AddRef(void);
  137.     STDMETHODIMP_(ULONG) Release(void);
  138.  
  139.   private:
  140.     // We declare nested class interface implementations here.
  141.  
  142.     class CImpIBall : public IBall, public CThreaded
  143.     {
  144.       public:
  145.         // Interface Implementation Constructor & Destructor.
  146.         CImpIBall(COBall* pBackObj, IUnknown* pUnkOuter);
  147.         ~CImpIBall(void);
  148.  
  149.         // IUnknown methods.
  150.         STDMETHODIMP         QueryInterface(REFIID, PPVOID);
  151.         STDMETHODIMP_(ULONG) AddRef(void);
  152.         STDMETHODIMP_(ULONG) Release(void);
  153.  
  154.         // IBall methods.
  155.         STDMETHODIMP Reset(RECT* pNewRect, short nBallSize);
  156.         STDMETHODIMP GetBall(POINT* pOrg, POINT* pExt, COLORREF* pcrColor);
  157.         STDMETHODIMP Move(BOOL bAlive);
  158.  
  159.       private:
  160.         // Data private to this COBall interface implementation of IBall.
  161.         COBall*      m_pBackObj;     // Parent Object back pointer.
  162.         IUnknown*    m_pUnkOuter;    // Outer unknown for Delegation.
  163.  
  164.         // The following private data and methods constitute the working
  165.         // heart of COBall as an actual application object.
  166.         BOOL         m_bAlive;
  167.         RECT         m_WinRect;
  168.         int          m_nWidth;
  169.         int          m_nHeight;
  170.         int          m_xDirection;
  171.         int          m_yDirection;
  172.         BOOL         m_bNewPosition;
  173.         int          m_xPosition;
  174.         int          m_yPosition;
  175.         short        m_xSkew;
  176.         short        m_ySkew;
  177.         COLORREF     m_crColor;
  178.         CXForm       m_XForm;
  179.         CBallThread  m_aBallThreads[MAX_BALLTHREADS];
  180.  
  181.         // Private methods for internal use.
  182.         void GetDimensions(POINT*);
  183.         void SetDimensions(int,int);
  184.         void GetDirection(POINT*);
  185.         void SetDirection(int,int);
  186.         void GetPosition(POINT*);
  187.         void SetPosition(int,int);
  188.         void CheckBounce(void);
  189.         void FindThread(void);
  190.     };
  191.  
  192.     // Make the otherwise private and nested IBall interface implementation
  193.     // a friend to COM object instantiations of this selfsame COBall
  194.     // COM object class.
  195.     friend CImpIBall;
  196.  
  197.     // Private data of COBall COM objects.
  198.  
  199.     // Nested IBall implementation instantiation.  This IBall interface
  200.     // is instantiated inside this COBall object as a native interface.
  201.     CImpIBall        m_ImpIBall;
  202.  
  203.     // Main Object reference count.
  204.     ULONG            m_cRefs;
  205.  
  206.     // Outer unknown (aggregation & delegation).
  207.     IUnknown*        m_pUnkOuter;
  208.  
  209.     // Pointer to this component server's control object.
  210.     CServer*         m_pServer;
  211. };
  212.  
  213. typedef COBall* PCOBall;
  214.  
  215. #endif // __cplusplus
  216.  
  217.  
  218. #endif // BALL_H
  219.