SINK.H
上传用户:bangxh
上传日期:2007-01-31
资源大小:42235k
文件大小:5k
源码类别:

Windows编程

开发平台:

Visual C++

  1. /*+==========================================================================
  2.   File:      SINK.H
  3.   Summary:   Include file for the COBallSink COM object class.
  4.              COBallSink offers a main IUnknown interface and the IBallSink
  5.              interface (outgoing connection events from moving COBall
  6.              objects). This multiple interface COM Object Class is
  7.              achieved via the technique of nested classes.  The
  8.              implementation of the IBallSink interface is nested inside of
  9.              the COBallSink Class.
  10.              For a comprehensive tutorial code tour of this module's
  11.              contents and offerings see the tutorial CONCLIEN.HTM file.
  12.              For more specific technical details on the internal workings
  13.              see the comments dispersed throughout the module's source code.
  14.   Functions:
  15.   Classes:   COBallSink.
  16.   Origin:    6-3-96: atrent - Editor-inheritance from BALL.H in the
  17.              CONSERVE Tutorial Code Sample.
  18. ----------------------------------------------------------------------------
  19.   This file is part of the Microsoft COM Tutorial Code Samples.
  20.   Copyright (C) Microsoft Corporation, 1997.  All rights reserved.
  21.   This source code is intended only as a supplement to Microsoft
  22.   Development Tools and/or on-line documentation.  See these other
  23.   materials for detailed information regarding Microsoft code samples.
  24.   THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
  25.   KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  26.   IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
  27.   PARTICULAR PURPOSE.
  28. ==========================================================================+*/
  29. #if !defined(SINK_H)
  30. #define SINK_H
  31. #ifdef __cplusplus
  32. /*O+O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O+++O
  33.   ObjectClass: COBallSink
  34.   Summary:     The main Sink COM object class for COBallSink COM objects.
  35.                COM objects of this class offer the IBallSink sink
  36.                interface supporting various ball bounce events. The
  37.                mulitple interfaces on this COM object are constructed via
  38.                the nested interface classes technique.
  39.   Interfaces:  IUnknown
  40.                  Standard interface providing COM object features.
  41.                IBallSink
  42.                  Sink interface for Ball events.
  43.   Aggregation: Yes, COBall COM Objects are aggregatable by passing
  44.                a non-NULL pUnkOuter IUnknown pointer into the constructor.
  45. O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O---O-O*/
  46. class COBallSink : public IUnknown
  47. {
  48.   public:
  49.     // Main Object Constructor & Destructor.
  50.     COBallSink(IUnknown* pUnkOuter, CGuiBall* pGuiBall);
  51.     ~COBallSink(void);
  52.     // IUnknown methods. Main object, non-delegating.
  53.     STDMETHODIMP         QueryInterface(REFIID, PPVOID);
  54.     STDMETHODIMP_(ULONG) AddRef(void);
  55.     STDMETHODIMP_(ULONG) Release(void);
  56.   private:
  57.     // We declare nested class interface implementations here.
  58.     class CImpIBallSink : public IBallSink
  59.     {
  60.       public:
  61.         // Interface Implementation Constructor & Destructor.
  62.         CImpIBallSink(COBallSink* pBackObj, IUnknown* pUnkOuter);
  63.         ~CImpIBallSink(void);
  64.         // IUnknown methods.
  65.         STDMETHODIMP         QueryInterface(REFIID, PPVOID);
  66.         STDMETHODIMP_(ULONG) AddRef(void);
  67.         STDMETHODIMP_(ULONG) Release(void);
  68.         // IBallSink methods.
  69.         STDMETHODIMP         BounceBottom(void);
  70.         STDMETHODIMP         BounceLeft(void);
  71.         STDMETHODIMP         BounceRight(void);
  72.         STDMETHODIMP         BounceTop(void);
  73.       private:
  74.         // Data private to this interface implementation of IBallSink.
  75.         COBallSink*  m_pBackObj;     // Parent Object back pointer.
  76.         IUnknown*    m_pUnkOuter;    // Outer unknown for Delegation.
  77.     };
  78.     // Make the otherwise private and nested IBallSink interface
  79.     // implementation a friend to COM object instantiations of this
  80.     // COBallSink COM object class.
  81.     friend CImpIBallSink;
  82.     // Private data of COBallSink COM objects.
  83.     // Nested IBallSink implementation instantiation.  This IBallSink
  84.     // interface is instantiated inside this COBallSink object as a
  85.     // native interface.
  86.     CImpIBallSink    m_ImpIBallSink;
  87.     // Main Object reference count.
  88.     ULONG            m_cRefs;
  89.     // Outer unknown (aggregation delegation). Used when this COM object
  90.     // is being aggregated.
  91.     IUnknown*        m_pUnkOuter;
  92.     // Pointer to the main object that can service the Sink events.
  93.     CGuiBall*        m_pGuiBall;
  94. };
  95. typedef COBallSink* PCOBallSink;
  96. #endif // __cplusplus
  97. #endif // SINK_H