部分MFC和API函数(3)

CGdiObject类：GDI绘图工具的基类
CGdiObject::DeleteObject 释放与连接的GDI对象相关的所有系统存储，从内存中将其删除
BOOL DeleteObject();
返回值：若GDI对象被成功删除，返回非0；否则返回0
 
CGdiObject::GetSafeHandle 获取连接的Windows GDI对象的句柄
HGDIOBJ GetSafeHandle()const;
返回值：所连接的Windows GDI对象的句柄，若没有连接Windows GDI对象，则返回NULL
 
 
 
CImageList类：管理大小相同的图标或位图集
CImageList::Add 在影像列表中添加一个或多个影像或图标
int Add(CBitmap* pbmImage,CBitmap* pbmMark);
参数：pbmImage 指向包含影像位图的指针；pbmMark 指向包含屏蔽位图的指针，若没有屏蔽，此参数被忽略。
返回值：若成功，返回第一个影像的以0为基的索引，否则返回-1。
 
CImageList::Create 构造一个CImageList对象
BOOL Create(int cx,int cy,BOOL bMark,int nInitial,int nGrow);
参数：cx、cy为影像大小，以像素为单位；bMark 若影像包含屏蔽则为TRUE，否则为FALSE；nInitial 包含的影像数；nGrow 当需要改变列表大小时，允许扩大到的影像数。
返回值：若成功，返回非0；否则返回0
 
 
CMenu类：封装应用程序菜单栏和弹出式菜单
CMenu::DestoryMenu 撤销菜单及所用的Windows资源

BOOL DestoryMenu();
返回值：若菜单撤销成功，则返回非0值；否则返回0。
说明：撤销之前需用Detach()将菜单与CMenu对象断开连接。
 
CMenu::Detach 将一菜单与CMenu对象断开连接

HMENU Detach();
返回值：若函数成功，返回菜单的句柄；否则返回NULL。
 
CMenu::GetSubMenu 检取一个菜单中的弹出式子菜单对象

CMenu* GetSubMenu(int nPos)const;
参数：nPos 弹出式子菜单在父菜单中的位置，从0开始算起
返回值：若给定位置存在一个弹出式子菜单，返回指向子菜单对象的指针；否则返回NULL。
 
CMenu::InsertMenu 在菜单中插入一个新的菜单项

BOOL InsertMenu(UINT nPosition,UINT nFlag,UINT nIDNewItem=0,LPCTSTR lpszNewItem=NULL);
BOOL InsertMenu(UINT nPosition,UINT nFlag,UINT nIDNewItem,const CBitmap* pBmp);
参数：nPosition 指定要插入的菜单项的位置
nFlag 指出nPosition的解释和新菜单项的状态
对nPosition的解释可取下面值之一：
MF_BYCOMMAND：要求nPosition为已存在的一个菜单项的ID号
MF_BYPOSITION：要求nPosition为已存在的一个菜单项的位置
新菜单项状态可取以下值：
MF_CHECKED：在菜单项前加一个检测标志
MF_DISABLED：使菜单项无效，但菜单项不变灰
MF_GRAYED：使菜单项无效，且菜单项变灰
MF_OWNERDRAW：指定菜单项是用户自绘的项
MF_POPUP：指定菜单项有与之相关联的弹出菜单
MF_SEPARATOR：绘制一条水平分隔线，仅能用于弹出菜单项
MF_STRING：指定菜单项为一个字符串
nIDNewItem 指定新菜单项的ID号
lpszNewItem 新菜单项的文本
pBmp 指向将作为菜单项使用的CBitmap对象
插入时在指定的菜单项前面插入
 
CMenu::LoadMenu 加载一个菜单资源，并将其连接到CMenu对象上

BOOL LoadMenu(LPCTSTR lpszResourceName);
BOOL LoadMenu(UINT nIDResource);
参数：lpszResourceName 指向一个以NULL结尾的字符串，其中包含要加载的菜单资源名；
nIDResource 指定要加载的菜单资源的菜单ID。
返回值：若菜单资源加载成功，则返回非0值；否则返回0。
 
CMenu::RemoveMenu 删除指定菜单项

BOOL RemoveMenu(UINT nPosition,UINT nFlags);
参数：nPosition 指定要删除的菜单项
nFlag 指出nPosition的解释，参照InsertMenu()函数
返回值：若成功，返回非0值；否则返回0。
 
CMenu::TrackPopupMenu 在指定位置显示一个弹出式菜单，并跟踪该菜单的选择

BOOL TrackPopupMenu(UINT nFlag,int x,int y,CWnd* pWnd,LPCRECT lpRect=NULL);
参数：nFlags 指定屏幕位置标志和鼠标按钮标志；
屏幕位置标志可以是下列值之一：
TPM_CENTERALIGN 定位菜单相对于x指定的坐标水平居中；
TPM_LEFTALIGN 定位菜单使其左边对齐x指定的坐标；
TPM_RIGHTALIGN 定位菜单使其右边对齐x指定的坐标；
鼠标按钮标志可以是下列值之一：
TPM_LEFTBUTTON 使弹出菜单在单击鼠标左键时弹出；
TPM_RIGHTBUTTON 使弹出菜单在单击鼠标右键时弹出。
x、y 弹出式菜单在屏幕中的位置(屏幕坐标)；
pWnd 指向拥有此菜单的窗口；
lpRect 指向一个RECT结构或CRect对象，设定菜单尺寸。
 
 
CPen类：封装了Windows图形设备接口(GDI)中的画笔对象
CPen::CreatePen 用指定风格、宽度和颜色初始化一个画笔
BOOL CreatePen(int nPenStyle,int nWidth,COLORREF crColor);
参数：nPenStyle指定画笔的风格，取值如下：
PS_SOLID：实线；
PS_DASH：虚线；
PS_DOT：点线；
PS_DASHDOT：点划线；
PS_DASHDOTDOT：双点划线；
PS_NULL：空画笔；
PS_ENSIDEFRAME：内框线。
nWidth为画笔的宽度，单位为像素；crColor指定画笔的颜色
返回值：若成功，返回非0；否则返回0
 
 
CPoint类：操作CPoint和POINT结构
CPoint::CPoint 构造一个CPoint对象

CPoint();
CPoint(int initX,int initY);
CPoint(POINT initPt);
CPoint(SIZE initSize);
CPoint(DWORD dwPoint);
参数：initX 初始化CPoint的X成员。initY 初始化CPoint的Y成员。
initPt 初始化CPoint的一个POINT结构或CPoint对象。
initSize 用SIZE结构中的cx和cy初始化CPoint的X成员和Y成员。
dwPoint 设置X成员为参数的低位字，Y成员为参数的高位字。
若未给定参数，则X和Y成员不被初始化
 
 
CRect类：封装了一个矩形区域及相关操作
CRect::BottomRight 求CRect对象的右下角坐标

CPoint& BottomRight();
返回值：对CRect对象右下角点的一个引用
 
CRect::CenterPoint 求CRect对象的中心点
CPoint CenterPoint()const;
返回值：CRect对象的中心点坐标
 
CRect::Height 求CRect对象的高度
int Height()const;
返回值：CRect对象的高度
 
CRect::PtInRect 判断指定点是否在CRect对象的区域内
BOOL PtInRect(POINT point)const;
参数：point是一个POINT结构或CPoint对象
返回值：指定点在CRect对象内，返回非0值，否则返回0
 
CRect::SetRect 设置CRect对象的值
void SetRect(int x1,int y1,int x2, int y2);
参数：x1、y1为左上角坐标，x2、y2为右下角坐标
 
CRect::Width 求CRect对象的宽度
int Width()const;
返回值：CRect对象的宽度
 
 
CRgn类：封装用于操作窗口中的椭圆、多边形或者不规则区域的GDI区域
CRgn::CreatePolygonRgn 创建一个多边形区域
BOOL CreatePolygonRgn(LPPOINT lpPoints,int nCount,int nMode);
参数：lpPoints指向一个POINT结构的数组或CPoint对象的数组；nCount是数组中元素个数；nMode指定区域的填充方式，可以为ALTERATE或WINDING
 
 
CSpinButtonCtrl类：旋转控件Spin的控制类
CSpinButtonCtrl::GetPos 获取旋转控件的当前位置
int GetPos()const;
返回值：当前位置（用低位字表示），若有错误产生，高位字为非0
 
CSpinButtonCtrl::SetBuddy 设置旋转控件的伙伴窗口
CWnd* SetBuddy(CWnd* pWndButton);
参数：pWndButton是一个指向新伙伴窗口的指针
返回值：一个指向以前伙伴窗口的指针
 
CSpinButtonCtrl::SetPos 设置控件的位置
int SetPos(int nPos);
参数：nPos为控件的新位置，该值必须在控件指定的上下限范围内
返回值：以前位置
 
CSpinButtonCtrl::SetRange 设置控件的范围
void SetRange(int nLower,int nUpper);
参数：nLower、nUpper为该控件的上下限
 
 
CStatusBar类：状态栏窗口的基类
CStatusBar::SetPaneInfo 为指定窗格设置新的ID，风格和宽度
void SetPaneInfo(int nIndex,UINT nID,UINT nStyle,int cxWidth);
参数：nIndex 窗格索引值，nID 窗格新ID值，nStyle 窗格的新风格，cxWidth 窗格的新宽度
 
CStatusBar::SetPaneText 为指定窗格设置文本
BOOL SetPaneText(int nIndex,LPCTSTR lpszNewText,BOOL bUpdate=TRUE);
参数：nIndex 窗格索引值，lpszNewText 新的窗格文本，bUpdate 若为TRUE，则设置后窗格将无效
返回值：若成功，返回非0；否则返回0
 
 
CString类：处理字符串
CString::Compare 比较字符串

int Compare(LPCTSTR lpsz)const;
参数：lpsz 用于比较的另一个字符串
返回值：字符串相等，返回0；CString对象小于lpsz，返回-1；否则返回1。
 
CString::CompareNoCase 不区分大小写比较字符串

int CompareNoCase(LPCTSTR lpsz)const;
参数：lpsz 用于比较的另一个字符串
返回值：字符串相等，返回0；CString对象小于lpsz，返回-1；否则返回1。
 
CString::Empty 清空字符串，并根据需要释放内存
void Empty();
 
CString::Format 格式化一个CString对象
void Format(LPCTSTR lpszFormat,...);
参数：lpszFormat 格式字符串
功能：用格式化数据定义一个CString对象。这里用来把整数等其它类型转换为字符串。
 
CString::GetLength 求字符串中字节数
int GetLength()const;
返回值：字符串中字节数，该计数值不计NULL结束符
 
CString::GetBuffer 为CString对象申请内部字符缓冲区

LPTSTR GetBuffer(int nMinBufLength);
参数：nMinBufLength 指出字符缓冲区的最小大小值
返回值：指向该对象的以NULL结束的字符缓冲区的指针
 
CString::IsEmpty 测试字符串是否为空
BOOL IsEmpty();
返回值：若字符串为空，返回TRUE，否则返回FALSE
 
CString::Left 从串的前面提取子字符串
CString Left(int nCount)const;
参数：nCount为提取的字符数
返回值：抽取的子字符串的一个拷贝，可能为空
 
CString::LoadString 从Windows资源中加载一个已存在的CString对象

BOOL LoadString(UINT nID);
参数：nID Windows字符串资源ID
返回值：若加载资源成功，返回非0；否则返回0
说明：nID标识的字符串最大长度为255个字符
 
CString::MakeLower 将CString对象转换为一个小写字符串

void MakeLower();
 
CString::MakeReverse 逆向CString对象中字符的次序

void MakeReverse();
 
CString::MakeUpper 将CString对象转换为一个大写字符串

void MakeUpper();
 
CString::Mid 提取子字符串
CString Mid(int nFirst,int nCount)const;
参数：nFirst提取的起始位置；nCount提取的字符数，若未指定，则提取字符串的剩余部分
返回值：抽取的子字符串的一个拷贝，可能为空
 
CString::ReleaseBuffer 释放由GetBuffer分配的多余缓冲区

void ReleaseBuffer(int nNewLength=-1);
参数：nNewLength 字符串对象的实际长度（不含NULL）
功能：把CString对象的大小设置为nNewLength指示的大小；若nNewLength为-1，则设置为该字符串到NULL为止的长度。
 
CString::Right 从串的后面提取子字符串
CString Right(int nCount)const;
参数：nCount为提取的字符数
返回值：抽取的子字符串的一个拷贝，可能为空
 
 
CStringList类：支持CString对象的列表
列表元素必须通过POSITION值进行访问，POSITION类型的变量是列表的一个键，与索引不同，程序不可操作POSITION值。
CStringList::AddTail 将一个元素或元素列表增加到该表表尾
POSITION AddTail(LPCTSTR newElement);
POSITION AddTail(const CString& newElement);
POSITION AddTail(CStringList* pNewList);
参数：newElement指示要增加到列表中的元素；pNewList指向另一个CStringList列表
返回值：插入元素的POSITION值
 
CStringList::FindIndex 获取由索引值指定的元素的位置
POSITION FindIndex(int nIndex)const;
参数：nIndex 要查找的列表元素的索引值（基于0，相当于下标）
返回值：索引值所对应的元素位置，若nIndex过大或为负，则返回NULL
 
CStringList::GetAt 获取给定位置处的元素
CString GetAt(POSITION position);
CString& GetAt(POSITION position);
参数：position 元素位置
返回值：元素值或元素的引用
 
CStringList::GetCount 求列表中元素个数
int GetCount()const;
返回值：列表中元素个数
 
CStringList::GetHeadPosition 获取列表首部元素的位置
POSITION GetHeadPosition()const;
返回值：表头元素的POSITION值，若列表为空，则返回NULL
 
CStringList::GetNext 获取下一个元素
CString GetNext(POSITION& rPosition);
CString& GetNext(POSITION& rPosition);
参数：rPosition 为上一次访问时的元素位置，当GetNext执行后，被设置为列表下一项的POSITION值
返回值：元素值或元素的引用
 
CStringList::RemoveAll 删除列表中所有元素，并释放关联的内存
void RemoveAll();
 
 
CWinApp类：派生的程序对象的基类
CWinApp::EnableShellOpen 允许用户从Windows文件管理器中打开数据文件
void EnableShellOpen();
说明：通常从InitInstace函数的代码中允许程序在文件管理器中双击文件时打开该数据文件
 
CWinApp::ParseCommandLine 分析命令行中的专用参数和标志
void ParseCommandLine(CCommandLineInfo& rCmdInfo);
参数：rCmdInfo 到一个CCommandLineInfo对象的引用
 
CWinApp::RegisterShellFileTypes 用Windows文件管理注册程序所有文档类型
void RegisterShellFileTypes(BOOL bCompat=FALSE);
 
 

本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/chu_qun/archive/2008/09/28/2990546.aspx