开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 通讯/手机编程 > Symbian > 查看源码
hxwin.h
资源名称：142_61_thumb_advanced.rar　[点击查看]
上传用户：dangjiwu
上传日期：2013-07-19
资源大小：42019k
文件大小：46k
源码类别：

Symbian

开发平台：

Visual C++

hxwin.h：源码内容
  1. /* ***** BEGIN LICENSE BLOCK *****
  2.  * Source last modified: $Id: hxwin.h,v 1.1.1.1.50.3 2004/07/09 01:45:13 hubbe Exp $
  3.  * 
  4.  * Portions Copyright (c) 1995-2004 RealNetworks, Inc. All Rights Reserved.
  5.  * 
  6.  * The contents of this file, and the files included with this file,
  7.  * are subject to the current version of the RealNetworks Public
  8.  * Source License (the "RPSL") available at
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed
  10.  * the file under the current version of the RealNetworks Community
  11.  * Source License (the "RCSL") available at
  12.  * http://www.helixcommunity.org/content/rcsl, in which case the RCSL
  13.  * will apply. You may also obtain the license terms directly from
  14.  * RealNetworks.  You may not use this file except in compliance with
  15.  * the RPSL or, if you have a valid RCSL with RealNetworks applicable
  16.  * to this file, the RCSL.  Please see the applicable RPSL or RCSL for
  17.  * the rights, obligations and limitations governing use of the
  18.  * contents of the file.
  19.  * 
  20.  * Alternatively, the contents of this file may be used under the
  21.  * terms of the GNU General Public License Version 2 or later (the
  22.  * "GPL") in which case the provisions of the GPL are applicable
  23.  * instead of those above. If you wish to allow use of your version of
  24.  * this file only under the terms of the GPL, and not to allow others
  25.  * to use your version of this file under the terms of either the RPSL
  26.  * or RCSL, indicate your decision by deleting the provisions above
  27.  * and replace them with the notice and other provisions required by
  28.  * the GPL. If you do not delete the provisions above, a recipient may
  29.  * use your version of this file under the terms of any one of the
  30.  * RPSL, the RCSL or the GPL.
  31.  * 
  32.  * This file is part of the Helix DNA Technology. RealNetworks is the
  33.  * developer of the Original Code and owns the copyrights in the
  34.  * portions it created.
  35.  * 
  36.  * This file, and the files included with this file, is distributed
  37.  * and made available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY
  38.  * KIND, EITHER EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS
  39.  * ALL SUCH WARRANTIES, INCLUDING WITHOUT LIMITATION, ANY WARRANTIES
  40.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, QUIET
  41.  * ENJOYMENT OR NON-INFRINGEMENT.
  42.  * 
  43.  * Technology Compatibility Kit Test Suite(s) Location:
  44.  *    http://www.helixcommunity.org/content/tck
  45.  * 
  46.  * Contributor(s):
  47.  * 
  48.  * ***** END LICENSE BLOCK ***** */
  50. #ifndef _HXWIN_H_
  51. #define _HXWIN_H_
  53. /*
  54.  * Forward declarations of some interfaces defined or used here-in.
  55.  */
  56. typedef _INTERFACE IHXSite IHXSite;
  57. typedef _INTERFACE IHXSiteUser IHXSiteUser;
  58. typedef _INTERFACE IHXSiteWindowed IHXSiteWindowed;
  59. typedef _INTERFACE IHXSiteEventHandler            IHXSiteEventHandler;
  60. typedef _INTERFACE IHXSiteWindowless IHXSiteWindowless;
  61. typedef _INTERFACE IHXSiteWatcher IHXSiteWatcher;
  62. typedef _INTERFACE IHXValues IHXValues;
  63. typedef _INTERFACE IHXSiteFullScreen IHXSiteFullScreen;
  64. typedef _INTERFACE IHXLayoutSiteGroupManager IHXLayoutSiteGroupManager;
  65. typedef _INTERFACE IHXEventHook IHXEventHook;
  66. typedef _INTERFACE IHXColorConverter IHXColorConverter;
  67. typedef _INTERFACE IHXSubRectVideoSurface IHXSubRectVideoSurface;
  69. typedef struct _HXBitmapInfoHeader HXBitmapInfoHeader;
  70. typedef struct _HXxWindow   HXxWindow;
  71. typedef struct _HXxRegion  HXxBoxRegion;
  72. typedef struct _HXxSize     HXxSize;
  73. typedef struct _HXxPoint    HXxPoint;
  74. typedef struct _HXxRect     HXxRect;
  75. typedef void* HXxRegion;
  78. /*
  79.  * Styles for IHXDrawFocus
  80.  */
  81. #define HX_SOLID_LINE      1
  82. #define HX_DASHED_LINE     HX_SOLID_LINE<<1
  83. #define HX_DOTTED_LINE     HX_SOLID_LINE<<2
  84. #define HX_CUSTOM_LINE     HX_SOLID_LINE<<3
  86. /*
  87.  * Focus Navigation
  88.  */
  89. typedef enum _HXFocusContext
  90. {
  91.     HXFirstFocus,
  92.     HXUpFocus,
  93.     HXDownFocus,
  94.     HXLeftFocus,
  95.     HXRightFocus,
  96.     HXNextFocus,
  97.     HXPrevFocus,
  98.     HXLastFocus
  99. } HXFocusContext;
  101. typedef enum _HXFocusState
  102. {
  103.     HXNoFocus,
  104.     HXFocused
  105. } HXFocusState;
  107. /****************************************************************************
  108.  * 
  109.  *  Interface:
  110.  *
  111.  * IHXSiteWindowed
  112.  *
  113.  *  Purpose:
  114.  *
  115.  * Interface for IHXSite objects which are associated with platform
  116.  * specific window objects on Microsoft Windows and X-Windows.
  117.  *
  118.  *  IID_IHXSiteWindowed:
  119.  *
  120.  * {00000D01-0901-11d1-8B06-00A024406D59}
  121.  *
  122.  */
  123. DEFINE_GUID(IID_IHXSiteWindowed, 0x00000D01, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  124. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  126. #define CLSID_IHXSiteWindowed IID_IHXSiteWindowed
  128. // $Private:
  129. DEFINE_GUID(IID_IHXGetImplementation, 0x00000D11, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  130. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  131. // $EndPrivate.
  133. #undef  INTERFACE
  134. #define INTERFACE   IHXSiteWindowed
  136. DECLARE_INTERFACE_(IHXSiteWindowed, IUnknown)
  137. {
  138.     /*
  139.      * IUnknown methods
  140.      */
  141.     STDMETHOD(QueryInterface) (THIS_
  142. REFIID riid,
  143. void** ppvObj) PURE;
  145.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  147.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  149.     /*
  150.      * IHXSiteWindowed methods called by site suppliers 
  151.      * when they want the site associated with a
  152.      * previously created (and externally managed) window.
  153.      * This method will "sub-class" that window (Win32).
  154.      * On Unix, the site supplier must pass events from 
  155.      * the externally managed window to the core via
  156.      * IHXClientEngine::EventOccurred(). Please note that
  157.      * The HXxWindow ptr must remain in scope for the life
  158.      * of Site.
  159.      * 
  160.      */
  161.     STDMETHOD(AttachWindow) (THIS_
  162. HXxWindow* /*IN*/ pWindow) PURE;
  164.     STDMETHOD(DetachWindow) (THIS) PURE;
  166.     /*
  167.      * IHXSiteWindowed methods called by Owners of the site
  168.      * in the event that want a default top level window created
  169.      * for the site.
  170.      */
  171.     STDMETHOD(Create) (THIS_
  172. void* ParentWindow, 
  173. UINT32 style) PURE;
  175.     STDMETHOD(Destroy) (THIS) PURE;
  177.     /*
  178.      * IHXSiteWindowed method. Returns actual window of the site.
  179.      */
  180.     STDMETHOD_(HXxWindow*,GetWindow)(THIS) PURE;
  181. };
  183. // $Private:
  184. /****************************************************************************
  185.  * 
  186.  *  Interface:
  187.  *
  188.  * IHXSiteEventHandler
  189.  *
  190.  *  Purpose:
  191.  *
  192.  * Interface for allowing client core engine to pass events to a site imeplementor
  193.  *      which it implemented as a factory plugin. 
  194.  *
  195.  *  IID_IHXSiteEventHandler                      
  196.  *
  197.  * {00000D12-0901-11d1-8B-6-00A024406D59}
  198.  *
  199.  */
  201. DEFINE_GUID(IID_IHXSiteEventHandler, 0x00000D12, 0x901, 0x11d1, 0x8b, 0x6, 
  202.                 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  204. #define CLSID_IHXSiteEventHandler IID_IHXSiteEventHandler
  206. #undef  INTERFACE
  207. #define INTERFACE   IHXSiteEventHandler
  209. DECLARE_INTERFACE_(IHXSiteEventHandler, IUnknown)
  210. {
  211.     /*
  212.      * IUnknown methods
  213.      */
  214.     STDMETHOD(QueryInterface) (THIS_
  215. REFIID riid,
  216. void** ppvObj) PURE;
  218.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  220.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  222.     /*
  223.      * This method is called from Site Manager EventOccured().
  224.      * The imeplementation of this interface must pass the events 
  225.      * on to the individual CHXSiteWindowed sites.
  226.      */
  227.     STDMETHOD(EventOccurred) (THIS_ HXxEvent* pEvent) PURE;
  228. };
  229. // $EndPrivate.
  232. /****************************************************************************
  233.  * 
  234.  *  Interface:
  235.  *
  236.  * IHXSiteWindowless
  237.  *
  238.  *  Purpose:
  239.  *
  240.  * Interface for IHXSite objects which are "windowless" or not 
  241.  * associated with platform specific window objects.
  242.  *
  243.  *  IID_IHXSiteWindowless:
  244.  *
  245.  * {00000D02-0901-11d1-8B06-00A024406D59}
  246.  *
  247.  */
  248. DEFINE_GUID(IID_IHXSiteWindowless, 0x00000D02, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  249. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  251. #undef  INTERFACE
  252. #define INTERFACE   IHXSiteWindowless
  254. #define CLSID_IHXSiteWindowless IID_IHXSiteWindowless
  256. DECLARE_INTERFACE_(IHXSiteWindowless, IUnknown)
  257. {
  258.     /*
  259.      * IUnknown methods
  260.      */
  261.     STDMETHOD(QueryInterface) (THIS_
  262. REFIID riid,
  263. void** ppvObj) PURE;
  265.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  267.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  269.     /*
  270.      * IHXSiteWindowless methods called by owners of the site.
  271.      */
  272.     STDMETHOD(EventOccurred) (THIS_
  273. HXxEvent* /*IN*/ pEvent) PURE;
  275.     /*
  276.      * IHXSiteWindowless method. Returns some parent window that
  277.      * owns the windowless site. Useful for right-click menus and
  278.      * dialog box calls.
  279.      */
  280.     STDMETHOD_(HXxWindow*,GetParentWindow)(THIS) PURE;
  281. };
  284. /****************************************************************************
  285.  * 
  286.  *  Interface:
  287.  *
  288.  * IHXSite
  289.  *
  290.  *  Purpose:
  291.  *
  292.  * Interface for IHXSite objects.
  293.  *
  294.  *  IID_IHXSite:
  295.  *
  296.  * {00000D03-0901-11d1-8B06-00A024406D59}
  297.  *
  298.  */
  299. DEFINE_GUID(IID_IHXSite, 0x00000D03, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  300. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  302. #undef  INTERFACE
  303. #define INTERFACE   IHXSite
  305. DECLARE_INTERFACE_(IHXSite, IUnknown)
  306. {
  307.     /*
  308.      * IUnknown methods
  309.      */
  310.     STDMETHOD(QueryInterface) (THIS_
  311. REFIID riid,
  312. void** ppvObj) PURE;
  314.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  316.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  318.     /*
  319.      * IHXSite methods usually called by the "context" to 
  320.      * associate users with the site, and to create child sites
  321.      * as appropriate.
  322.      */
  323.     STDMETHOD(AttachUser) (THIS_
  324. IHXSiteUser* /*IN*/ pUser) PURE;
  326.     STDMETHOD(DetachUser) (THIS) PURE;
  329.     STDMETHOD(GetUser) (THIS_
  330. REF(IHXSiteUser*) /*OUT*/ pUser) PURE;
  332.     STDMETHOD(CreateChild) (THIS_
  333. REF(IHXSite*) /*OUT*/ pChildSite) PURE;
  335.     STDMETHOD(DestroyChild) (THIS_
  336. IHXSite* /*IN*/ pChildSite) PURE;
  338.     /*
  339.      * IHXSite methods called by the the "context" in which the site
  340.      * is displayed in order to manage its position. Site users should
  341.      * not generally call these methods.
  342.      */
  343.     STDMETHOD(AttachWatcher) (THIS_
  344. IHXSiteWatcher* /*IN*/ pWatcher) PURE;
  346.     STDMETHOD(DetachWatcher) (THIS) PURE;
  348.     STDMETHOD(SetPosition) (THIS_
  349. HXxPoint position) PURE;
  351.     STDMETHOD(GetPosition) (THIS_
  352. REF(HXxPoint) position) PURE;
  354.     /*
  355.      * IHXSite methods called by the user of the site to get
  356.      * information about the site, and to manipulate the site.
  357.      */
  358.     STDMETHOD(SetSize) (THIS_
  359. HXxSize size) PURE;
  361.     STDMETHOD(GetSize) (THIS_
  362. REF(HXxSize) size) PURE;
  364.     STDMETHOD(DamageRect) (THIS_
  365. HXxRect rect) PURE;
  367.     STDMETHOD(DamageRegion) (THIS_
  368. HXxRegion region) PURE;
  370.     STDMETHOD(ForceRedraw) (THIS) PURE;
  371. };
  374. // $Private
  375. /****************************************************************************
  376.  * 
  377.  *  Interface:
  378.  *
  379.  * IHXSiteComposition
  380.  *
  381.  *  Purpose:
  382.  *
  383.  * Interface for IHXSite objects to let them compose composition
  384.  *      frames and display them on a regular basis rather than many
  385.  *      discrete blts.
  386.  *
  387.  *  IID_IHXSiteComposition:
  388.  *
  389.  * {00000D03-0901-11d1-8B06-00A024406D59}
  390.  *
  391.  */
  392. DEFINE_GUID(IID_IHXSiteComposition, 0x00000D19, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  393. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  395. #undef  INTERFACE
  396. #define INTERFACE   IHXSiteComposition
  398. DECLARE_INTERFACE_(IHXSiteComposition, IUnknown)
  399. {
  400.     /* IUnknown methods */
  401.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void** ppvObj) PURE;
  402.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  403.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  405.     /* IHXSiteComposition methods. */
  406.     STDMETHOD(LockComposition)            (THIS) PURE;
  407.     STDMETHOD(UnlockComposition)          (THIS) PURE;
  408.     STDMETHOD(BltComposition)             (THIS) PURE;
  409.     STDMETHOD(SetCompositionMode)         (THIS_ BOOL OnOrOff) PURE;
  410.     STDMETHOD_(BOOL, IsCompositionLocked) (THIS) PURE;
  411.     STDMETHOD_(BOOL, IsCompositionMode)   (THIS) PURE;
  412. };
  413. // $EndPrivate.
  416. /****************************************************************************
  417.  * 
  418.  *  Interface:
  419.  *
  420.  * IHXSiteUser
  421.  *
  422.  *  Purpose:
  423.  *
  424.  * Interface for the user of the IHXSite objects.
  425.  *
  426.  *  IID_IHXSiteUser:
  427.  *
  428.  * {00000D04-0901-11d1-8B06-00A024406D59}
  429.  *
  430.  */
  431. DEFINE_GUID(IID_IHXSiteUser, 0x00000D04, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  432. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  434. #undef  INTERFACE
  435. #define INTERFACE   IHXSiteUser
  437. DECLARE_INTERFACE_(IHXSiteUser, IUnknown)
  438. {
  439.     /*
  440.      * IUnknown methods
  441.      */
  442.     STDMETHOD(QueryInterface) (THIS_
  443. REFIID riid,
  444. void** ppvObj) PURE;
  446.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  448.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  450.     /*
  451.      * IHXSiteUser methods usually called by the "context" to 
  452.      * associate users with the site.
  453.      */
  454.     STDMETHOD(AttachSite) (THIS_
  455. IHXSite* /*IN*/ pSite) PURE;
  457.     STDMETHOD(DetachSite) (THIS) PURE;
  459.     /*
  460.      * IHXSiteUser methods called to inform user of an event.
  461.      */
  462.     STDMETHOD(HandleEvent) (THIS_
  463. HXxEvent* /*IN*/ pEvent) PURE;
  465.     STDMETHOD_(BOOL,NeedsWindowedSites) (THIS) PURE;
  466. };
  468. /****************************************************************************
  469.  * 
  470.  *  Interface:
  471.  *
  472.  * IHXSiteWatcher
  473.  *
  474.  *  Purpose:
  475.  *
  476.  * Interface for IHXSiteWatcher objects.
  477.  *
  478.  *  IID_IHXSite:
  479.  *
  480.  * {00000D05-0901-11d1-8B06-00A024406D59}
  481.  *
  482.  */
  483. DEFINE_GUID(IID_IHXSiteWatcher, 0x00000D05, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  484. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  486. #undef  INTERFACE
  487. #define INTERFACE   IHXSiteWatcher
  489. DECLARE_INTERFACE_(IHXSiteWatcher, IUnknown)
  490. {
  491.     /*
  492.      * IUnknown methods
  493.      */
  494.     STDMETHOD(QueryInterface) (THIS_
  495. REFIID riid,
  496. void** ppvObj) PURE;
  498.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  500.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  502.     /*
  503.      * IHXSiteWatcher methods called by the site when a watcher 
  504.      * is attached to or detached from it.
  505.      */
  506.     STDMETHOD(AttachSite) (THIS_
  507. IHXSite* /*IN*/ pSite) PURE;
  509.     STDMETHOD(DetachSite) (THIS) PURE;
  511.     /*
  512.      * IHXSiteWatcher methods called by the site an attempt is
  513.      * made to change it's position or size. The site watcher must
  514.      * return HXR_OK for the change to occur. If the site watcher
  515.      * returns any value other than HXR_OK then the size or position
  516.      * will not change. The site watcher can also modify the new
  517.      * size of position.
  518.      */
  519.     STDMETHOD(ChangingPosition) (THIS_
  520. HXxPoint posOld,
  521. REF(HXxPoint)/*IN-OUT*/ posNew) PURE;
  523.     STDMETHOD(ChangingSize) (THIS_
  524. HXxSize sizeOld,
  525. REF(HXxSize) /*IN-OUT*/ sizeNew) PURE;
  526. };
  528. /****************************************************************************
  529.  * 
  530.  *  Interface:
  531.  *
  532.  * IHXSiteUserSupplier
  533.  *
  534.  *  Purpose:
  535.  *
  536.  * Interface implemented by renderers and objects with provide layouts to
  537.  * the client core. This interface is called by the core when it needs a 
  538.  * new IHXSiteUser, or when it is done using an IHXSiteUser.
  539.  *
  540.  *  IID_IHXSiteUserSupplier:
  541.  *
  542.  * {00000D06-0901-11d1-8B06-00A024406D59}
  543.  *
  544.  */
  545. DEFINE_GUID(IID_IHXSiteUserSupplier, 0x00000D06, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  546. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  548. #undef  INTERFACE
  549. #define INTERFACE   IHXSiteUserSupplier
  551. DECLARE_INTERFACE_(IHXSiteUserSupplier, IUnknown)
  552. {
  553.     /*
  554.      * IUnknown methods
  555.      */
  556.     STDMETHOD(QueryInterface) (THIS_
  557. REFIID riid,
  558. void** ppvObj) PURE;
  560.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  562.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  564.     /*
  565.      * IHXSiteUserSupplier methods usually called by the 
  566.      * "context" to ask for additional or to release previously
  567.      * created site users.
  568.      */
  569.     STDMETHOD(CreateSiteUser) (THIS_
  570. REF(IHXSiteUser*)/*OUT*/ pSiteUser) PURE;
  572.     STDMETHOD(DestroySiteUser) (THIS_
  573. IHXSiteUser*   /*IN*/ pSiteUser) PURE;
  575.     STDMETHOD_(BOOL,NeedsWindowedSites) (THIS) PURE;
  576. };
  579. /****************************************************************************
  580.  * 
  581.  *  Interface:
  582.  *
  583.  * IHXSiteSupplier
  584.  *
  585.  *  Purpose:
  586.  *
  587.  * Interface implemented by users of the client core. This interface is
  588.  * called by the core when it needs a new IHXSite, or when it is done
  589.  * using an IHXSite.
  590.  *
  591.  *  IID_IHXSiteSupplier:
  592.  *
  593.  * {00000D07-0901-11d1-8B06-00A024406D59}
  594.  *
  595.  */
  596. DEFINE_GUID(IID_IHXSiteSupplier, 0x00000D07, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  597. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  599. #undef  INTERFACE
  600. #define INTERFACE   IHXSiteSupplier
  602. DECLARE_INTERFACE_(IHXSiteSupplier, IUnknown)
  603. {
  604.     /*
  605.      * IUnknown methods
  606.      */
  607.     STDMETHOD(QueryInterface) (THIS_
  608. REFIID riid,
  609. void** ppvObj) PURE;
  611.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  613.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  615.     /*
  616.      * IHXSiteSupplier methods
  617.      */
  619.     /************************************************************************
  620.      * Method:
  621.      *     IHXSiteSupplier::SitesNeeded
  622.      * Purpose:
  623.      *   Called to inform the site supplier that a site with a particular
  624.      *   set of characteristics is needed. If the site supplier can 
  625.      *   fulfill the request it should call the site manager and add one
  626.      *   or more new sites.
  627.      *    Note that the request for sites is associated with a Request ID
  628.      *    the client core will inform the site supplier when this requested
  629.      *    site is no longer needed.
  630.      */
  631.     STDMETHOD(SitesNeeded) (THIS_
  632. UINT32 uReqestID,
  633. IHXValues* pSiteProps) PURE;
  635.     /************************************************************************
  636.      *  Method:
  637.      *    IHXSiteSupplier::SitesNotNeeded
  638.      *  Purpose:
  639.      *    Called to inform the site supplier that all sites from a previos
  640.      *   site request are no longer needed. If the site supplier had 
  641.      *   previously created non-persistant sites (like popup windows)
  642.      *    to fulfill a request for sites it should call the site manager 
  643.      *    and remove those sites.
  644.      */
  645.     STDMETHOD(SitesNotNeeded) (THIS_
  646. UINT32 uReqestID) PURE;
  649.     /************************************************************************
  650.      *  Method:
  651.      *    IHXSiteSupplier::BeginChangeLayout
  652.      *  Purpose:
  653.      *    Called to inform the site supplier a layout change has beginning
  654.      *   it can expect to recieve SitesNeeded() and SitesNotNeeded() calls
  655.      *   while a layout change is in progress,
  656.      */
  657.     STDMETHOD(BeginChangeLayout) (THIS) PURE;
  659.     /************************************************************************
  660.      *  Method:
  661.      *    IHXSiteSupplier::DoneChangeLayout
  662.      *  Purpose:
  663.      *    Called to inform the site supplier the layout change has been
  664.      *   completed.
  665.      */
  666.     STDMETHOD(DoneChangeLayout) (THIS) PURE;
  668. };
  671. /****************************************************************************
  672.  * 
  673.  *  Interface:
  674.  *
  675.  * IHXSiteManager
  676.  *
  677.  *  Purpose:
  678.  *
  679.  * Interface implemented by the client core. This interface is called
  680.  * by users of the client core to inform it of IHXSite's which are
  681.  * available for layout of renderers
  682.  *
  683.  *  IID_IHXSiteManager:
  684.  *
  685.  * {00000D08-0901-11d1-8B06-00A024406D59}
  686.  *
  687.  */
  688. DEFINE_GUID(IID_IHXSiteManager, 0x00000D08, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  689. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  691. #undef  INTERFACE
  692. #define INTERFACE   IHXSiteManager
  694. DECLARE_INTERFACE_(IHXSiteManager, IUnknown)
  695. {
  696.     /*
  697.      * IUnknown methods
  698.      */
  699.     STDMETHOD(QueryInterface) (THIS_
  700. REFIID riid,
  701. void** ppvObj) PURE;
  703.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  705.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  707.     /*
  708.      * IHXSiteManager methods
  709.      */
  711.     /************************************************************************
  712.      * Method:
  713.      *     IHXSiteManager::AddSite
  714.      * Purpose:
  715.      *   Called to inform the site manager of the existance of a site.
  716.      */
  717.     STDMETHOD(AddSite) (THIS_
  718. IHXSite* pSite) PURE;
  720.     /************************************************************************
  721.      * Method:
  722.      *     IHXSiteManager::RemoveSite
  723.      * Purpose:
  724.      *   Called to inform the site manager that a site is no longer 
  725.      *   available.
  726.      */
  727.     STDMETHOD(RemoveSite) (THIS_
  728. IHXSite* pSite) PURE;
  729. };
  732. // $Private:
  733. /****************************************************************************
  734.  * 
  735.  *  Interface:
  736.  *
  737.  * IHXSiteManager2
  738.  *
  739.  *  Purpose:
  740.  *
  741.  * Interface implemented by the client core. This interface is called
  742.  * by users of the client core to iterate over the sites known by this
  743.  * site manager.
  744.  *
  745.  *  IID_IHXSiteManager:
  746.  *
  747.  * {00000D20-0901-11d1-8B06-00A024406D59}
  748.  *
  749.  */
  750. DEFINE_GUID(IID_IHXSiteManager2, 0x00000D20, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  751. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  753. #undef  INTERFACE
  754. #define INTERFACE   IHXSiteManager2
  756. DECLARE_INTERFACE_(IHXSiteManager2, IUnknown)
  757. {
  758.     /*
  759.      * IHXSiteManager2 methods
  760.      */
  762.     /************************************************************************
  763.      * Method:
  764.      *     IHXSiteManager2::GetNumberOfSites
  765.      * Purpose:
  766.      *   Called to get the number of sites that the site mananger currently 
  767.      *    knows about.
  768.      */
  769.     STDMETHOD(GetNumberOfSites) (THIS_  REF(UINT32) nNumSites ) PURE;
  771.     /************************************************************************
  772.      * Method:
  773.      *     IHXSiteManager2::GetSiteAt
  774.      * Purpose:
  775.      *   Used to iterate over the sites.
  776.      *   
  777.      */
  778.     STDMETHOD(GetSiteAt) (THIS_ UINT32 nIndex, REF(IHXSite*) pSite) PURE;
  779. };
  780. // $EndPrivate.
  783. /****************************************************************************
  784.  * 
  785.  *  Interface:
  786.  *
  787.  * IHXMultiInstanceSiteUserSupplier
  788.  *
  789.  *  Purpose:
  790.  *
  791.  * This is the interface for a special default object which is available
  792.  * from the common class factory. This object will act as a site user 
  793.  * supplier for any renderer (or other site user object) that wants
  794.  * default support for multiple instances. The site user must work as
  795.  * a windowless site for this default implementation to work. The 
  796.  * default object also implements the IHXSite interfave to allow
  797.  * the site user object to control all the sites through a single 
  798.  * interface instance.
  799.  *
  800.  *  IID_IHXMultiInstanceSiteUserSupplier:
  801.  *
  802.  * {00000D09-0901-11d1-8B06-00A024406D59}
  803.  *
  804.  */
  805. DEFINE_GUID(IID_IHXMultiInstanceSiteUserSupplier, 0x00000D09, 0x901, 
  806.             0x11d1, 0x8b, 0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  808. #define CLSID_IHXMultiInstanceSiteUserSupplier
  809. IID_IHXMultiInstanceSiteUserSupplier
  811. #undef  INTERFACE
  812. #define INTERFACE   IHXMultiInstanceSiteUserSupplier
  814. DECLARE_INTERFACE_(IHXMultiInstanceSiteUserSupplier, IUnknown)
  815. {
  816.     /*
  817.      * IUnknown methods
  818.      */
  819.     STDMETHOD(QueryInterface) (THIS_
  820. REFIID riid,
  821. void** ppvObj) PURE;
  823.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  825.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  827.     /*
  828.      * IHXMultiInstanceSiteUserSupplier methods called by site users.
  829.      */
  830.     STDMETHOD(SetSingleSiteUser) (THIS_ 
  831. IUnknown* pUnknown) PURE;
  833.     STDMETHOD(ReleaseSingleSiteUser) (THIS) PURE;
  835. };
  838. /****************************************************************************
  839.  * 
  840.  *  Interface:
  841.  *
  842.  * IHXSiteEnumerator
  843.  *
  844.  *  Purpose:
  845.  *
  846.  *      Provides an interface to enumerate sites.  Currently implemented 
  847.  *      in the IHXMultiInstanceSiteUserSupplier supplied by the core player,
  848.  *      it can be used to render to MISUS sites outside of an HX_SURFACE_UPDATE;
  849.  *      this is especially useful when using IHXVideoSurface2.
  850.  *
  851.  *  IID_IHXSiteEnumerator:
  852.  *
  853.  * {67f8c5bd-4b1d-4c09-8fb7-8ac7c20d29c7}
  854.  *
  855.  */
  856. DEFINE_GUID(IID_IHXSiteEnumerator, 0x67f8c5bd, 0x4b1d,  
  857.             0x4c09, 0x8f, 0xb7, 0x8a, 0xc7, 0xc2, 0x0d, 0x29, 0xc7);
  859. #undef  INTERFACE
  860. #define INTERFACE   IHXSiteEnumerator
  862. DECLARE_INTERFACE_(IHXSiteEnumerator, IUnknown)
  863. {
  864.     /*
  865.      * IUnknown methods
  866.      */
  867.     STDMETHOD(QueryInterface) (THIS_
  868. REFIID riid,
  869. void** ppvObj) PURE;
  871.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  873.     typedef void* SitePosition;
  875.     /*
  876.      * HXSiteEnumerator methods
  877.      */
  880.     /************************************************************************
  881.      * Method:
  882.      *     HXSiteEnumerator::GetFirstSite
  883.      * Purpose:
  884.      *     Retrieves both the first site in the enumeration and initializes 
  885.      *      sitePosition with the position of the next site (if any).  
  886.      *      Returns HXR_OK if the first site is available, HXR_FAIL if not.
  887.      */
  888.     STDMETHOD(GetFirstSite) (THIS_
  889.                              REF(IHXSite*) /* OUT */ pFirstSite,
  890.                              REF(SitePosition) /* OUT */ nextPosition) PURE;
  892.     /************************************************************************
  893.      * Method:
  894.      *     HXSiteEnumerator::GetNextSite
  895.      * Purpose:
  896.      *     Retrieves both the next site in the enumeration (as specified by
  897.      *      nextSite) and initializes sitePosition with the position of the 
  898.      *      following site (if any).  
  899.      *      Returns HXR_OK if the first site is available, HXR_FAIL if not.
  900.      */
  901.     STDMETHOD(GetNextSite)  (THIS_
  902.                              REF(IHXSite*) pNextSite,
  903.                              REF(SitePosition) /* IN/OUT */ nextPosition) PURE;
  904. };
  907. /****************************************************************************
  908.  * 
  909.  *  Interface:
  910.  * IHXSiteFullScreen
  911.  *
  912.  *  Purpose:
  913.  *
  914.  * This is the interface for turning on/off the full screen mode
  915.  *
  916.  *  IID_IHXSiteFullScreen:
  917.  *
  918.  * {00000D0B-0901-11d1-8B06-00A024406D59}
  919.  *
  920.  */
  921. DEFINE_GUID(IID_IHXSiteFullScreen, 0x00000D0B, 0x901, 
  922.             0x11d1, 0x8b, 0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  924. #undef  INTERFACE
  925. #define INTERFACE   IHXSiteFullScreen
  927. DECLARE_INTERFACE_(IHXSiteFullScreen, IUnknown)
  928. {
  929.     /*
  930.      * IUnknown methods
  931.      */
  932.     STDMETHOD(QueryInterface) (THIS_
  933. REFIID riid,
  934. void** ppvObj) PURE;
  936.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  938.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  940.     /*
  941.      * IHXSiteFullScreen methods
  942.      */
  943.     STDMETHOD(EnterFullScreen) (THIS) PURE;
  945.     STDMETHOD(ExitFullScreen) (THIS) PURE;
  947.     STDMETHOD(TestFullScreen) (THIS_
  948. void* hTestBitmap,const char* pszStatusText) PURE;
  950.     STDMETHOD_(BOOL, IsFullScreen) (THIS) PURE;
  951. };
  954. // $Private:
  955. /****************************************************************************
  956.  * 
  957.  *  Interface:
  958.  * IHXLayoutSiteGroupManager
  959.  *
  960.  *  Purpose:
  961.  *
  962.  * Allow layout site groups to be added and removed
  963.  *
  964.  *  IID_IHXLayoutSiteGroupManager:
  965.  *
  966.  * {00000D0C-0901-11d1-8B06-00A024406D59}
  967.  *
  968.  */
  969. DEFINE_GUID(IID_IHXLayoutSiteGroupManager, 0x00000D0C, 0x901, 
  970.             0x11d1, 0x8b, 0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  972. #undef  INTERFACE
  973. #define INTERFACE   IHXLayoutSiteGroupManager
  975. DECLARE_INTERFACE_(IHXLayoutSiteGroupManager, IUnknown)
  976. {
  977.     /*
  978.      * IUnknown methods
  979.      */
  980.     STDMETHOD(QueryInterface) (THIS_
  981. REFIID riid,
  982. void** ppvObj) PURE;
  984.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  986.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  988.     /*
  989.      * IHXLayoutSiteGroupManager methods
  990.      */
  991.     STDMETHOD(AddLayoutSiteGroup) (THIS_
  992. IUnknown* pLSG) PURE;
  994.     STDMETHOD(RemoveLayoutSiteGroup) (THIS_
  995. IUnknown* pLSG) PURE;
  996. };
  997. // $EndPrivate.
  1000. /****************************************************************************
  1001.  * 
  1002.  *  Interface:
  1003.  * IHXEventHookMgr
  1004.  *
  1005.  *  Purpose:
  1006.  *
  1007.  * Add ability to hook events from a named region
  1008.  *
  1009.  *  IID_IHXEventHookMgr:
  1010.  *
  1011.  * {00000D0D-0901-11d1-8B06-00A024406D59}
  1012.  *
  1013.  */
  1014. DEFINE_GUID(IID_IHXEventHookMgr, 0x00000D0D, 0x901, 
  1015.             0x11d1, 0x8b, 0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1017. #undef  INTERFACE
  1018. #define INTERFACE   IHXEventHookMgr
  1020. DECLARE_INTERFACE_(IHXEventHookMgr, IUnknown)
  1021. {
  1022.     /*
  1023.      * IUnknown methods
  1024.      */
  1025.     STDMETHOD(QueryInterface) (THIS_
  1026. REFIID riid,
  1027. void** ppvObj) PURE;
  1029.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1031.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1033.     /*
  1034.      * IHXEventHookMgr methods
  1035.      */
  1036.     STDMETHOD(AddHook) (THIS_
  1037. IHXEventHook* pHook,
  1038. const char* pRegionName,
  1039. UINT16 uLayer) PURE;
  1041.     STDMETHOD(RemoveHook) (THIS_
  1042.      IHXEventHook* pHook,
  1043. const char* pRegionName,
  1044. UINT16 uLayer) PURE;
  1045. };
  1047. /****************************************************************************
  1048.  * 
  1049.  *  Interface:
  1050.  * IHXEventHook
  1051.  *
  1052.  *  Purpose:
  1053.  *
  1054.  * Object that gets hooked events sent by IHXEventHookMgr
  1055.  *
  1056.  *  IID_IHXEventHookMgr:
  1057.  *
  1058.  * {00000D0E-0901-11d1-8B06-00A024406D59}
  1059.  *
  1060.  */
  1061. DEFINE_GUID(IID_IHXEventHook, 0x00000D0E, 0x901, 
  1062.             0x11d1, 0x8b, 0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1064. #undef  INTERFACE
  1065. #define INTERFACE   IHXEventHook
  1067. DECLARE_INTERFACE_(IHXEventHook, IUnknown)
  1068. {
  1069.     /*
  1070.      * IUnknown methods
  1071.      */
  1072.     STDMETHOD(QueryInterface) (THIS_
  1073. REFIID riid,
  1074. void** ppvObj) PURE;
  1076.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1078.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1080.     /*
  1081.      * IHXEventHook methods
  1082.      */
  1083.     STDMETHOD(SiteAdded) (THIS_
  1084. IHXSite* pSite) PURE;
  1085.     STDMETHOD(HandleEvent) (THIS_
  1086.      IHXSite* pSite,
  1087. HXxEvent* pEvent) PURE;
  1088.     STDMETHOD(SiteRemoved) (THIS_
  1089.      IHXSite* pSite) PURE;
  1090. };
  1093. /****************************************************************************
  1094.  * 
  1095.  *  Interface:
  1096.  * IHXStatusMessage
  1097.  *
  1098.  *  Purpose:
  1099.  *
  1100.  * This is the interface for setting the status text. 
  1101.  *
  1102.  *  IID_IHXStatusMessage:
  1103.  *
  1104.  * {00000D10-0901-11d1-8B06-00A024406D59}
  1105.  *
  1106.  */
  1107. DEFINE_GUID(IID_IHXStatusMessage, 0x00000D10, 0x901, 
  1108.             0x11d1, 0x8b, 0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1110. #undef  INTERFACE
  1111. #define INTERFACE   IHXStatusMessage
  1113. DECLARE_INTERFACE_(IHXStatusMessage, IUnknown)
  1114. {
  1115.     /*
  1116.      * IUnknown methods
  1117.      */
  1118.     STDMETHOD(QueryInterface) (THIS_
  1119. REFIID riid,
  1120. void** ppvObj) PURE;
  1122.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1124.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1126.     /*
  1127.      * IHXStatusMessage methods
  1128.      */
  1130.     STDMETHOD(SetStatus) (THIS_ const char* pText) PURE;
  1131. };
  1133. // $Private:
  1134. /****************************************************************************
  1135.  * 
  1136.  *  Interface:
  1137.  *
  1138.  * IHXSiteTransition
  1139.  *
  1140.  *  Purpose:
  1141.  *
  1142.  * Interface for transitioning between IHXSites.
  1143.  *
  1144.  *  IID_IHXSiteTransition:
  1145.  *
  1146.  * {00000D01-0901-11d1-8B06-00A024406D59}
  1147.  *
  1148.  */
  1149. DEFINE_GUID(IID_IHXSiteTransition, 0x00000D13, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1150. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1152. #define CLSID_IHXSiteTransition IID_IHXSiteTransition
  1154. #undef  INTERFACE
  1155. #define INTERFACE   IHXSiteTransition
  1157. DECLARE_INTERFACE_(IHXSiteTransition, IUnknown)
  1158. {
  1159.     /*
  1160.      * IUnknown methods
  1161.      */
  1162.     STDMETHOD(QueryInterface) (THIS_
  1163. REFIID riid,
  1164. void** ppvObj) PURE;
  1166.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1168.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1170.     STDMETHOD(Initialize) (THIS_
  1171. IHXValues* pParams) PURE;
  1173.     STDMETHOD(SetPercentage) (THIS_
  1174. UINT32 nThousandnthsComplete) PURE;
  1176. };
  1179. /****************************************************************************
  1180.  *
  1181.  *  Interface:
  1182.  *
  1183.  *  IHXRegion
  1184.  *
  1185.  *  Purpose:
  1186.  *
  1187.  *  Iterface for managing HXRegions.
  1188.  *
  1189.  *  IHXRegion:
  1190.  *
  1191.  *  {00002200-0903-11d1-8B06-00A024406D59}
  1192.  *
  1193.  */
  1196. DEFINE_GUID(IID_IHXRegion, 0x00000D14, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1197. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1199. #define CLSID_IHXRegion IID_IHXRegion
  1201. #undef  INTERFACE
  1202. #define INTERFACE   IHXRegion
  1204. DECLARE_INTERFACE_(IHXRegion, IUnknown)
  1205. {
  1206.     /************************************************************************
  1207.      * Method:
  1208.      *     IHXRegion::SetRect
  1209.      * Purpose:
  1210.      *     This function creates a rectangular region.
  1211.      *
  1212.      */
  1213.     STDMETHOD(SetRect)      (THIS_ HXxRect*    pRect) PURE;
  1215.     /************************************************************************
  1216.      * Method:
  1217.      *     IHXRegion::SetRect
  1218.      * Purpose:
  1219.      *     This function creates a rectangular region.
  1220.      *
  1221.      */
  1222.     STDMETHOD(SetRect)      (THIS_ int x, int y, int x1, int y1) PURE;
  1224.     /************************************************************************
  1225.      * Method:
  1226.      *     IHXRegion::SetPoly
  1227.      * Purpose:
  1228.      *     This function creates a region defined by an arbitary polygon.
  1229.      *
  1230.      */
  1232.     STDMETHOD(SetPoly)      (THIS_ HXxPoint**  pRect, BOOL bUseWinding) PURE;
  1234.     /************************************************************************
  1235.      * Method:
  1236.      *     IHXRegion::IsEqual
  1237.      * Purpose:
  1238.      *     This function determines if two regions are equal.
  1239.      *
  1240.      */
  1242.     STDMETHOD_(BOOL,IsEqual)      (THIS_ IHXRegion* pRegion) PURE;
  1244.     /************************************************************************
  1245.      * Method:
  1246.      *     IHXRegion::GetExtents
  1247.      * Purpose:
  1248.      *     This function allows the user to determine the extents of the region
  1249.      *
  1250.      */
  1252.     STDMETHOD(GetExtents)      (THIS_ REF(HXxRect) rExtents) PURE;
  1254.     /************************************************************************
  1255.      * Method:
  1256.      *     IHXRegion::Offset
  1257.      * Purpose:
  1258.      *     This function offsets the region by the spectified origin
  1259.      *
  1260.      */
  1262.     STDMETHOD(Offset)      (THIS_ HXxPoint* pOrigin) PURE;
  1264.     /************************************************************************
  1265.      * Method:
  1266.      *     IHXRegion::PointHitTest
  1267.      * Purpose:
  1268.      *     This function returns if TRUE if the specified point is in the region
  1269.      *
  1270.      */
  1272.     STDMETHOD_(BOOL,PointHitTest)      (THIS_ HXxPoint* pPoint) PURE;
  1274.     /************************************************************************
  1275.      * Method:
  1276.      *     IHXRegion::RectHitTest
  1277.      * Purpose:
  1278.      * This function returns 
  1279.      *     HX_CONTAINED if the rect is fully contained within the region
  1280.      *     HX_PART if part of the rect is within the region
  1281.      *     HX_OUT if no part of the rect is within the region
  1282.      *
  1283.      */
  1285.     STDMETHOD_(INT32,RectHitTest)      (THIS_ HXxRect* pRect) PURE;
  1287.     /************************************************************************
  1288.      * Method:
  1289.      *     IHXRegion::GetNumRects
  1290.      * Purpose:
  1291.      *     This function gets the number of rects which describe the 
  1292.      *     region
  1293.      *
  1294.      */
  1296.     STDMETHOD_(UINT32, GetNumRects)      (THIS) PURE;
  1298.     /************************************************************************
  1299.      * Method:
  1300.      *     IHXRegion::GetRectAtIndex
  1301.      * Purpose:
  1302.      *     This function gets the RECT at index nRectIndex
  1303.      *
  1304.      */
  1306.     STDMETHOD(GetRectAtIndex)      (THIS_ UINT32 nRectIndex, REF(HXxRect) rRect) PURE;
  1308.     /************************************************************************
  1309.      * Method:
  1310.      *     IHXRegion::UnionRegion
  1311.      * Purpose:
  1312.      * Union Region -- this operator like all of the operators will create an IHXRegion 
  1313.      * if pDest is NULL.
  1314.      *
  1315.      */
  1317.     STDMETHOD(UnionRegion)      (THIS_ REF(IHXRegion*) pDest, IHXRegion* pSrc1) PURE;
  1319.     /************************************************************************
  1320.      * Method:
  1321.      *     IHXRegion::GetRectAtIndex
  1322.      * Purpose:
  1323.      *     Copy Region
  1324.      *
  1325.      */
  1327.     STDMETHOD(CopyRegion)      (THIS_ REF(IHXRegion*) pDest) PURE;
  1329.     /************************************************************************
  1330.      * Method:
  1331.      *     IHXRegion::GetRectAtIndex
  1332.      * Purpose:
  1333.      *     Diff Region
  1334.      *
  1335.      */
  1337.     STDMETHOD(DiffRegion)      (THIS_ REF(IHXRegion*) pDest, IHXRegion* pSrc1) PURE;
  1339.     /************************************************************************
  1340.      * Method:
  1341.      *     IHXRegion::GetRectAtIndex
  1342.      * Purpose:
  1343.      *     And Region
  1344.      *
  1345.      */
  1347.     STDMETHOD(AndRegion)      (THIS_ REF(IHXRegion*) pDest, IHXRegion* pSrc1) PURE;
  1349.     /************************************************************************
  1350.      * Method:
  1351.      *     IHXRegion::GetRectAtIndex
  1352.      * Purpose:
  1353.      *     XOR Region
  1354.      *
  1355.      */
  1357.     STDMETHOD(XORRegion)      (THIS_ REF(IHXRegion*) pDest, IHXRegion* pSrc1) PURE;
  1359.     /************************************************************************
  1360.      * Method:
  1361.      *     IHXRegion::GetRegion
  1362.      * Purpose:
  1363.      *     Bad hack for the moment to obtain the REGION pointer of an HXRegion.
  1364.      *     Will have to remove this later.
  1365.      *
  1366.      */
  1368.     STDMETHOD_(void*, GetRegion)      (THIS) PURE;
  1370. };
  1372. /****************************************************************************
  1373.  *
  1374.  *  Interface:
  1375.  *
  1376.  *  IHXColorConverterManager
  1377.  *
  1378.  *  Purpose:
  1379.  *
  1380.  *  Interface for obtaining IHXColorConverters
  1381.  *
  1382.  *  IHXColorConverterManager:
  1383.  *
  1384.  *  {00000D15-0902-11d1-8B06-00A024406D59}
  1385.  *
  1386.  */
  1388. DEFINE_GUID(IID_IHXColorConverterManager, 0x00000D15, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1389. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1391. #undef  INTERFACE
  1392. #define INTERFACE   IHXColorConverterManager
  1394. DECLARE_INTERFACE_(IHXColorConverterManager, IUnknown)
  1395. {
  1396.     /*
  1397.      * Get ColorConverter is called to obtain a color converter to convert 
  1398.      * from a particular bitmap to another bitmap.
  1399.      */
  1400.     STDMETHOD(GetColorConverter)      (THIS_
  1401.                 HXBitmapInfoHeader*    /*IN*/  pBitmapInfoIn,
  1402.                 HXBitmapInfoHeader*    /*IN*/  pBitmapInfoOut,
  1403. REF(IHXColorConverter*) /*OUT*/ pConverter) PURE;
  1405. };
  1407. /****************************************************************************
  1408.  *
  1409.  *  Interface:
  1410.  *
  1411.  *  IHXColorConverter
  1412.  *
  1413.  *  Purpose:
  1414.  *
  1415.  *  Interface for converting between two bitmaps of different color formats.
  1416.  *
  1417.  *  IHXColorConverterManager:
  1418.  *
  1419.  *  {00000D16-0902-11d1-8B06-00A024406D59}
  1420.  *
  1421.  */
  1423. DEFINE_GUID(IID_IHXColorConverter, 0x00000D16, 0x903, 0x11d1, 0x8b,
  1424.     0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1426. #undef  INTERFACE
  1427. #define INTERFACE   IHXColorConverter
  1429. DECLARE_INTERFACE_(IHXColorConverter, IUnknown)
  1430. {
  1431.     /*
  1432.      * ColorConvert converts the pBitsIn from one color format to 
  1433.      * the format of pBitsOut
  1434.      */
  1435.     STDMETHOD(ColorConvert)      (THIS_
  1436.                 UCHAR*     pBitsIn,
  1437.                 UCHAR*     pBitsOut,
  1438. HXxRect*    pRectIn,
  1439. HXxRect*    pRectOut
  1440.                 ) PURE;
  1442. };
  1444. /****************************************************************************
  1445.  *
  1446.  *  Interface:
  1447.  *
  1448.  *  IHXOverlayResponse
  1449.  *
  1450.  *  Purpose:
  1451.  *
  1452.  *  Interface for reporting/computing the current statistics relevant to 
  1453.  *  Video Presentations.
  1454.  *
  1455.  *  IHXOverlayResponse:
  1456.  *
  1457.  *  {00000D22-0902-11d1-8B06-00A024406D59}
  1458.  *
  1459.  */
  1461. DEFINE_GUID(IID_IHXOverlayResponse, 0x00000D22, 0x903, 0x11d1, 0x8b,
  1462.     0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1464. #undef  INTERFACE
  1465. #define INTERFACE   IHXOverlayResponse
  1467. DECLARE_INTERFACE_(IHXOverlayResponse, IUnknown)
  1468. {
  1469.     STDMETHOD(OverlayGranted)      (THIS ) PURE;
  1470.     STDMETHOD(OverlayRevoked)      (THIS ) PURE;
  1471. };
  1474. /****************************************************************************
  1475.  *
  1476.  *  Interface:
  1477.  *
  1478.  *  IHXOverlayManager
  1479.  *
  1480.  *  Purpose:
  1481.  *
  1482.  *  Interface for reporting/computing the current statistics relevant to 
  1483.  *  Video Presentations.
  1484.  *
  1485.  *  IHXOverlayManager:
  1486.  *
  1487.  *  {00000D21-0902-11d1-8B06-00A024406D59}
  1488.  *
  1489.  */
  1491. DEFINE_GUID(IID_IHXOverlayManager, 0x00000D21, 0x903, 0x11d1, 0x8b,
  1492.     0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1494. #undef  INTERFACE
  1495. #define INTERFACE   IHXOverlayManager
  1497. DECLARE_INTERFACE_(IHXOverlayManager, IUnknown)
  1498. {
  1499.     STDMETHOD(HasOverlay)      (THIS_
  1500.                     IHXOverlayResponse* pResp
  1501.                     ) PURE;
  1502.     
  1503.     STDMETHOD(AddStats)      (THIS_
  1504.                     IHXOverlayResponse* pResp,
  1505.                     UINT32    ulNumPixels
  1506.                     ) PURE;
  1508.     
  1509.     STDMETHOD(RemoveOverlayRequest)(THIS_ IHXOverlayResponse* pResp ) PURE;
  1510. };
  1513. // $EndPrivate.
  1515. /****************************************************************************
  1516.  *
  1517.  *  Interface:
  1518.  *
  1519.  *  IHXKeyBoardFocus
  1520.  *
  1521.  *  Purpose:
  1522.  *
  1523.  *  Interface for setting/getting the keyboard focus for a particular siteuser
  1524.  *
  1525.  *  IHXKeyBoardFocus:
  1526.  *
  1527.  *  {00000D23-0902-11d1-8B06-00A024406D59}
  1528.  *
  1529.  */
  1531. DEFINE_GUID(IID_IHXKeyBoardFocus, 0x00000D23, 0x903, 0x11d1, 0x8b,
  1532.     0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1534. #undef  INTERFACE
  1535. #define INTERFACE   IHXKeyBoardFocus
  1537. DECLARE_INTERFACE_(IHXKeyBoardFocus, IUnknown)
  1538. {
  1539.     STDMETHOD(SetKeyboardFocus)(THIS_ IHXSiteUser* pSiteUser ) PURE;
  1540.     STDMETHOD(GetKeyboardFocus)(THIS_ IHXSiteUser* &pSiteUser ) PURE;
  1542. };
  1544. /****************************************************************************
  1545.  *
  1546.  *  Interface:
  1547.  *
  1548.  *  IHXDrawFocus
  1549.  *
  1550.  *  Purpose:
  1551.  *
  1552.  *  Interface for displaying the site that has the keyboard focus
  1553.  *
  1554.  *  IHXDrawFocus:
  1555.  *
  1556.  *  {00000D24-0902-11d1-8B06-00A024406D59}
  1557.  *
  1558.  */
  1560. DEFINE_GUID(IID_IHXDrawFocus, 0x00000D24, 0x903, 0x11d1, 0x8b,
  1561.     0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1563. #undef  INTERFACE
  1564. #define INTERFACE   IHXDrawFocus
  1566. DECLARE_INTERFACE_(IHXDrawFocus, IUnknown)
  1567. {
  1568.     /************************************************************************
  1569.      *  Method:
  1570.      *          IHXDrawFocus::SetStyle
  1571.      *  Purpose:
  1572.      *          Ask the site to set the focus style.
  1573.      *
  1574.      *  Syles:
  1575.      *          ULONG32 Properties:
  1576.      *
  1577.      *          LINE_STYLE = HX_SOLID_LINE, HX_DASHED_LINE, HX_DOTTED_LINE,
  1578.      *                       HX_CUSTOM_LINE
  1579.      *          LINE_WIDTH = Width of the line in pixels
  1580.      *          RED = 0-255 color of the primary pixel
  1581.      *          GREEN = 0-255 color of the primary pixel
  1582.      *          BLUE = 0-255 color of the primary pixel
  1583.      *          RED_OFF = 0-255 color of the secondary pixel
  1584.      *          GREEN_OFF = 0-255 color of the secondary pixel
  1585.      *          BLUE_OFF = 0-255 color of the secondary pixel
  1586.      *          CUSTOM_LINE_ENTRIES number of ULONG32s in CUSTOM_LINE_PATTERN
  1587.      *
  1588.      *          IHXBuffer Properties:
  1589.      *
  1590.      *          CUSTOM_LINE_PATTERN list of ULONG32s describing the number
  1591.      *           of primary and secondary pixels (eq 4241 = "----..----." where
  1592.      *           - is a primary pixel and . is a secondary pixel) and
  1593.      *           CUSTOM_LINE_ENTRIES equals 4.  Secondary pixels are not
  1594.      *           drawn if RED_OFF, GREEN_OFF, and BLUE_OFF are not set.
  1595.      */
  1596.     STDMETHOD(SetStyle) (THIS_ IHXValues* pProperties) PURE;
  1598.     /************************************************************************
  1599.      *  Method:
  1600.      *          IHXDrawFocus::ClearFocus
  1601.      *  Purpose:
  1602.      *          Ask the site to clear the current focus drawing.
  1603.      */
  1604.     STDMETHOD(ClearFocus)(THIS) PURE;
  1606.     /************************************************************************
  1607.      *  Method:
  1608.      *          IHXDrawFocus::SetFocusPolygon
  1609.      *  Purpose:
  1610.      *          Ask the site to draw polygon around focus
  1611.      */
  1612.     STDMETHOD(SetFocusPolygon)(THIS_  HXxPoint* pPoints, ULONG32 numPoints) PURE;
  1614.     /************************************************************************
  1615.      *  Method:
  1616.      *          IHXDrawFocus::SetFocusRect
  1617.      *  Purpose:
  1618.      *          Ask the site to draw rectangle around focus
  1619.      */
  1620.     STDMETHOD(SetFocusRect) (THIS_ HXxRect* pRect) PURE;
  1622.     /************************************************************************
  1623.      *  Method:
  1624.      *          IHXDrawFocus::SetFocusEllipse
  1625.      *  Purpose:
  1626.      *          Ask the site to draw ellipse around focus
  1627.      */
  1628.     STDMETHOD(SetFocusEllipse) (THIS_ HXxRect* pRect) PURE;
  1629. };
  1631. // $Private:
  1633. /****************************************************************************
  1634.  *
  1635.  *  Interface:
  1636.  *
  1637.  *  IHXSubRectSite
  1638.  *
  1639.  *  Purpose:
  1640.  *
  1641.  *  Interface to determine if a site support sub rect BLT'ing via
  1642.  *  the HX_SURFACE_UPDATE2 message. If the site does support sub
  1643.  *  rect BLT'ing you can tell the site to send you the
  1644.  *  HX_SURFACE_UPDATE2 messages via this interface.
  1645.  *
  1646.  *  IHXSubRectSite:
  1647.  *
  1648.  *  {00000D25-0902-11d1-8B06-00A024406D59}
  1649.  *
  1650.  */
  1651. DEFINE_GUID(IID_IHXSubRectSite, 0x00000D25, 0x903, 0x11d1, 0x8b,
  1652.     0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1654. #undef  INTERFACE
  1655. #define INTERFACE   IHXSubRectSite
  1657. DECLARE_INTERFACE_(IHXSubRectSite, IHXSite)
  1658. {
  1659.     /*
  1660.      * Tells the site to send/not-send HX_SURFACE_UPDATE2 messages.
  1661.      * These messages contain actuall dirty rects so that the renderer
  1662.      * does not need to BLT the entire frame.
  1663.      */
  1664.     STDMETHOD(SendSubRectMessages) (THIS_ BOOL bRet ) PURE;
  1665.     /*
  1666.      * New damage region call that takes the cross platfrom region
  1667.      * defined in hxwintyp.h and invalidates the rects in it
  1668.      */
  1669.     STDMETHOD(SubRectDamageRegion) (THIS_ HXxBoxRegion* pRegion ) PURE;
  1670.     /*
  1671.      * Method to get the new video surface that comes with the sub
  1672.      * rect BLT'ing support.
  1673.      */
  1674.     STDMETHOD(GetSubRectVideoSurface) (THIS_ 
  1675.                                        REF(IHXSubRectVideoSurface*) pSurface
  1676.                                        ) PURE;
  1677. };
  1679. // $EndPrivate.
  1681. /****************************************************************************
  1682.  *
  1683.  *  Interface:
  1684.  *
  1685.  *  IHXFocusNavigation
  1686.  *
  1687.  *  Purpose:
  1688.  *
  1689.  *  Interface for navigating between and within keyboard focus sites
  1690.  *
  1691.  *  IHXFocusNavigation:
  1692.  *
  1693.  *  {B42B7677-F605-438e-9002-E2AAB7784B43}
  1694.  *
  1695.  */
  1697. DEFINE_GUID(IID_IHXFocusNavigation, 0xb42b7677, 0xf605, 0x438e, 0x90,
  1698.             0x2, 0xe2, 0xaa, 0xb7, 0x78, 0x4b, 0x43);
  1700. #undef  INTERFACE
  1701. #define INTERFACE   IHXFocusNavigation
  1703. DECLARE_INTERFACE_(IHXFocusNavigation, IUnknown)
  1704. {
  1705.     /************************************************************************
  1706.      *  Method:
  1707.      *          IHXFocusNavigation::SetFocus
  1708.      *  Purpose:
  1709.      *          Ask the renderer to set the focus to the given item.
  1710.      */
  1711.     STDMETHOD(SetFocus) (THIS_ HXFocusContext eFocus) PURE;
  1713.     /************************************************************************
  1714.      *  Method:
  1715.      *          IHXFocusNavigation::ClearFocus
  1716.      *  Purpose:
  1717.      *          Ask the renderer to clear the current focus.
  1718.      */
  1719.     STDMETHOD(ClearFocus) (THIS) PURE;
  1721.     /************************************************************************
  1722.      *  Method:
  1723.      *          IHXFocusNavigation::ActivateFocus
  1724.      *  Purpose:
  1725.      *          Ask the renderer to activate the focused link. Do nothing if 
  1726.      *   there is no focus point.
  1727.      */
  1728.     STDMETHOD(ActivateFocus) (THIS) PURE;
  1730.     /************************************************************************
  1731.      *  Method:
  1732.      *          IHXFocusNavigation::GetFocusState
  1733.      *  Purpose:
  1734.      *          Obtain the current focus state
  1735.      */
  1736.     STDMETHOD_(HXFocusState,GetFocusState) (THIS) PURE;
  1737. };
  1739. #endif /* _HXWIN_H_ */