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

Класс CMenu используется для работы с дескрипторами HMENU Windows. Он содержит функции для создания, отслеживания, обновления и уничтожения меню. Объект класса CMenu следует локально создавать в стеке. После этого необходимо вызвать функцию CWnd::SetMenu для замены меню в окне и сразу же вызвать функцию CMenu::Detach. Функция CWnd::SetMenu устанавливает в окне новое меню, вызывая его перерисовку для отображения нового меню, а также передает окну права собственности на меню. Функция Detach освобождает дескриптор HMENU из объекта класса CMenu, так что, при уничтожении данного объекта класса CMenu деструктор не попытается уничтожить меню, на которое он уже не имеет права собственности. Само меню уничтожается деструктором окна при его закрытии. Функция LoadMenuIndirect создает меню по шаблону, хранящемуся в памяти, однако, с меню, созданным функцией LoadMenu с использованием ресурсов, намного проще работать, а ресурсы меню могут создаваться и изменяться в редакторе меню. Описание данного класса содержится в файле заголовка afxwin.h.

Если с данным объектом класса CMenu связан идентификатор контекстной справки, возвращает этот идентификатор. В противном случае возвращает нулевое значение.

Данная функция позволяет получить идентификатор контекстной справки, связанный с данным объектом класса CMenu.

Ненулевое, в случае успешного завершения работы, и нулевое в противном случае.

Данная функция связывает идентификатор контекстной справки с объектом класса CMenu. Этот идентификатор разделяют все команды данного меню. Отсутствует возможность назначить идентификатор контекстной справки отдельной команде данного меню.

Класс CMonthCalCtrl используется для работы с элементом управления, содержащим календарь на месяц. Используя интерфейс этого элемента управления пользователь может выбирать любую дату в текущем месяце или перейти к любому месяцу любого года. Для изменения формы отображения пользователь может предпринять следующие действия:

При создании данного элемента управления для него могут быть заданы следующие стили:

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

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

Позволяет получить информацию о системном времени, выделенную в соответствующем элементе управления. Эта функция выполняет те же действия, что и сообщение Win32 MCM_GETCURSEL. При реализации в библиотеке MFC функция SetCurSel может получать информацию не только из объекта структуры SYSTEMTIME, но и из объектов классов COleDateTime и CTime. Если в элементе управления установлен флаг MCS_MULTISELECT выполнение данной функции завершается с ошибкой.

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

Выделяет указанную дату в элементе управления календаря. Эта функция выполняет те же действия, что и сообщение Win32 MCM_SETCURSEL. При реализации в библиотеке MFC функция SetCurSel может получать информацию не только из объекта структуры SYSTEMTIME, но и из объектов классов COleDateTime и CTime.

Класс CObArray представляет собой класс массива указателей на объект класса CObject. Этот массив объектов аналогичен массивам языка C, но способен динамически изменять свой размер.

Индекс первого элемента массива всегда равен 0. Пользователь может зафиксировать верхнюю границу массива или позволить ему расти при добавлении новых элементов, если их индекс превышает его верхнюю границу. Для данного массива всегда выделяется единая область памяти, даже в том случае, когда отдельные его элементы не используются.

При использовании Win32 размер объекта класса CObArray определяется только доступной областью памяти. Как и в случае массивов языка C, время доступа к любому элементу массива CObArray постоянно и не зависит от размера массива.

Класс CObArray включает в себя макрос IMPLEMENT_SERIAL, позволяющий работать с архивом и выводить диагностические сообщения. Если массив указателей на объекты класса CObject сохраняется в архиве, независимо от того используется ли для этого перегруженный оператор << или функция Serialize, то в архиве сохраняется каждый объект класса CObject, для чего вызывается его собственная функция Serialize, и его индекс в массиве.

При необходимости вывести диагностическую информацию об отдельном объекте класса CObject, хранящегося в массиве, необходимо указать глубину объекта CDumpContext равной 1 или большей величине.

При уничтожении объекта класса CObArray или при удалении из него элементов уничтожаются только указатели на объекты класса CObject, а не сами объекты, на которые ссылаются данные указатели.

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

Для работы с архивом необходимо использовать макрос IMPLEMENT_SERIAL для данного класса.

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

Индекс добавленного в массив элемента.

Добавляет новый элемент в конец массива, увеличивая его размер на 1. Если в функции SetSize аргумент nGrowBy имеет значение больше 1 и увеличение размера массива на 1 привело к выходу за пределы отведенной ему памяти, то для массива выделяется дополнительная память, в которую могут быть записаны новые элементы без новой операции выделения памяти, размер которой определяется аргументом nGrowBy функции SetSize. Соответствующие функции, отличающиеся только типом своих аргументов, имеются в классах CByteArray, CDWordArray, CPtrArray, CStringArray, CUIntArray и CWordArray.

Размер массива.

Возвращает размер массива. Поскольку первый элемент массива имеет нулевой индекс, размер массива всегда на 1 превышает максимальный индекс элемента массива. Идентичная функция имеется в классах CByteArray, CDWordArray, CPtrArray, CStringArray, CUIntArray и CWordArray.