DJYGUI系列文章十一:GDD矩形区域运算
1 GDD矩形区域运算
说明下矩形的位置基准。 后面补充详细说明,先把API接口写上……
2 API说明
2.1 RectW: 获得矩形宽度
s32 RectW(const RECT *prc);
头文件:
gdd.h
参数:
prc: 矩形对象指针。
返回值:
矩形宽度。
2.2 RectH: 获得矩形高度
int RectH(const RECT *prc);
头文件:
gdd.h
参数:
prc: 矩形对象指针。
返回值:
矩形高度。
2.3 SetRect: 设置矩形参数
void SetRect(RECT *prc,s32 x, s32 y, s32 w, s32 h);
头文件::
gdd.h
参数:
prc: 需要设置的矩形对象指针。
x,y: 矩形起始位置(左上角坐标)。
w,h: 矩形宽度和高度。
返回值: 无。
2.4SetRectEmpty: 设置一个矩形为空矩形
void SetRectEmpty(RECT *prc);
头文件:
gdd.h
参数:
prc: 需要设置的矩形对象指针。
返回值: 无。
说明:
当一个矩形的宽度或高度等于0时, 即表示这个矩形为空矩形。
2.5 IsRectEmpty: 判断一个矩形是否为空矩形
BOOL IsRectEmpty(const RECT *prc);
头文件:
gdd.h
参数:
prc: 需要判断的矩形对象指针。
返回值:
TRUE: 该矩形为空矩形; FALSE: 该矩形为非空矩形。
2.6 CopyRect: 复制矩形参数
BOOL CopyRect(RECT *dst,const RECT *src);
头文件:
gdd.h
参数:
dst: 目标矩形对象。
src: 源矩形对象。
返回值:
TRUE: 成功; FALSE:失败。
说明:
该函数将源矩形对象的参数复制到目标矩形对象中。
2.7 OffsetRect: 偏移矩形位置
BOOL OffsetRect(RECT *prc,s32 dx,s32 dy);
头文件:
gdd.h
参数:
prc: 需要偏移的矩形对象指针。
dx: 水平方向的偏移值,当为负值时,向左偏移,否则向右偏移。
dy: 垂直方向的偏移值,当为负值时,向上偏移,否则向下偏移。
返回值: TRUE: 成功; FALSE:失败。
2.8 InflateRect: 扩大或缩小矩形
BOOL InflateRect(RECT *prc, s32 dx, s32 dy);
头文件:
gdd.h
参数:
prc: 矩形对象指针。
dx: 矩形左边和右边,分别扩大或缩小的值,当该参数为负值时,为减小,否则为增大。
dy: 矩形上边和下边,分别扩大或缩小的值,当该参数为负值时,为减小,否则为增大。
返回值:
TRUE:成功; FALSE:失败.
2.9 InflateRectEx: 扩大或缩小矩形
BOOL InflateRectEx(RECT *prc, s32 l, s32 t, s32 r, s32 b);
头文件:
gdd.h
参数:
prc: 矩形对象指针。
l: 矩形左边扩大或缩小的值,当该参数为负值时,为减小,否则为增大。
t: 矩形上边扩大或缩小的值,当该参数为负值时,为减小,否则为增大。
r: 矩形右边扩大或缩小的值,当该参数为负值时,为减小,否则为增大。
b: 矩形下边扩大或缩小的值,当该参数为负值时,为减小,否则为增大。
返回值:
TRUE:成功; FALSE:失败。
2.10 PtInRect: 判断坐标点是否在矩形范围内
BOOL PtInRect(const RECT *prc,const POINT *pt);
头文件:
gdd.h
参数:
prc: 矩形对象指针。
pt: 坐标点对象指针。
返回值:
TRUE:坐标点在矩形范围内;FALSE:坐标点不在矩形范围内。