Visual C++. Описание стандартных классов
Страница 20.


 
SetFinishText
void SetFinishText(LPCTSTR lpszText);
Аргументы
"sectiontableheader"lpszText - указатель на строку, отображаемую в кнопке Готово.
Описание
Данная функция вызывается для задания текста, отображаемого в кнопке Готово после завершения работы пользователя с окном мастера. Кроме отображения заданного теста данная функция убирает из диалогового окна кнопку <Назад.
SetWizardButtons
void SetWizardButtons(DWORD dwFlags);
Аргументы
"sectiontableheader"dwFlags - набор флагов, определяющих набор кнопок, используемых в мастере и их доступность. Этот аргумент может представлять собой комбинацию следующих значений:
"sectiontableheader"PSWIZB_BACK - доступна кнопка <Назад;
"sectiontableheader"PSWIZB_NEXT - доступна кнопка Далее>;
"sectiontableheader"PSWIZB_FINISH - присутствует кнопка Готово;
"sectiontableheader"PSWIZB_DISABLEDFINISH - кнопка Готово недоступна.
Описание
Данная функция вызывается для того, чтобы сделать доступными или недоступными кнопки <Назад, Далее> и Готово в диалоговом окне мастера. Функция SetWizardButtons может вызываться только в открытом диалоговом окне: ее нельзя вызывать до вызова функции DoModal. Обычно она вызывается в функции CPropertyPage::OnSetActive. Чтобы изменить текст в кнопке Готово и скрыть кнопки Далее> и <Назад, вызовите функцию SetFinishText. Поскольку кнопки Готово и Далее> разделяют одну и ту же физическую кнопку, они не могут отображаться одновременно. Кнопка Готово имеет приоритет и будет отображаться, если задано отображение сразу обеих кнопок.
SetWizardMode
void SetWizardMode();
Описание
Данная функция вызывается для установления режима отображения вкладок в стиле мастера. Основными отличительными особенностями отображения вкладок в режиме мастера является использование для перехода от одной вкладки к другой кнопок Далее>, <Назад, Готово и Отмена вместо ярлыков вкладок. Функция SetWizardMode вызывается перед функцией DoModal. После этого функция DoModal возвращает одно из значений: ID_WIZFINISH (если для закрытия диалогового окна использовалась кнопка Готово) или IDCANCEL (если для закрытия диалогового окна использовалась кнопка Отмена). Данная функция устанавливает флаг PSF_WIZARD.
CRect
Класс CRect во многом аналогичен структуре RECT, определенной в операционной системе Windows. Класс CRect включает в себя функции для работы с объектами данного класса и структуры RECT. Объекты класса CRect могут использоваться в аргументах функций вместо объектов структуры RECT, а также вместо указателей LPCRECT или LPRECT.
Данный класс является производным от структуры tagRECT (имя tagRECT является менее распространенным именем для структуры RECT). Это означает, что переменные left, top, right и bottom структуры RECT являются доступными членами класса CRect. Объект класса CRect содержит переменные для задания левого верхнего и правого нижнего углов прямоугольника.
При создании объекта класса CRect необходимо убедиться в том, что задаваемые координаты прямоугольника нормализованы, то есть координата left меньше координаты right, а координата top меньше координаты bottom. Например, координаты левого верхнего угла (10,10) и координаты правого нижнего угла (20,20) задают нормализованный прямоугольник, а координаты левого верхнего угла (20,20) и координаты правого нижнего угла (10,10) задают ненормализованный прямоугольник. Если прямоугольник не нормализован, то многие функции класса CRect могут возвращать неправильные результаты. Список этих функций приведен при описании функции NormalizeRect. Перед вызовом данных функций необходимо вызвать функцию NormalizeRect, нормализующую объект своего класса.
При использовании объектов класса CRect в функциях CDC::DPtoLP и CDC::LPtoDP следует соблюдать осторожность. Если используемый режим отображения предполагает использование отрицательных вертикальных координат, как это имеет место в режиме отображения MM_LOENGLISH, то функция CDC::DPtoLP преобразует объект класса CRect таким образом, что его координата top будет иметь большее значение, чем координата bottom. Это приведет к тому, что функции Height и Size будут возвращать отрицательные значения высоты преобразованного объект класса CRect и данный прямоугольник станет ненормализованным.
При перегрузке операторов класса CRect первым операндом должен быть объект класса CRect, а вторым - объект структуры RECT или объект класса CRect.
Описание данного класса содержится в файле заголовка afxwin.h.
PtInRect
BOOL PtInRect(POINT point) const;
Возвращаемое значение
Ненулевое, если данная точка лежит в пределах прямоугольника, описываемого объектом класса CRect, и нулевое в противном случае.
Аргументы
"sectiontableheader"point - объект структуры POINT или объект класса CPoint, положение которого требуется оценить.
Описание
Определяет, лежит ли данная точка в пределах прямоугольника, описываемого объектом класса CRect. Точка считается лежащей в пределах прямоугольника, описываемого объектом класса CRect, если она лежит на его левой или верхней стороне или находится внутри него. Точка, лежащая на правой или нижней сторонах данного прямоугольника считается находящейся за его пределами. Для нормальной работы данной функции прямоугольник должен быть нормализован. Для нормализации прямоугольника необходимо вызвать функцию NormalizeRect до вызова данной функции.
CRgn
Класс CRgn содержит методы для работы с областями окон Windows с использованием интерфейса графических устройств. Область может иметь эллиптическую или прямоугольную форму. Для работы с областями окон совместно используются функции-члены класса CRgn и функции отсечения неотображаемых фрагментов класса CDC. Функции класса CRgn позволяют создавать, изменять и получать информацию об областях окон Windows. Описание данного класса содержится в файле заголовка afxwin.h.
CreateRectRgnIndirect
BOOL CreateRectRgnIndirect(LPCRECT lpRect);
Возвращаемое значение
Ненулевое, в случае успешного завершения операции, и ноль в противном случае.
Аргументы
"sectiontableheader"lpRect - указатель на объект структуры RECT или объект класса CRect, содержащий логические координаты левого верхнего и правого нижнего углов данной области.
Описание
Создает прямоугольную область и сохраняет ее в объекте класса CRgn. Размер области ограничен размером его сторон, каждая из которых не может превышать 32767 логических единиц, и объемом используемой данным объектом памяти, который не может превышать 64 КБ. По окончании использования объекта класса CRgn, созданного функцией CreateRectRgnIndirect, приложение должно использовать функцию CGDIObject::DeleteObject для его удаления.
CRichEditView
Расширенное текстовое поле представляет собой окно, в котором пользователь может редактировать текст. Для вывода текста в данном окне могут быть использованы различные шрифты, введенный текст может форматироваться и в него могут включаться различные объекты OLE. Хотя расширенное текстовое поле и позволяет осуществлять форматирование текста, однако все необходимые для этого элементы пользовательского интерфейса должны быть созданы самим пользователем.
Класс CRichEditView, совместно с классами CRichEditDoc и CRichEditCntrItem, обеспечивают функционирование элемента управления расширенное текстовое поле в рамках заложенной в основу библиотеки MFC концепции документ/представление. Класс CRichEditView содержит методы для редактирования и форматирования текста. Класс CRichEditDoc позволяет работать со списками клиентов OLE используемыми в приложении. Класс CRichEditCntrItem обеспечивает доступ к клиентам OLE со стороны контейнера.
Использование расширенного текстового поля (а следовательно и объектов класса CRichEditCtrl и связанных с ним классов) возможно только при работе под управлением операционной системы Windows 95 или Windows NT версии 3.51 или более поздних версий данных операционных систем.
Описание данного класса содержится в файле заголовка afxrich.h.
GetCharFormatSelection
CHARFORMAT2& GetCharFormatSelection();
Возвращаемое значение
Объект структуры CHARFORMAT2, содержащий текущие атрибуты форматирования выделенного участка текста.
Описание
Данная функция позволяет получить текущие атрибуты форматирования выделенного участка текста.
Хотя в библиотеке MSDN указано, что данная функция возвращает объект структуры CHARFORMAT, при попытке запомнить его в объекте данной структуры компилятор выдает сообщение о невозможности преобразования объекта структуры CHARFORMAT2 в объект структуры CHARFORMAT.
OnCharEffect
void OnCharEffect(DWORD dwMask, DWORD dwEffect);
Аргументы
"sectiontableheader"dwMask - определяет параметры форматирования шрифтов, подлежащие изменению. Может представлять собой комбинацию следующих значений:
"sectiontableheader"CFM_BOLD - используется значение флага CFE_BOLD в аргументе dwEffects;
"sectiontableheader"CFM_COLOR - используется значение флага CFE_AUTOCOLOR в аргументе dwEffects;
"sectiontableheader"CFM_ITALIC - используется значение флага CFE_ITALIC в аргументе dwEffects;
"sectiontableheader"CFM_PROTECTED - используется значение флага CFE_PROTECTED в аргументе dwEffects;
"sectiontableheader"CFM_STRIKEOUT - используется значение флага CFE_STRIKEOUT в аргументе dwEffects;
"sectiontableheader"CFM_UNDERLINE - используется значение флага CFE_UNDERLINE в аргументе dwEffects.
"sectiontableheader"dwEffect - содержит список операций форматирования. Может представлять собой комбинацию следующих значений:
"sectiontableheader"CFE_AUTOCOLOR - цвет текста принимает значение, возвращаемое функцией GetSysColor (COLOR_WINDOWTEXT);
"sectiontableheader"CFE_BOLD - текст отображается жирным шрифтом;
"sectiontableheader"CFE_ITALIC - текст отображается курсивом;
"sectiontableheader"CFE_STRIKEOUT - производится зачеркивание текста;
"sectiontableheader"CFE_UNDERLINE - производится подчеркивание текста;
"sectiontableheader"CFE_PROTECTED - устанавливается запрет на внесение изменений в параметры шрифта. При попытке внесения в него изменений посылается сообщение EN_PROTECTED.
Описание
Данная функция позволяет изменять формат символов в выделенном тексте.
 
« Предыдущая статья   Следующая статья »