部分MFC和API函数(2)

 

CDialog类：所有对话框（模态或非模态）的基类 CDialog::DoModal 激活模态对话框，完成后返回对话框结果 virtual int DoModal(); 返回值：若不可创建对话框，返回-1；若错误返回IOABORT；若用户用“确定”按钮退出对话框，返回IDOK，否则返回IDCANCEL或0 CDocument类：提供用户定义的文档类的基本功能 CDocument::CanCloseFrame 在关闭框架窗口之间由框架调用 virtual BOOL CanCloseFrame(CFrameWnd* pFrame); 参数：pFrame 指向连接到该文档上的一个视的框架窗口 CDocument::SetTitle 指定文档的标题 virtual void SetTitle(LPCTSTR lpszTitle); 参数：lpszTitle指向用作文档标题的字符串 CEdit类：是一个用于编辑控件的类 CEdit::Copy 将编辑控件中的当前选择以CF_TEXT格式拷贝到剪贴板中 void Copy(); CEdit::Cut 剪切编辑控件中所选文本并以CF_TEXT格式拷贝到剪贴板中 void Cut(); CEdit::GetModify 确定控件内容是否修改 BOOL GetModify()const; 返回值：若控件内容已修改，返回非0值，否则返回0。 CEdit::GetSel 获取编辑控件中当前选择的位置 DWORD GetSel()const; void GetSel(int& nStartChar,int& nEndChar)const; 参数：nStartChar用于接收当前选择的第一个字符的位置；nEndChar用于接收当前选择后面第一个未选字符的位置。 返回值：低位字和高位字分别是当前选择开始和选择区后第一个未选字符的位置。 CEdit::Paste 将数据从剪贴板插入到编辑控件中的当前光标处 void Paste(); CEdit::ReplaceSel 用指定的文本替换编辑控件内选择的文本 void ReplaceSel(LPCTSTR lpszNewText,BOOL bCanUndo=FALSE); 参数：lpszNewText指向替换文本的字符串；bCanUndo为TRUE时，指定该操作可以用Undo()撤销 CEdit::SetLimitText 设置CEdit控件可接收文本的最大字节数 void SetLimitText(UINT nMax); 参数：nMax 新文本限制，按字节计。 CEdit::SetModify 设置控件修改标志 void SetModify(BOOL bModified=TRUE); 参数：bModified 为TRUE，指示控件已修改，为FALSE，清除修改标志 CEdit::SetSel 设置编辑控件中选择的字符 void SetSel(DWORD dwSelection,BOOL bNoScroll=FALSE); void SetSel(int nStartChar,int nEndChar,BOOL bNoScroll=FALSE); 参数：dwSelection 若低位字为0而高位字为-1，则选择所有文本；若低位为-1，则撤销当前选择；bNoScroll 为FALSE时插入字符滚入视野，否则插入字符不滚入视野； nStartChar指定选择的起始位置，nEndChar指定选择的终止位置；若nStartChar为0且nEndChar为-1，选择所有文本；若nStartChar为-1，撤销当前选择 CFile类：该类是基本文件类的基类 CFile::Close 关闭文件，使该文件不可用于读写 virtual void Close(); CFile::GetLength 求文件长度（以字节计） virtual DWORD GetLength()const; 返回值：文件长度 CFile::Open 打开文件 virtual BOOL Open(LPCTSTR lpszFileName,UINT nOpenFlags,CFileException* pError=NULL); 参数：lpszFileName指定打开文件的路径；nOpenFlags 定义文件的共享和存取方式；pError指向一个已有的文件异常对象的指针。 nOpenFlags的常用取值： CFile::modeCreate 创建一个新文件，若文件已存在，则该文件被清空； CFile::modeRead 用于只读； CFile::modeReadWrite 用于读写； CFile::modeWrite 用于只写； CFile::modeNoInherit 阻止文件被子进程继承； 返回值：若打开成功，返回非0；否则返回0 CFile::Read 从文件中读一段数据到一缓冲区中 virtual UINT Read(void* lpBuf,UINT nCount); 参数：lpBuf指向用户定义的缓冲区；nCount为要从文件中读出的最大字节数 返回值：传输给缓冲区的字节数，可小于nCount所指定的值 CFile::Rename 重命名文件（静态函数），目录不可重命名 static void PASCAL Rename(LPCTSTR lpszOldName,LPCTSTR lpszNewName); 参数：lpszOldName 旧路径名 lpszNewName 新路径名 CFile::Remove 删除指定文件（静态函数），不可删除目录 static void PASCAL Remove(LPCTSTR lpszFileName); 参数：lpszFileName指向删除文件的路径名字符串 CFile::Seek 定位当前文件指针 virtual LONG Seek(LONG lOff,UINT nFrom); 参数：lOff 指针移动的字节数，为正时，向后移动，为负时，向前移动 nFrom 指针移动方式，可以是下列值之一： CFile::begin 将文件指针从文件头移动lOff个字节； CFile::current 将文件指针从当前位置移动lOff个字节； CFile::end 将文件指针从文件尾移动lOff个字节； CFile::SeekToBegin 将文件指针设置到文件头，相当于Seek(0L,CFile::begin) void SeekToBegin(); CFile::SeekToEnd 将文件指针设置到文件尾，相当于Seek(0L,CFile::end) DWORD SeekToEnd(); 返回值：文件的字节长度 CFile::Write 将数据从一缓冲区写入文件中 virtual void Write(const void* lpBuf,UINT nCount); 参数：lpBuf指向用户定义的缓冲区；nCount为要从缓冲区传输的字节数 CFileDialog类：封装了打开和保存文件的标准对话框 CFileDialog::CFileDialog 构造一个标准Windows文件对话框对象 CFileDialog(BOOL bOpenFileDialog,LPCTSTR lpszDefExt=NULL,LPCTSTR lpszFileName=NULL, DWORD dwFlags=OFN_HIDEREADONLY | OFN_OVERWRITEPROMPT,LPCTSTR lpszFilter=NULL,CWnd* pParentWnd=NULL); 参数：bOpenFileDialog为TRUE时构造打开文件对话框，为FALSE时构造另存为对话框； lpszDefExt指定缺省文件扩展名，在对话框弹出后，若没有在文件名框中输入扩展名，则自动附加指定的扩展名，若lpszDefExt为NULL，则不附加扩展名； lpszFileName指定出现在文件名框中的初始文件名，若为NULL，则无初始文件名； dwFlags为定制对话框的标志组合； lpszFilter指定文件过滤器 CFileDialog::GetFileExt 检取对话框中输入的文件扩展名 CString GetFileExt()const; CFileDialog::GetFileName 检取对话框中输入的文件名，不包括路径 CString GetFileName()const; CFileDialog::GetNextPathName 检取对话框中选定的一组文件中的下一个文件的全路径 CString GetNextPathName(POSITION& pos)const; 参数：pos 指定位置的POSITION值，执行后，为下一项的POSITION值；若已到列表尾，执行后为NULL 返回值：文件的全路径 CFileDialog::GetPathName 检取对话框中输入的文件全路径 CString GetPathName()const; CFileDialog::GetStartPosition 获取列表中第一个文件路径名的位置 POSITION GetStartPosition()const; 返回值：列表中第一个文件路径名的POSITION值；若列表为空，返回NULL 说明：用于多选列表，要求m_ofn.Flags设置了OFN_ALLOWMULTISELECT标志 CFindReplaceDialog类：封装了标准查找/替换对话框 CFindReplaceDialog::Create 创建一个Find或Find/Replace对话框对象 BOOL Create(BOOL bFindDialogOnly,LPCTSTR lpszFindWhat,LPCTSTR lpszReplaceWhat=NULL,DWORD dwFlag=FR_DOWN，CWnd* pParentWnd=NULL); 参数：bFindDialogOnly 为TRUE时，显示查找对话框，为FALSE时，显示查找/替换对话框； lpszFindWhat 指定要查找的串的缺省值； lpszReplaceWhat 指定替换串的缺省值； dwFlag为标志位，用来定制对话框，它可以是一个或多个标志的组合，主要取值如下： FR_DOWN 如果设置，对话框中的“向下查找”单选按钮被选中，如果没有设置，“向上查找”单选按钮被选中； FR_HIDEUPDOWN 不显示查找方向单选按钮； FR_HIDEMATCHCASE 不显示区分大小写复选按钮； FR_HIDEWHOLEWORD 不显示全字匹配复选按钮； FR_MATCHCASE 使区分大小写复选按钮处于选中状态； FR_WHOLEWORD 使全字匹配复选按钮处于选中状态； FR_NOMATCHCASE 使区分大小写复选按钮处于禁止（变灰）状态； FR_NOUPDOWN 使查找方向单选按钮处于禁止（变灰）状态； FR_NOWHOLEWORD 使全字匹配复选按钮处于禁止（变灰）状态； FR_SHOWHELP 在对话框中显示一个帮助按钮。 pParentWnd 指向父窗口或属主窗口的指针。 返回值：若创建成功，返回非0值，否则返回0。 CFindReplaceDialog::FindNext 确定用户是否要查找串的下一个出现处 BOOL FindNext()const; 返回值：若用户单击查找“下一个”按钮，则返回非0值，否则返回0。 CFindReplaceDialog::GetFindString 检取对话框中的查找字符串 CString GetFindString()const; 返回值：对话框中的查找字符串 CFindReplaceDialog::GetNotifier 检取当前查找/替换对话框的指针 static CFindReplaceDialog* PASCAL GetNotifier(LPARAM lParam); 参数：lParam 传递给回调函数OnFindReplace()的lParam值 返回值：指向当前查找/替换对话框的指针 CFindReplaceDialog::GetReplaceString 检取对话框中的替换字符串 CString GetReplaceString()const; 返回值：对话框中的替换字符串 CFindReplaceDialog::IsTerminating 检取对话框是否终止 BOOL IsTerminating()const; 返回值：若用户终止对话框，返回非0值，否则返回0 CFindReplaceDialog::MatchCase 检取区分大小写复选按钮状态 BOOL MatchCase()const; 返回值：如果区分大小写复选按钮被选择，返回非0值，否则返回0 CFindReplaceDialog::MatchWholeWord 检取全字匹配复选按钮状态 BOOL MatchWholeWord()const; 返回值：如果全字匹配复选按钮被选择，返回非0值，否则返回0 CFindReplaceDialog::ReplaceAll 确定用户是否要求全部替换 BOOL ReplaceAll()const; 返回值：如果用户要求全部替换，返回非0值，否则返回0 CFindReplaceDialog::ReplaceCurrent 确定用户是否要求替换当前选择串 BOOL ReplaceCurrent()const; 返回值：如果用户要求替换当前选择串，返回非0值，否则返回0 CFindReplaceDialog::SearchDown 检取查找方向 BOOL SearchDown()const; 返回值：如果为向下查找，返回非0值；若为向上查找，返回0 CFont类：封装了Windows图形设备接口(GDI)中的字体对象 CFont::CreatePointFont 创建指定打印字样和点大小的字体 BOOL CreatePointFont(int nPointSize,LPCTSTR lpszFaceName,CDC*pDC==NULL); 参数：nPointSize 请求字体的高度（以十分之一点计）；lpszFaceName 字体的字样名 返回值：若成功，返回非0；否则返回0 CFontDialog类：封装了字体选择对话框 CFontDialog::CFontDialog 构造一个CFontDialog对象 CFontDialog(LPLOGFONT lplfInitial=NULL,DWORD dwFlags=CF_EFFECTS | CF_SCREENFONTS,CDC* pdcPrinter=NULL,CWnd* pParentWnd=NULL); 参数：lplfInitial是一个指向LOGFONT结构的指针；dwFlags一些标志；pdcPrinter指向打印机设备环境的指针；pParentWnd指向该字体对话框的父窗口的指针 CFontDialog::GetFaceName 获取选定的字体名 CString GetFaceName()const; CFontDialog::GetSize 获取选定的字体大小 int GetSize()const;