20000727004.htm

C++Builder教学大全

              <p align="left">int <i>yDst</i>,<font lang="ZH-CN"> </font></p>
              <p align="left">int <i>dxDst</i>,<font lang="ZH-CN"> </font></p>
              <p align="left">int <i>dyDst</i>,<font lang="ZH-CN"> </font></p>
              <p align="left">LPBITMAPINFOHEADER <i>lpbi</i>,<font lang="ZH-CN"> 
                </font></p>
              <p align="left">LPVOID <i>lpBits</i>,<font lang="ZH-CN"> </font></p>
              <p align="left">int <i>xSrc</i>,<font lang="ZH-CN"> </font></p>
              <p align="left">int <i>ySrc</i>,<font lang="ZH-CN"> </font></p>
              <p align="left">int <i>dxSrc</i>,<font lang="ZH-CN"> </font></p>
              <p align="left">int <i>dySrc</i>,<font lang="ZH-CN"> </font></p>
              <p align="left">UINT <i>wFlags</i><font lang="ZH-CN"> </font></p>
              <p align="left"><b>);</b></p>
            </dir>
          </dir>
        </dir>
        <p align="left"><font lang="ZH-CN">参数</font></p>
        <p align="left"> hdd DrawDib DC<font lang="ZH-CN">的句柄。</font></p>
        <p align="left"> hdc DC<font lang="ZH-CN">的句柄。</font></p>
        <p align="left"> xDst<font lang="ZH-CN">和</font>yDst <font lang="ZH-CN">在</font>MM_TEXT<font lang="ZH-CN">坐标系，目标矩形左上角的</font>x<font lang="ZH-CN">和</font>y<font lang="ZH-CN">坐标。</font></p>
        <p align="left"> dxDst<font lang="ZH-CN">和</font>dyDst <font lang="ZH-CN">在</font>MM_TEXT<font lang="ZH-CN">坐标系下，目标矩形的宽度和高度。如果</font>dxDst<font lang="ZH-CN">为</font>-1<font lang="ZH-CN">，则使用位图的宽度；如果</font>dyDst<font lang="ZH-CN">为</font>-1<font lang="ZH-CN">，则使用位图的高度。</font></p>
        <p align="left"> lpbi <font lang="ZH-CN">包含图象格式的</font>BITMAPINFOHEADER<font lang="ZH-CN">结构的地址。</font>DIB<font lang="ZH-CN">的颜色表紧跟着格式后，并且</font>biHeight<font lang="ZH-CN">成员必须为正值；</font>DrawDibDraw<font lang="ZH-CN">不能绘制倒置的</font>DIB<font lang="ZH-CN">。</font></p>
        <p align="left"> lpbits <font lang="ZH-CN">包含位图位的缓冲的地址。</font></p>
        <p align="left"> xSrc<font lang="ZH-CN">和</font>ySrc <font lang="ZH-CN">以象素为单位，源矩形左上角的</font>x<font lang="ZH-CN">和</font>y<font lang="ZH-CN">坐标。坐标（</font>0<font lang="ZH-CN">，</font>0<font lang="ZH-CN">）是位图的左上角。</font></p>
        <p align="left"> dxSrc<font lang="ZH-CN">和</font>dySrc <font lang="ZH-CN">以象素为单位，源矩形的宽度和高度。</font></p>
        <p align="left"> wFlags <font lang="ZH-CN">可用的绘图标志。如下值被定义： </font> 
        <dir> 
          <dir> 
            <p align="left">DDF_BACKGROUNDPAL <font lang="ZH-CN">实现作为背景的调色板，保留当前显示所使用的调色板不变。这个值只有当</font>DDF_SAME_HDC<font lang="ZH-CN">未被设置时才有效。</font></p>
            <p align="left">DDF_DONTDRAW <font lang="ZH-CN">当前图象已解压但未绘。这个标志取代了</font>DDF_PREROLL<font lang="ZH-CN">标志。</font></p>
            <p align="left">DDF_FULLSCREEN <font lang="ZH-CN">不被支持。</font></p>
            <p align="left">DDF_HALFTONE <font lang="ZH-CN">不管</font>DIB<font lang="ZH-CN">的调色板如何而把</font>DIB<font lang="ZH-CN">抖动成标准调色板。如果应用程序使用了</font>DrawDibBegin<font lang="ZH-CN">，在</font>DrawDibBegin<font lang="ZH-CN">中设置而不在</font>DrawDibDraw<font lang="ZH-CN">中。</font></p>
            <p align="left">DDF_HURRYUP <font lang="ZH-CN">数据并不需要被绘（它可以被绘）并且</font>DDF_UPDATE<font lang="ZH-CN">不用理会这个信息。</font>DrawDib<font lang="ZH-CN">只有当需要去构建另一帧时才检查这个值；否则，这个值被忽略。</font></p>
            <p align="left"><font lang="ZH-CN">这个值通常用来同步视频和音频。当同步数据时，应用程序应当用这个值发送图象以防止驱动器需要缓冲帧来解压后续帧。</font></p>
            <p align="left">DDF_NOTKEYFRAME DIB<font lang="ZH-CN">数据不是关键帧。</font></p>
            <p align="left">DDF_SAME_HDC <font lang="ZH-CN">使用当前</font>DC<font lang="ZH-CN">句柄以及与当前句柄相关联的调色板。</font></p>
            <p align="left">DDF_SAME_DRAW <font lang="ZH-CN">让</font>DrawDibDraw<font lang="ZH-CN">使用当前的绘制参数。只有当从使用</font>DrawDibDraw<font lang="ZH-CN">或</font>DrawDibBegin<font lang="ZH-CN">起，</font>lpbi<font lang="ZH-CN">、</font>dxDext<font lang="ZH-CN">、</font>dyDest<font lang="ZH-CN">、</font>dxSrc<font lang="ZH-CN">和</font>dySrc<font lang="ZH-CN">就未改变才用这个值。</font>DrawDibDraw<font lang="ZH-CN">经常检查这些参数，如果它们改变了，</font>DrawDibBegin<font lang="ZH-CN">则准备绘图的</font>DrawDib 
              DC<font lang="ZH-CN">。这个标志取代了</font>DDF_SAME_DIB<font lang="ZH-CN">和</font>DDF_SAME_SIZE<font lang="ZH-CN">标志。</font></p>
            <p align="left">DDF_UPDATE <font lang="ZH-CN">最后缓存的图象需要绘制。如果用这个值绘制失败，则缓冲的图象不在有效，并且在显示被更新前，需要指定一幅新的图象。</font></p>
          </dir>
        </dir>
        <p align="left"><font lang="ZH-CN">返回值</font></p>
        <p align="left"><font lang="ZH-CN">成功返回</font>TRUE<font lang="ZH-CN">，否则</font>FALSE<font lang="ZH-CN">。</font></p>
        <p align="left"> <font lang="ZH-CN">注 </font>DDF_DONTDRAW<font lang="ZH-CN">使</font>DrawDibDraw<font lang="ZH-CN">解压但不显示一幅图象。一个调用</font>DrawDibDraw<font lang="ZH-CN">的序列是指定</font>DDF_UPDATE<font lang="ZH-CN">来显示图象。</font></p>
        <p align="left"> <font lang="ZH-CN">如果</font>DrawDib DC<font lang="ZH-CN">没有指定一个屏幕缓冲，指定</font>DDF_DONTDRAW<font lang="ZH-CN">会造成这帧被立即绘到屏幕。序列调用</font>DrawDibDraw<font lang="ZH-CN">指定</font>DDF_UPDATE<font lang="ZH-CN">会失败。</font></p>
        <p align="left"> <font lang="ZH-CN">尽管</font>DDF_UPDAT<font lang="ZH-CN">和</font>DDF_DONTDRAW<font lang="ZH-CN">可以在不同时间设置，它们可以一起用来创建脱屏图象。当脱屏图象完成后，可以调用</font>DrawDibDraw<font lang="ZH-CN">来显示图象。</font></p>
        <p align="left"><b>DrawDibEnd</b></p>
        <p align="left"> <font lang="ZH-CN">这个函数清除由</font>DrawDibBegin<font lang="ZH-CN">或</font>DrawDibDraw<font lang="ZH-CN">函数设置的标志和</font>DrawDib 
          DC<font lang="ZH-CN">的其它设置。 </font> 
        <dir> 
          <p align="left">BOOL DrawDibEnd(</p>
        </dir>
        <p align="left"> HDRAWDIB <i>hdd</i><font lang="ZH-CN"> </font></p>
        <p align="left"> );<font lang="ZH-CN"> </font></p>
        <p align="left"><font lang="ZH-CN">参数</font></p>
        <p align="left"> hdd <font lang="ZH-CN">要释放的</font>DrawDib DC<font lang="ZH-CN">的句柄。</font></p>
        <p align="left"><font lang="ZH-CN">返回值</font></p>
        <p align="left"><font lang="ZH-CN">成功返回</font>TRUE<font lang="ZH-CN">，否则</font>FALSE<font lang="ZH-CN">。</font></p>
        <p align="left"><b>DrawDibGetBuffer</b></p>
        <p align="left"> <font lang="ZH-CN">这个函数清除由</font>DrawDib<font lang="ZH-CN">用来解压的缓冲的地址。 
          </font> 
        <dir> 
          <dir> 
            <p align="left">LPVOID DrawDibGetBuffer( 
            <dir> 
              <p align="left"> HDRAWDIB <i>hdd</i>,<font lang="ZH-CN"> </font></p>
              <p align="left">LPBITMAPINFOHEADER <i>lpbi</i>,<font lang="ZH-CN"> 
                </font></p>
              <p align="left">DWORD <i>dwSize</i>,<font lang="ZH-CN"> </font></p>
              <p align="left">DWORD <i>dwFlags</i><font lang="ZH-CN"> </font></p>
            </dir>
          </dir>
        </dir>
        <p align="left">);</p>
        <p align="left"><font lang="ZH-CN">参数</font></p>
        <p align="left"> hdd <font lang="ZH-CN">要释放的</font>DrawDib DC<font lang="ZH-CN">的句柄。</font></p>
        <p align="left"> lpbi BITMAPINFO<font lang="ZH-CN">结构的地址。这个结构由</font>BITMAPINFOHEADER<font lang="ZH-CN">结构和位图使用的</font>256<font lang="ZH-CN">色调色板所定义的颜色表。</font></p>
        <p align="left"> dwSize <font lang="ZH-CN">通过</font>lpbi<font lang="ZH-CN">的</font>BITMAPINFO<font lang="ZH-CN">结构所指的字节大小。</font></p>
        <p align="left"> dwFlags <font lang="ZH-CN">保留，必须为</font>0<font lang="ZH-CN">。</font></p>
        <p align="left"><font lang="ZH-CN">返回值</font></p>
        <p align="left"><font lang="ZH-CN">返回缓冲的地址或者如果没有用到缓冲返回</font>NULL<font lang="ZH-CN">。如果</font>lpbi<font lang="ZH-CN">不为</font>NULL<font lang="ZH-CN">，它填充了一个描绘缓冲的</font>BITMAPINFO<font lang="ZH-CN">的结构。</font></p>
        <p align="left"><b>DrawDibGetPalette</b></p>
        <p align="left"> <font lang="ZH-CN">这个函数清除由</font>DrawDib DC<font lang="ZH-CN">所使用的调色板。</font></p>
        <p align="left">HPALETTE DrawDibGetPalette(</p>
        <p align="left">HDRAWDIB <i>hdd</i><font lang="ZH-CN"> </font></p>
        <p align="left">);</p>
        <p align="left"><font lang="ZH-CN">参数</font></p>
        <p align="left"> hdd <font lang="ZH-CN">要释放的</font>DrawDib DC<font lang="ZH-CN">的句柄。</font></p>
        <p align="left"><font lang="ZH-CN">返回值</font></p>
        <p align="left"><font lang="ZH-CN">成功返回一个调色板句柄，否则返回</font>NULL<font lang="ZH-CN">。</font></p>
        <p align="left"> <font lang="ZH-CN">注</font> <font lang="ZH-CN">这个函数假设</font>DrawDib 
          DC<font lang="ZH-CN">包含了一个有效的调色板，隐含着这样的一个条件：对这个函数的调用必须在</font>DrawDibDraw<font lang="ZH-CN">或</font>DrawDibBegin<font lang="ZH-CN">函数之后。</font></p>
        <p align="left"><b>DrawDibOpen</b></p>
        <p align="left"> <font lang="ZH-CN">这个函数打开</font>DrawDib<font lang="ZH-CN">库为使用和创建一个绘图的</font>DrawDib 
          DC<font lang="ZH-CN">作准备。</font></p>
        <p align="left">HDRAWDIB DrawDibOpen(VOID); </p>
        <p align="left"><font lang="ZH-CN">参数</font></p>
        <p align="left"><font lang="ZH-CN">这个函数不需要参数。</font></p>
        <p align="left"><font lang="ZH-CN">返回值</font></p>
        <p align="left"><font lang="ZH-CN">成功返回一个</font>DrawDib DC<font lang="ZH-CN">的句柄，否则为</font>NULL<font lang="ZH-CN">。</font></p>
        <p align="left"> <font lang="ZH-CN">注</font> <font lang="ZH-CN">当同时绘多个</font>DIB<font lang="ZH-CN">时，为同时在屏的每个图象创建一个</font>DrawDib 
          DC<font lang="ZH-CN">。</font></p>
        <p align="left"><b>DrawDibProfileDisplay</b></p>
        <p align="left"> <font lang="ZH-CN">这个函数决定了当用</font>DrawDib<font lang="ZH-CN">函数时显示系统的设置。</font></p>
        <p align="left">BOOL DrawDibProfileDisplay(</p>
        <p align="left">LPBITMAPINFOHEADER <i>lpbi</i><font lang="ZH-CN"> </font></p>
        <p align="left">);</p>
        <p align="left"><font lang="ZH-CN">参数</font></p>
        <p align="left"> lpbi <font lang="ZH-CN">包含位图信息的</font>BITMAPINFOHEADER<font lang="ZH-CN">结构。可以通过指定</font>NULL<font lang="ZH-CN">来确认配置信息是当前的。如果配置信息不是当前的，</font>DrawDib<font lang="ZH-CN">会重新运行配置测试来得到当前设置信息。如果把这个参数设为</font>NULL<font lang="ZH-CN">来调用</font>DrawDibProfileDisplay<font lang="ZH-CN">返回值是没有意义的。</font></p>
        <p align="left"><font lang="ZH-CN">返回值</font></p>
        <p align="left"><font lang="ZH-CN">返回值指出了这个显示系统的最快绘制和拉伸能力。如果位图格式不被支持，这个值为</font>0<font lang="ZH-CN">或一个或更多的下列值：</font></p>
        <p align="left"> PD_CAN_DRAW_DIB DrawDib<font lang="ZH-CN">能用这种格式绘图象。拉伸可能被支持或不被支持。</font></p>
        <p align="left"> PD_CAN_STRETCHDIB DrawDib<font lang="ZH-CN">能用这种格式拉伸或绘制图象。</font></p>
        <p align="left"> PD_STRETCHDIB _1_1_OK StretchDIBits<font lang="ZH-CN">用这种格式绘未拉伸的图象快于另一种方式。</font></p>
        <p align="left"> PD_STRETCHDIB _1_2_OK StretchDIBits<font lang="ZH