CBitmap::GetBitmapBits

DWORD GetBitmapBits( DWORD dwCount, LPVOID lpBits ) const;

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

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

Аргументы

0. dwCount — определяет количество байт, которые необходимо скопировать.

1. lpBits — указатель на буфер, в который будет записан битовый образ. Битовый образ представляет собой байтовый массив. Хранение информации производится по линиям горизонтальной развёртки, для хранения которых используются 16-битные структуры. Поэтому, если битовый образ содержит нечётное количество столбцов, и для хранения информации о цвете каждого из элементов изображения используется нечётное количество байт, объём памяти, необходимый для хранения одной строки горизонтальной развёртки будет на один байт превышать её действительный размер.

Примечание

Копирует битовый образ из объекта класса CBitmap в буфер, на который указывает аргумент lpBits. Аргумент dwCount определяет количество байт, которое необходимо скопировать в данный буфер. Для определения корректного значения аргумента dwCount следует вызывать функцию CGdiObject::GetObject для данного объекта класса битового образа.

CBitmap::SetBitmapBits

DWORD SetBitmapBits( DWORD dwCount, const void* lpBits );

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

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

Аргументы

0. dwCount — определяет количество байт, которые необходимо скопировать.

1. lpBits — указатель на область в оперативной памяти, из которой следует скопировать битовый образ в объект класса CBitmap.

Примечание

Присваивает битам в битовом образе значения, содержащиеся в массиве lpBits.

CCmdUI

Класс CCmdUI используется в функциях обработки сообщения ON_UPDATE_COMMAND_UI в классах, производных от класса CCmdTarget.

Когда пользователь раскрывает меню в своём приложении, приложение должно определить состояние каждой его команды, каждая их которых может быть доступной или недоступной. Эта информация предоставляется функциями обработки сообщения ON_UPDATE_COMMAND_UI. Прототипы этих функций и соответствующие им макросы карты сообщений могут быть созданы с использованием мастера ClassWizard.

При раскрытии меню приложение ищет и вызывает функции обработки сообщения ON_UPDATE_COMMAND_UI, передавая им в качестве аргумента объект класса CCmdUI. Пользователь вызывает для данного объекта такие функции, как Enable или Check, позволяющие приложению правильно установить состояние для каждой команды меню.

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

В таблице чч.2 содержатся сведения о реакции отдельных элементов управления на вызов функций-членов класса CCmdUI.

Таблица чч.2. Воздействие функций класса CCmdUI на отдельные элементы управления

Элемент управления	Enable	SetCheck	SetRadio	SetText
Команда меню	Делает доступной или недоступной	Устанавливает или снимает флажок (v)	Устанавливает или снимает переключатель (.)	Устанавливает текст элемента управления
Кнопка панели инструментов	Делает доступной или недоступной	Выделяет, снимает выделение или переводит в неопределённое состояние	Работает аналогично функции SetCheck	Не используется
Панель строки состояния	Делает текст видимым или невидимым	Устанавливает выступающую или нормальную рамку	Работает аналогично функции SetCheck	Устанавливает текст в панели
Обычная кнопка в CDialogBar	Делает доступной или недоступной	Устанавливает или снимает флажок	Работает аналогично функции SetCheck	Устанавливает текст в кнопке
Обычный элемент управления в CDialogBar	Делает доступной или недоступной	Не используется	Не используется	Устанавливает текст окна

Класс CCmdUI не имеет базового класса.

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