CObArray::SetSize

void SetSize( int nNewSize, int nGrowBy = -1 ); throw( CMemoryException );

Аргументы

0. nNewSize — новый размер массива (количество элементов). Должен иметь значение большее или равное 0.

1. nGrowBy — минимальное количество элементов, на которое будет увеличен размер массива при необходимости.

Примечание

Устанавливает размер пустого или существующего массива. Выделяет память в случае необходимости. Если новый размер массива меньше его прежнего размера, то массив усекается и вся неиспользуемая память освобождается. Для повышения производительности приложений, использующих массив, необходимо вызвать функцию SetSize до начала работы с ним. Правильный выбор её аргументов позволит исключить или существенно уменьшить объём операций по перераспределению памяти и копирования массива при добавлении к нему элементов.

Аргумент nGrowBy влияет только на распределение памяти при увеличении размеров массива. Его значение никак не отражается на возвращаемых значениях функций GetSize и GetUpperBound.

Идентичная функция имеется в классах CByteArray, CDWordArray, CPtrArray, CStringArray, CUIntArray è CWordArray.

CPropertyPage

Объект класса CPropertyPage представляет собой отдельную страницу окна свойств, иначе называемую вкладкой диалогового окна. Как и для стандартного диалогового окна, для каждой его вкладки необходимо создать отдельный класс, производный от класса CPropertyPage. Чтобы использовать объекты данного класса, необходимо сначала создать объект класса CPropertySheet, а затем включить в него объекты классов всех составляющих его вкладок. Чтобы добавить в диалоговое окно новую вкладку, необходимо вызвать для объекта её класса функцию CPropertySheet::AddPage, а затем вывести это диалоговое окно на экран, вызвав функцию CPropertySheet::DoModal для модального диалогового окна или CPropertySheet::Create для немодального диалогового окна.

Данное диалоговое окно может быть оформлено в стиле мастера, в котором диалоговое окно представляет собой последовательность вкладок, перемещение по которым происходит в определённой последовательности и управляется специальными кнопками в диалоговом окне. Такой тип окна часто применяется для установки программ и оборудования.

Описание данного класса содержится в файле заголовка afxdlgs.h.

CPropertyPage::OnSetActive

virtual BOOL OnSetActive( );

Возвращаемое значение

Ненулевое, если вкладка успешно активизировалась, и нулевое в противном случае.

Примечание

Данная функция вызывается приложением при выборе данной вкладки пользователем. Перегрузка данной функции позволяет произвести инициализацию содержащихся в ней объектов классов элементов управления. Первым оператором перегруженной функции должен быть вызов соответствующего метода базового класса.

По умолчанию данная функция создаёт окно для данной вкладки, если оно уже не было создано ранее, и делает эту вкладку активной.

CPropertyPage::OnWizardBack

virtual LRESULT OnWizardBack();

Возвращаемое значение

Нулевое, для успешного перехода к предыдущей странице, и -1 для предотвращения перехода. Чтобы перейти к произвольной станице, возвратите идентификатор диалогового окна, которое необходимо вывести на экран.

Примечание

Данная функция вызывается приложением при нажатии пользователя на кнопку <Назад в окне мастера. Перегрузка данной функции позволяет определить некоторые действия, которые необходимо предпринять при возврате к предыдущей странице.