hxsite2.h
上传用户:zhongxx05
上传日期:2007-06-06
资源大小:33641k
文件大小:7k
源码类别:

Symbian

开发平台:

C/C++

  1. /* ***** BEGIN LICENSE BLOCK ***** 
  2.  * Version: RCSL 1.0/RPSL 1.0 
  3.  *  
  4.  * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved. 
  5.  *      
  6.  * The contents of this file, and the files included with this file, are 
  7.  * subject to the current version of the RealNetworks Public Source License 
  8.  * Version 1.0 (the "RPSL") available at 
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed 
  10.  * the file under the RealNetworks Community Source License Version 1.0 
  11.  * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl, 
  12.  * in which case the RCSL will apply. You may also obtain the license terms 
  13.  * directly from RealNetworks.  You may not use this file except in 
  14.  * compliance with the RPSL or, if you have a valid RCSL with RealNetworks 
  15.  * applicable to this file, the RCSL.  Please see the applicable RPSL or 
  16.  * RCSL for the rights, obligations and limitations governing use of the 
  17.  * contents of the file.  
  18.  *  
  19.  * This file is part of the Helix DNA Technology. RealNetworks is the 
  20.  * developer of the Original Code and owns the copyrights in the portions 
  21.  * it created. 
  22.  *  
  23.  * This file, and the files included with this file, is distributed and made 
  24.  * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
  25.  * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
  26.  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS 
  27.  * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
  28.  * 
  29.  * Technology Compatibility Kit Test Suite(s) Location: 
  30.  *    http://www.helixcommunity.org/content/tck 
  31.  * 
  32.  * Contributor(s): 
  33.  *  
  34.  * ***** END LICENSE BLOCK ***** */ 
  35. #ifndef _HXSITE2_H_
  36. #define _HXSITE2_H_
  37. /*
  38.  * Forward declarations of some interfaces defined or used here-in.
  39.  */
  40. typedef _INTERFACE  IHXSite2     IHXSite2;
  41. typedef _INTERFACE  IHXVideoSurface     IHXVideoSurface;
  42. typedef _INTERFACE  IHXPassiveSiteWatcher     IHXPassiveSiteWatcher;
  43. /****************************************************************************
  44.  * 
  45.  *  Interface:
  46.  *
  47.  * IHXSite2
  48.  *
  49.  *  Purpose:
  50.  *
  51.  * Interface for IHXSite2 objects.
  52.  *
  53.  *  IID_IHXSite:
  54.  *
  55.  * {0x00000D0A-0901-11d1-8B06-00A024406D59}
  56.  *
  57.  */
  58. DEFINE_GUID(IID_IHXSite2, 0x00000D0A, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  59. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  60. #undef  INTERFACE
  61. #define INTERFACE   IHXSite
  62. DECLARE_INTERFACE_(IHXSite2, IUnknown)
  63. {
  64.     /*
  65.      * IUnknown methods
  66.      */
  67.     STDMETHOD(QueryInterface) (THIS_
  68. REFIID riid,
  69. void** ppvObj) PURE;
  70.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  71.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  72.     /*
  73.      * IHXSite2 method usually called by the "context" 
  74.      * when window attributes (like the window handle) have changed.
  75.      */
  76.     STDMETHOD(UpdateSiteWindow) (THIS_
  77. HXxWindow* /*IN*/ pWindow) PURE;
  78.     /*
  79.      * IHXSite2 method usually called by the "context" to
  80.      * to hide/show a site.
  81.      */
  82.     STDMETHOD(ShowSite)         (THIS_
  83.                                  BOOL    bShow) PURE;
  84.                                  
  85.     STDMETHOD_(BOOL, IsSiteVisible)         (THIS) PURE;
  86.     /*
  87.      * IHXSite2 method usually called by the "context" to
  88.      * set the site's Z-order
  89.      */
  90.     STDMETHOD(SetZOrder) (THIS_
  91. INT32 lZOrder
  92. ) PURE;
  93.     /*
  94.      * IHXSite2 method called to get the site's Z-order
  95.      */
  96.     STDMETHOD(GetZOrder) (THIS_
  97. REF(INT32) lZOrder
  98. ) PURE;
  99.     /*
  100.      * IHXSite2 method called to set the site at the top
  101.      * of the Z-order
  102.      */
  103.     STDMETHOD(MoveSiteToTop) (THIS) PURE;
  104.     /*
  105.      * IHXSite2 method called to get the site's video surface
  106.      */
  107.     STDMETHOD(GetVideoSurface) (THIS_ 
  108. REF(IHXVideoSurface*) pSurface
  109. ) PURE;
  110.     /*
  111.      * IHXSite2 method called to get the number of child sites.
  112.      */
  113.     STDMETHOD_(UINT32,GetNumberOfChildSites) (THIS) PURE;
  114.     /*
  115.      * IHXSite2 method to add a watcher that does not affect the site
  116.      */
  117.     STDMETHOD(AddPassiveSiteWatcher) (THIS_
  118.      IHXPassiveSiteWatcher* pWatcher
  119. ) PURE;
  120.     /*
  121.      * IHXSite2 method to remove a watcher that does not affect the site
  122.      */
  123.     STDMETHOD(RemovePassiveSiteWatcher) (THIS_
  124.      IHXPassiveSiteWatcher* pWatcher
  125. ) PURE;
  126.     /*
  127.      * IHXSite2 method used to do cursor management
  128.      */
  129.     STDMETHOD(SetCursor)  (THIS_
  130.      HXxCursor ulCursor,
  131. REF(HXxCursor) ulOldCursor
  132. ) PURE;
  133. };
  134. /****************************************************************************
  135.  * 
  136.  *  Interface:
  137.  *
  138.  * IHXPassiveSiteWatcher
  139.  *
  140.  *  Purpose:
  141.  *
  142.  * Interface for IHXPassiveSiteWatcher objects.
  143.  *
  144.  *  IID_IHXPassiveSiteWatcher:
  145.  *
  146.  * {0x00000D0F-0901-11d1-8B06-00A024406D59}
  147.  *
  148.  */
  149. DEFINE_GUID(IID_IHXPassiveSiteWatcher, 0x00000D0F, 0x901, 0x11d1, 0x8b, 0x6, 
  150. 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  151. #undef  INTERFACE
  152. #define INTERFACE   IHXPassiveSiteWatcher
  153. DECLARE_INTERFACE_(IHXPassiveSiteWatcher, IUnknown)
  154. {
  155.     /*
  156.      * IUnknown methods
  157.      */
  158.     STDMETHOD(QueryInterface) (THIS_
  159. REFIID riid,
  160. void** ppvObj) PURE;
  161.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  162.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  163.     /*
  164.      * IHXPassiveSiteWatcher method used to notify
  165.      * about position updates
  166.      */
  167.     STDMETHOD(PositionChanged) (THIS_
  168. HXxPoint* /*IN*/ pPoint) PURE;
  169.     /*
  170.      * IHXPassiveSiteWatcher method used to notify
  171.      * about size updates
  172.      */
  173.     STDMETHOD(SizeChanged)  (THIS_
  174. HXxSize* /*IN*/ pSize) PURE;
  175. };
  176. /***********************************************************************/
  177. /********  PRIVATE INTERFACE UNTIL STABALIZED -- WILL CHANGE ***********/
  178. /***********************************************************************/
  179. /*
  180.  *
  181.  *  Interface:  IHXSiteControl
  182.  *
  183.  *  Purpose:
  184.  *           Helps manage multiple sites and their children
  185.  *
  186.  *  Interface for obtaining IHXSiteControl
  187.  *
  188.  *  {DD25CA2E-73A5-4811-996F-7E6726E7668F}
  189.  *
  190.  */
  191. DEFINE_GUID(IID_IHXSiteControl, 0xdd25ca2e, 0x73a5, 0x4811, 0x99,
  192.             0x6f, 0x7e, 0x67, 0x26, 0xe7, 0x66, 0x8f);
  193. #undef  INTERFACE
  194. #define INTERFACE   IHXSiteControl
  195. DECLARE_INTERFACE_(IHXSiteControl, IUnknown)
  196. {
  197.     /* redraws this site and all children */
  198.     STDMETHOD(ForceRedrawAll) (THIS_ ) PURE;
  199. };
  200. /***********************************************************************/
  201. /********  PRIVATE INTERFACE UNTIL STABALIZED -- WILL CHANGE ***********/
  202. /***********************************************************************/
  203. #endif //_HXSITE2_H_