dclipper.htm

DirectX 编程初级教程中文版。只要有C++基础和一点三维知识即可。

    </b></font><font FACE="Arial" SIZE="3"><p>lpDD</p>
    </font><font FACE="宋体" SIZE="3"><p>一个</font><font FACE="Arial" SIZE="3">DirectDraw</font><font
    FACE="宋体" SIZE="3">结构的地址，代表</font><font FACE="Arial" SIZE="3">DirectDraw</font><font
    FACE="宋体" SIZE="3">对象。如果该参数设为</font><font FACE="Arial" SIZE="3">NULL</font><font
    FACE="宋体" SIZE="3">，将创建一个独立的</font><font FACE="Arial" SIZE="3">DirectDrawClipper</font><font
    FACE="宋体" SIZE="3">对象（该对象同样可以调用</font><font FACE="Arial"
    SIZE="3">DirectDrawClipper</font><font FACE="宋体" SIZE="3">接口的函数）。</p>
    </font><font FACE="Arial" SIZE="3"><p>dwFlags</p>
    </font><font FACE="宋体" SIZE="3"><p>该参数尚未使用，只能设为</font><font
    FACE="Arial" SIZE="3">0</font><font FACE="宋体" SIZE="3">。</p>
    <b><p>返回值：</p>
    </b><p>如果函数调用成功，返回</font><font FACE="Arial" SIZE="3">DD_OK</font><font
    FACE="宋体" SIZE="3">。</p>
    <p>如果函数调用失败，返回值可能是下列错误值之一：</p>
    </font><font FACE="Arial" SIZE="3"><p>DDERR_ALREADYINITIALIZED </p>
    <p>DDERR_INVALIDPARAMS</p>
    </font><font FACE="宋体" SIZE="3"><p>提供这个函数是为了与部件对象模型（</font><font
    FACE="Arial" SIZE="3">COM</font><font FACE="宋体" SIZE="3">）的协议保持一致性。如果已经调用</font><font
    FACE="Arial" SIZE="3">DirectDrawCreateClipper</font><font FACE="宋体" SIZE="3">或</font><font
    FACE="Arial" SIZE="3">IDirectDraw2::CreateClipper</font><font FACE="宋体" SIZE="3">创建了该</font><font
    FACE="Arial" SIZE="3">DirectDrawClipper</font><font FACE="宋体" SIZE="3">对象，该函数将返回</font><font
    FACE="Arial" SIZE="3">DDERR_ALREADYINITIALIZED</font><font FACE="宋体" SIZE="3">。</p>
    <b><p>备注：</p>
    </b><p>要得到更多关于如何与</font><font FACE="Arial" SIZE="3">CoCreateInstance </font><font
    FACE="宋体" SIZE="3">一起使用</font><font FACE="Arial" SIZE="3">IDirectDrawClipper::Initialize</font><font
    FACE="宋体" SIZE="3">的资料，请参阅“用</font><font FACE="Arial" SIZE="3">CoCreateInstance</font><font
    FACE="宋体" SIZE="3">创建</font><font FACE="Arial" SIZE="3">DirectDrawClipper</font><font
    FACE="宋体" SIZE="3">对象”。</p>
    <b><p>快速信息：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>Windows NT</font><font FACE="宋体" SIZE="3">：适用于</font><font
    FACE="Arial" SIZE="3">4.0</font><font FACE="宋体" SIZE="3">或更新版</p>
    </font><font FACE="Arial" SIZE="3"><p>Windows</font><font FACE="宋体" SIZE="3">：适用于</font><font
    FACE="Arial" SIZE="3">Windows 95</font><font FACE="宋体" SIZE="3">或更新版</p>
    </font><font FACE="Arial" SIZE="3"><p>Windows CE</font><font FACE="宋体" SIZE="3">：不支持</p>
    <p>头文件：</font><font FACE="Arial" SIZE="3">ddraw.h</p>
    </font><font FACE="宋体" SIZE="3"><p>库文件：</font><font FACE="Arial" SIZE="3">ddraw.lib</p>
    </font><font FACE="宋体" SIZE="3"><b><p>请参阅：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>IUnknown::AddRef, IUnknown::QueryInterface, 
    IUnknown::Release, IDirectDraw2::CreateClipper</p>
    </font><hr>
    <b><font FACE="Arial" SIZE="3" COLOR="#0000ff">
    <li><a name="IDirectDrawClipper::IsClipListChanged">IDirectDrawClipper::IsClipListChanged</a><p
      align="right"></font><font SIZE="3" COLOR="#0000ff"><a href="#目录">回到目录</a></font><font
      FACE="Arial" SIZE="3" COLOR="#0000ff"></p>
    </li>
    </font></b><font FACE="宋体" SIZE="3"><p>如果一个窗口句柄与</font><font
    FACE="Arial" SIZE="3">DirectDrawClipper</font><font FACE="宋体" SIZE="3">对象关联上，该函数用来监控裁剪表的状态。</p>
    </font><font FACE="Arial" SIZE="3"><p>HRESULT IsClipListChanged(</p>
    <p>BOOL FAR *lpbChanged </p>
    <p>);</p>
    </font><font FACE="宋体" SIZE="3"><b><p>参数：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>lpbChanged</p>
    </font><font FACE="宋体" SIZE="3"><p>一个</font><font FACE="Arial" SIZE="3">BOOL</font><font
    FACE="宋体" SIZE="3">变量的地址，如果裁剪表已经改变，则返回</font><font
    FACE="Arial" SIZE="3">TRUE</font><font FACE="宋体" SIZE="3">。</p>
    <b><p>返回值：</p>
    </b><p>如果函数调用成功，返回</font><font FACE="Arial" SIZE="3">DD_OK</font><font
    FACE="宋体" SIZE="3">。</p>
    <p>如果函数调用失败，返回值可能是下列错误值之一：</p>
    </font><font FACE="Arial" SIZE="3"><p>DDERR_INVALIDOBJECT </p>
    <p>DDERR_INVALIDPARAMS</p>
    </font><font FACE="宋体" SIZE="3"><b><p>快速信息：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>Windows NT</font><font FACE="宋体" SIZE="3">：适用于</font><font
    FACE="Arial" SIZE="3">4.0</font><font FACE="宋体" SIZE="3">或更新版</p>
    </font><font FACE="Arial" SIZE="3"><p>Windows</font><font FACE="宋体" SIZE="3">：适用于</font><font
    FACE="Arial" SIZE="3">Windows 95</font><font FACE="宋体" SIZE="3">或更新版</p>
    </font><font FACE="Arial" SIZE="3"><p>Windows CE</font><font FACE="宋体" SIZE="3">：不支持</p>
    <p>头文件：</font><font FACE="Arial" SIZE="3">ddraw.h</p>
    </font><font FACE="宋体" SIZE="3"><p>库文件：</font><font FACE="Arial" SIZE="3">ddraw.lib</p>
    </font><hr>
    <b><font FACE="Arial" SIZE="3" COLOR="#0000ff">
    <li><a name="IDirectDrawClipper::SetClipList">IDirectDrawClipper::SetClipList</a><p
      align="right"></font><font SIZE="3" COLOR="#0000ff"><a href="#目录">回到目录</a></font><font
      FACE="Arial" SIZE="3" COLOR="#0000ff"></p>
    </li>
    </font></b><font FACE="宋体" SIZE="3"><p>设置或删除与</font><font FACE="Arial"
    SIZE="3">DirectDrawClipper</font><font FACE="宋体" SIZE="3">对象相关联的裁剪表，该裁剪表被用于页面的</font><font
    FACE="Arial" SIZE="3">IDirectDrawSurface3::Blt</font><font FACE="宋体" SIZE="3">，</font><font
    FACE="Arial" SIZE="3">IDirectDrawSurface3::BltBatch</font><font FACE="宋体" SIZE="3">，和</font><font
    FACE="Arial" SIZE="3">IDirectDrawSurface3::UpdateOverlay</font><font FACE="宋体"
    SIZE="3">操作。</p>
    </font><font FACE="Arial" SIZE="3"><p>HRESULT SetClipList(</p>
    <p>LPRGNDATA lpClipList, </p>
    <p>DWORD dwFlags </p>
    <p>);</p>
    </font><font FACE="宋体" SIZE="3"><b><p>参数：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>lpClipList</p>
    </font><font FACE="宋体" SIZE="3"><p>一个合法的</font><font FACE="Arial" SIZE="3">RGNDATA</font><font
    FACE="宋体" SIZE="3">结构的地址或</font><font FACE="Arial" SIZE="3">NULL</font><font
    FACE="宋体" SIZE="3">。如果已经存在一个裁剪表与</font><font FACE="Arial"
    SIZE="3">DirectDrawClipper</font><font FACE="宋体" SIZE="3">对象相关联并且该参数被设为</font><font
    FACE="Arial" SIZE="3">NULL</font><font FACE="宋体" SIZE="3">，则裁剪表被删除。</p>
    </font><font FACE="Arial" SIZE="3"><p>dwFlags</p>
    </font><font FACE="宋体" SIZE="3"><p>该参数尚未使用，必须设为</font><font
    FACE="Arial" SIZE="3">0</font><font FACE="宋体" SIZE="3">。</p>
    <b><p>返回值：</p>
    </b><p>如果函数调用成功，返回</font><font FACE="Arial" SIZE="3">DD_OK</font><font
    FACE="宋体" SIZE="3">。</p>
    <p>如果函数调用失败，返回值可能是下列错误值之一：</p>
    </font><font FACE="Arial" SIZE="3"><p>DDERR_CLIPPERISUSINGHWND </p>
    <p>DDERR_INVALIDCLIPLIST </p>
    <p>DDERR_INVALIDOBJECT </p>
    <p>DDERR_INVALIDPARAMS </p>
    <p>DDERR_OUTOFMEMORY</p>
    </font><font FACE="宋体" SIZE="3"><b><p>备注：</p>
    </b><p>如果已经有一个窗口句柄与</font><font FACE="Arial" SIZE="3">DirectDrawClipper</font><font
    FACE="宋体" SIZE="3">对象相关联，裁剪表将不能被设置。应注意的是：</font><font
    FACE="Arial" SIZE="3">IDirectDrawSurface3::BltFast</font><font FACE="宋体" SIZE="3">函数不支持裁剪。</p>
    <p>该函数使用的</font><font FACE="Arial" SIZE="3">RGNDATA</font><font FACE="宋体"
    SIZE="3">结构的定义如下。</p>
    </font><font FACE="Arial" SIZE="3"><p>typedef struct _RGNDATA { </p>
    <p>RGNDATAHEADER rdh; </p>
    <p>char Buffer[1]; </p>
    <p>} RGNDATA; </p>
    <p>RGNDATA</font><font FACE="宋体" SIZE="3">结构的</font><font FACE="Arial" SIZE="3">rdh</font><font
    FACE="宋体" SIZE="3">成员是一个</font><font FACE="Arial" SIZE="3">RGNDATAHEADER</font><font
    FACE="宋体" SIZE="3">结构，它的定义如下：</p>
    </font><font FACE="Arial" SIZE="3"><p>typedef struct _RGNDATAHEADER { </p>
    <p>DWORD dwSize; </p>
    <p>DWORD iType; </p>
    <p>DWORD nCount; </p>
    <p>DWORD nRgnSize; </p>
    <p>RECT rcBound; </p>
    <p>} RGNDATAHEADER; </p>
    </font><font FACE="宋体" SIZE="3"><p>要得到更多的关于这些结构的资料，请参阅</font><font
    FACE="Arial" SIZE="3">SDK</font><font FACE="宋体" SIZE="3">中的帮助文档。</p>
    <b><p>快速信息：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>Windows NT</font><font FACE="宋体" SIZE="3">：适用于</font><font
    FACE="Arial" SIZE="3">4.0</font><font FACE="宋体" SIZE="3">或更新版</p>
    </font><font FACE="Arial" SIZE="3"><p>Windows</font><font FACE="宋体" SIZE="3">：适用于</font><font
    FACE="Arial" SIZE="3">Windows 95</font><font FACE="宋体" SIZE="3">或更新版</p>
    </font><font FACE="Arial" SIZE="3"><p>Windows CE</font><font FACE="宋体" SIZE="3">：不支持</p>
    <p>头文件：</font><font FACE="Arial" SIZE="3">ddraw.h</p>
    </font><font FACE="宋体" SIZE="3"><p>库文件：</font><font FACE="Arial" SIZE="3">ddraw.lib</p>
    </font><font FACE="宋体" SIZE="3"><b><p>请参阅：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>IDirectDrawClipper::GetClipList</font><font
    FACE="宋体" SIZE="3">，</font><font FACE="Arial" SIZE="3">IDirectDrawSurface3::Blt</font><font
    FACE="宋体" SIZE="3">，</font><font FACE="Arial" SIZE="3">IDirectDrawSurface3::BltFast</font><font
    FACE="宋体" SIZE="3">，</font><font FACE="Arial" SIZE="3">IDirectDrawSurface3::BltBatch</font><font
    FACE="宋体" SIZE="3">，</font><font FACE="Arial" SIZE="3">IDirectDrawSurface3::UpdateOverlay</p>
    </font><hr>
    <font FACE="Arial" SIZE="3" COLOR="#0000ff"><b>
    <li><a name="IDirectDrawClipper::SetHWnd">IDirectDrawClipper::SetHWnd</a></b></font><p
      align="right"><font size="3"><a href="#目录">回到目录</a></font></p>
    </li>
  </ol>
</ol>
<font FACE="宋体" SIZE="3">

<blockquote>
  <blockquote>
    <p>将一个窗口的客户区与裁剪表关联上。<font FACE="Arial" SIZE="3"></p>
    <p>HRESULT SetHWnd(</p>
    <p>DWORD dwFlags, </p>
    <p>HWND hWnd </p>
    <p>);</p>
    <p></font><b>　</p>
    <p>参数：</b><font FACE="Arial" SIZE="3"></p>
    <p>dwFlags</font></p>
    <p>该参数尚未使用，只能设为<font FACE="Arial" SIZE="3">0</font>。<font
    FACE="Arial" SIZE="3"></p>
    <p>hWnd</font></p>
    <p>包含了裁剪信息的窗口句柄。</p>
    <p><b>　</p>
    <p>返回值：</p>
    <blockquote>
      <blockquote>
        </b><p>如果函数调用成功，返回<font FACE="Arial" SIZE="3">DD_OK</font>。</p>
        <p>如果函数调用失败，返回值可能是下列错误值之一：</p>
        <font FACE="Arial" SIZE="3"><p>DDERR_INVALIDCLIPLIST </p>
        <p>DDERR_INVALIDOBJECT </p>
        <p>DDERR_INVALIDPARAMS </p>
        <p>DDERR_OUTOFMEMORY</p>
        </font>
      </blockquote>
    </blockquote>
    <b><p>快速信息：</b><font FACE="Arial" SIZE="3"></p>
    <p>Windows NT</font>：适用于<font FACE="Arial" SIZE="3">4.0</font>或更新版<font
    FACE="Arial" SIZE="3"></p>
    <p>Windows</font>：适用于<font FACE="Arial" SIZE="3">Windows 95</font>或更新版<font
    FACE="Arial" SIZE="3"></p>
    <p>Windows CE</font>：不支持</p>
    <p>头文件：<font FACE="Arial" SIZE="3">ddraw.h</font></p>
    <p>库文件：<font FACE="Arial" SIZE="3">ddraw.lib</font><b></p>
    <p>请参阅：</b><font FACE="Arial" SIZE="3"></p>
    <p>IDirectDrawClipper::GetHWnd</font></p>
  </blockquote>
</blockquote>
</font>

<p align="right"><font size="3"><a href="#目录">回到目录</a></font></p>
</body>
</html>