Класс COleControl

Статья
02/20/2013

Мощный базовый класс для разработки OLE элементы управления.

class COleControl : public CWnd

Члены

Открытые конструкторы

Имя	Описание
COleControl::COleControl	Создает объект COleControl.

Открытые методы

Имя	Описание
COleControl::AmbientAppearance	Извлекает текущий вид элемента управления.
COleControl::AmbientBackColor	Возвращает значение внешнего свойства BackColor.
COleControl::AmbientDisplayName	Возвращает имя элемента управления в соответствии с контейнером.
COleControl::AmbientFont	Возвращает значение внешнего свойства шрифта.
COleControl::AmbientForeColor	Возвращает значение внешнего свойства ForeColor.
COleControl::AmbientLocaleID	Возвращает идентификатор языкового стандарта контейнера
COleControl::AmbientScaleUnits	Возвращает тип единиц, используемых контейнером.
COleControl::AmbientShowGrabHandles	Определяет, ручки должны отображаться.
COleControl::AmbientShowHatching	Определяет, штриховкой должен отображаться.
COleControl::AmbientTextAlign	Возвращает тип выравнивания текста указанным контейнером.
COleControl::AmbientUIDead	Определяет, если элемент управления должен отвечать на действия интерфейса пользователя.
COleControl::AmbientUserMode	Указывает режим контейнера.
COleControl::BoundPropertyChanged	Уведомляет контейнер, что связанное свойство было изменен.
COleControl::BoundPropertyRequestEdit	Запрашивает разрешение на изменение значения свойства.
COleControl::ClientToParent	Преобразует точку относительно начала координат элемента управления в точку относительно начала координат его контейнера.
COleControl::ClipCaretRect	Обрабатывает прямоугольник курсора, если он перекрывающиеся элементом управления.
COleControl::ControlInfoChanged	Эта функция вызывается после набора мнемоник обращанных элементом управления изменяется.
COleControl::DisplayError	События ошибок отображает резервирование пользователю элемента управления.
COleControl::DoClick	Реализация метода DoClick стандартное.
COleControl::DoPropExchange	Сериализует свойства объекта COleControl.
COleControl::DoSuperclassPaint	Перерисовывает элемент OLE управления, который был subclassed из элемента управления Windows.
COleControl::EnableSimpleFrame	Содержит простую поддержку фрейма для элемента управления.
COleControl::ExchangeExtent	Сериализует ширину и высоту элемента управления.
COleControl::ExchangeStockProps	Сериализует стандартные свойства элемента управления.
COleControl::ExchangeVersion	Сериализует номер версии элемента управления.
COleControl::FireClick	Вызывает событие Click стандартное.
COleControl::FireDblClick	Вызывает событие DblClick стандартное.
COleControl::FireError	Вызывает событие Error стандартное.
COleControl::FireEvent	Вызывает пользовательское событие.
COleControl::FireKeyDown	Вызывает событие KeyDown стандартное.
COleControl::FireKeyPress	Вызывает событие KeyPress стандартное.
COleControl::FireKeyUp	Вызывает событие KeyUp стандартное.
COleControl::FireMouseDown	Вызывает событие MouseDown стандартное.
COleControl::FireMouseMove	Вызывает событие MouseMove стандартное.
COleControl::FireMouseUp	Вызывает событие MouseUp стандартное.
COleControl::FireReadyStateChange	Вызывает событие при изменении состояния готово элемента управления.
COleControl::GetActivationPolicy	Изменяет по умолчанию расширения функциональности активации элемента управления, поддерживающего интерфейс IPointerInactive.
COleControl::GetAmbientProperty	Возвращает значение указанного внешнего свойства.
COleControl::GetAppearance	Возвращает значение свойства внешнего вида стандартное.
COleControl::GetBackColor	Возвращает значение свойства BackColor стандартное.
COleControl::GetBorderStyle	Возвращает значение свойства BorderStyle стандартное.
COleControl::GetCapture	Определяет, имеет ли безоконный, активированный объект элемента управления захват мыши.
COleControl::GetClassID	Извлекает OLE идентификатор класса элемента управления.
COleControl::GetClientOffset	Возвращает разницу между верхним левым углом прямоугольной области элемента управления и верхним левым углом клиентской области.
COleControl::GetClientRect	Возвращает размер клиентской области элемента управления.
COleControl::GetClientSite	Запрашивает объект для указателя на свой текущий сайту клиента в пределах своего контейнера.
COleControl::GetControlFlags	Возвращает параметры пометить элемента управления.
COleControl::GetControlSize	Возвращает расположение и размер элемента управления OLE.
COleControl::GetDC	Предоставляет середины для безоконного элемента управления получить контекст устройства из своего контейнера.
COleControl::GetEnabled	Возвращает значение свойства включено запасом.
COleControl::GetExtendedControl	Извлекает указатель на объект выдвинутому управления, принадлежащие к контейнеру.
COleControl::GetFocus	Указывает, установлен ли на элементе управления фокус.
COleControl::GetFont	Возвращает значение свойства шрифта стандартное.
COleControl::GetFontTextMetrics	Возвращает метрики объекта CFontHolder.
COleControl::GetForeColor	Возвращает значение свойства ForeColor стандартное.
COleControl::GetHwnd	Возвращает значение свойства hWnd стандартное.
COleControl::GetMessageString	Содержит текст строки состояния для пункта меню.
COleControl::GetNotSupported	Предотвращает доступ к значению свойства элемента управления пользователем.
COleControl::GetReadyState	Возвращает состояние готовности к элемента управления.
COleControl::GetRectInContainer	Возвращает прямоугольник для элемента управления относительно его контейнер.
COleControl::GetStockTextMetrics	Возвращает метрики свойства шрифта стандартное.
COleControl::GetText	Возвращает значение свойства текста или заголовка стандартное.
COleControl::GetWindowlessDropTarget	Переопределение для разрешения безоконный элемент управления, чтобы быть целевым объектом перетаскивания и удаление операций.
COleControl::InitializeIIDs	Предоставляет базовый класс IIDs элемент управления будет использоваться.
COleControl::InternalGetFont	Возвращает объект CFontHolder для стандартных свойств шрифта.
COleControl::InternalGetText	Извлекает свойство заголовка и тела стандартное.
COleControl::InternalSetReadyState	Устанавливает состояние готовности к элемента управления и вызывает событие готов-состояние- изменения.
COleControl::InvalidateControl	Делает недействительной область элемента управления, отображаемого, поэтому она перерисовать.
COleControl::InvalidateRgn	Делает недействительной клиентская область окна контейнера в заданной области.Может использоваться для перерисовывать безоконные элементы управления в область.
COleControl::IsConvertingVBX	Разрешает OLE специализировало загрузку элемента управления.
COleControl::IsModified	Определяет, если состояние элемента управления изменилось.
COleControl::IsOptimizedDraw	Указывает, поддерживает ли контейнер оптимизированного документ для текущей операции рисования.
COleControl::IsSubclassedControl	Вызванный, чтобы определить, что подклассы элемента управления Windows.
COleControl::Load	Сбросить все предыдущие асинхронные данные и начинает новую загрузку свойств элемента управления асинхронной.
COleControl::LockInPlaceActive	Определяет, если элемент управления может быть отключен контейнером.
COleControl::OnAmbientPropertyChange	Вызываемый при изменен внешнее свойство.
COleControl::OnAppearanceChanged	Вызываемый при изменен стандартное свойство вид.
COleControl::OnBackColorChanged	Если свойству BackColor с именем биржевых изменен.
COleControl::OnBorderStyleChanged	Вызываемый, когда свойства BorderStyle акций изменен.
COleControl::OnClick	Вызванный, чтобы создать событие click стандартное.
COleControl::OnClose	Уведомляет элемент управления, что IOleControl::Close было вызываются.
COleControl::OnDoVerb	Вызываемый после того как команда элемента управления была исполнена.
COleControl::OnDraw	Вызываемый, когда поставлена о необходимости перерисовки элемента управления.
COleControl::OnDrawMetafile	Вызванный контейнером при будет предложено о необходимости перерисовки элемента управления, используя контекст устройства метафайла.
COleControl::OnEdit	Активировать размещенные с контейнером для пользовательского интерфейса OLE элемент управления.
COleControl::OnEnabledChanged	Если свойство включено изменен с запасом.
COleControl::OnEnumVerbs	Вызванный контейнером для перечисления команды элемента управления.
COleControl::OnEventAdvise	Вызываемый при подключены обработчики событий или отключен от элемента управления.
COleControl::OnFontChanged	Вызываемый при изменен стандартное свойство шрифта.
COleControl::OnForeColorChanged	Если для свойства ForeColor акций с именем изменен.
COleControl::OnFreezeEvents	Вызываемый при заморозитьы или unfrozen события элемента управления.
COleControl::OnGetColorSet	Уведомляет элемент управления, что IOleObject::GetColorSet было вызываются.
COleControl::OnGetControlInfo	Предоставляет сведения mnemonic контейнер.
COleControl::OnGetDisplayString	Вызываемый для получения строки для представления значения свойства.
COleControl::OnGetInPlaceMenu	Запрашивает маркер меню элемента управления, которое будет объединитьо с меню контейнера.
COleControl::OnGetNaturalExtent	Переопределение для получения размер отображения элемента управления, ближайший к предложенному режим изменения размера and extents.
COleControl::OnGetPredefinedStrings	Возвращает шнуруют представляющие возможные значения для свойства.
COleControl::OnGetPredefinedValue	Возвращает значение, соответствующее предопределенной строке.
COleControl::OnGetViewExtent	Переопределение для получения размер областей отображения элемента управления (могут использоваться для включения двух траекторный документ).
COleControl::OnGetViewRect	Переопределение для преобразования размер элемента управления в прямоугольник, начиная с указанной позиции.
COleControl::OnGetViewStatus	Переопределение для восстановления состояния представления элемента управления.
COleControl::OnHideToolBars	Вызванный контейнером при выключенный элемент управления пользовательского интерфейса.
COleControl::OnInactiveMouseMove	Переопределение иметь контейнер для неактивного элемента управления с сообщениями WM_MOUSEMOVE диспетчера указателя мыши на элемент управления.
COleControl::OnInactiveSetCursor	Переопределение иметь контейнер для неактивного элемента управления с сообщениями WM_SETCURSOR диспетчера указателя мыши на элемент управления.
COleControl::OnKeyDownEvent	Вызываемый после события KeyDown резервирование было инициировано.
COleControl::OnKeyPressEvent	Вызываемый после события KeyPress резервирование было инициировано.
COleControl::OnKeyUpEvent	Вызываемый после того, как событие KeyUp резервирование было инициировано.
COleControl::OnMapPropertyToPage	Указывает, страница свойств, используемый для редактирования свойства.
COleControl::OnMnemonic	Вызываемый, когда был нажат mnemonic ключ элемента управления.
COleControl::OnProperties	Вызываемый, когда вызвана команда "свойства" элемента управления.
COleControl::OnQueryHitPoint	Переопределение для запроса, перекрывается ли отображение элемента управления заданную точку.
COleControl::OnQueryHitRect	Переопределение для запроса, перекрывается ли отображение элемента управления любую точку в заданном прямоугольнике.
COleControl::OnRenderData	Вызываемый платформой для получения данных в указанном формате.
COleControl::OnRenderFileData	Вызываемый платформой для извлечения данных из файлов в указанном формате.
COleControl::OnRenderGlobalData	Вызываемый платформой для получения данных из глобальной памяти в указанном формате.
COleControl::OnResetState	Сбросить свойства элемента управления значения по умолчанию.
COleControl::OnSetClientSite	Уведомляет элемент управления, что IOleControl::SetClientSite было вызываются.
COleControl::OnSetData	Заменяет контрольна данные с другим значением.
COleControl::OnSetExtent	Вызываемый после области элемента управления изменяется.
COleControl::OnSetObjectRects	Вызываемый после того, как были изменены размеры элемента управления.
COleControl::OnShowToolBars	Вызываемый, когда элемент управления активированный пользовательский интерфейс.
COleControl::OnTextChanged	Вызываемый при изменен свойство текста или заголовка стандартное.
COleControl::OnWindowlessMessage	Сообщения окна процессов (за исключением сообщений мыши и клавиатуры) для безоконных элементов управления.
COleControl::ParentToClient	Преобразует точку относительно начала координат контейнера до точки относительно начала координат элемента управления.
COleControl::PostModalDialog	Уведомляет контейнер, что модальное диалоговое окно было закрыто.
COleControl::PreModalDialog	Уведомляет контейнер, что модальное диалоговое окно будет отображаться.
COleControl::RecreateControlWindow	Удаляет и воссоздает окно элемента управления.
COleControl::Refresh	Вызывает принудительное обновление внешнего вида элемента управления.
COleControl::ReleaseCapture	Захват мыши выпусков.
COleControl::ReleaseDC	Освобождает дисплейного контекст устройства контейнера безоконного элемента управления.
COleControl::ReparentControlWindow	Сбросить родительского окна элемента управления.
COleControl::ResetStockProps	Инициализирует COleControl стандартные свойства с их значениями по умолчанию.
COleControl::ResetVersion	Инициализирует номер версии на заданное значение.
COleControl::ScrollWindow	Позволяет безоконный элемент управления прокрутку область в пределах своего завершения образа в- размещения активного на экране.
COleControl::SelectFontObject	Выберите свойство пользовательского шрифта в контекст устройства.
COleControl::SelectStockFont	Выберите свойство шрифта акций в контекст устройства.
COleControl::SerializeExtent	Сериализует или инициализирует место отображения для элемента управления.
COleControl::SerializeStockProps	Сериализует или инициализирует COleControl стандартные свойства.
COleControl::SerializeVersion	Сериализует или инициализирует сведения о версии элемента управления.
COleControl::SetAppearance	Присваивает значение свойства внешнего вида стандартное.
COleControl::SetBackColor	Присваивает значение свойства BackColor стандартное.
COleControl::SetBorderStyle	Присваивает значение свойства BorderStyle стандартное.
COleControl::SetCapture	Вызывает окно контейнера элемента управления стать владельцем захвата мыши на имени элемента управления.
COleControl::SetControlSize	Задает положение и размер элемента управления OLE.
COleControl::SetEnabled	Присваивает значение свойства включено запасом.
COleControl::SetFocus	Вызывает окно контейнера элемента управления стать владельцем фокуса ввода от имени элемента управления.
COleControl::SetFont	Присваивает значение свойства шрифта стандартное.
COleControl::SetForeColor	Присваивает значение свойства ForeColor стандартное.
COleControl::SetInitialSize	Задает размер элемента управления при первом OLE, показанный в контейнере.
COleControl::SetModifiedFlag	Изменяет измененное состояние элемента управления.
COleControl::SetNotPermitted	Указывает, что запрос правки терпел ошибкой.
COleControl::SetNotSupported	Предотвращает изменение свойства элемента управления пользователем.
COleControl::SetRectInContainer	Задает прямоугольник элемента управления относительно его контейнер.
COleControl::SetText	Присваивает значение свойства текста или заголовка стандартное.
COleControl::ThrowError	Сообщает, что произошла ошибка OLE в элементе управления.
COleControl::TransformCoords	Преобразовывает значения координат между контейнером и элементом управления.
COleControl::TranslateColor	Преобразует значение в значение OLE_COLORCOLORREF.
COleControl::WillAmbientsBeValidDuringLoad	Определяет, будут ли внешние свойства доступны при следующем запуске элемента управления будут загружаться.
COleControl::WindowProc	Предоставляет процедуру Windows для объекта COleControl.

Защищенные методы

Имя	Описание
COleControl::DrawContent	Вызываемый платформой, если представление элемента управления необходимо обновить.
COleControl::DrawMetafile	Вызываемый платформой, если используется контекст устройства метафайла.
COleControl::IsInvokeAllowed	Включает вызов метода автоматизации.
COleControl::SetInitialDataFormats	Вызываемый платформой для инициализации список форматов данных, поддерживаемых элементом управления.

Заметки

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

OLE элементы управления можно вставить в приложение OLE-контейнер и взаимодействия с контейнером с помощью системы включения двусторонней событий и методов и свойств в контейнер.Обратите внимание, что стандартные OLE-контейнер поддерживают только базовую функциональность OLE элемента управления.Они не могут поддерживать расширенные функции OLE элемента управления.Включение событий возникает, когда события отправлены к контейнеру в результате некоторых действий, осуществляя в элементе управления.В свою очередь, контейнер взаимодействует с элементом управления с помощью набора методов и свойств, предоставляемого аналогичные в функции-членам и элементам данных C++ классифицируют.Такой подход позволяет разработчику управлять внешний вид элемента управления и уведомления контейнер, когда некоторые действия.

Безоконные элементы управления

OLE элементы управления могут использоваться отдельно активным в- размещения без окна.Безоконные элементы управления имеют значительные преимущества:

Безоконные элементы управления могут быть прозрачным и подписчиков, отличных от прямоугольны
Безоконные элементы управления уменьшают размер экземпляра и время создания объекта.

Элементы управления не требуется.Службы, окно предлагает можно легко обеспечить через одно общее окна (обычно контейнер) и бит распределения кода.Иметь окно в основном лишнее усложнение на объект.

При безоконная активация используется, контейнер (который имеет окно отвечает за обеспечение службы), в противном случае были бы предоставлены собственным окна элемента управления.Например, если требуется элемента управления запросить фокус клавиатуры, запросить захват мыши или получить контекст устройства, эти операции управляются контейнером.COleControlфункции-члены безоконный-операции вызывает эти операции в контейнере.

При безоконная активация разрешена, сообщения ввода делегатов контейнера в IOleInPlaceObjectWindowless элемента управления, взаимодействующих (расширения IOleInPlaceObject для поддержки безоконной).Реализация этого интерфейса COleControl пошлет эти сообщения через сопоставление сообщения элемента управления, после обработки координаты мыши.Можно обрабатывать эти сообщения как обычные сообщения окна, добавив соответствующие записи для сопоставления сообщений.

В безоконном элементе управления, необходимо всегда использовать функции-члены COleControl вместо соответствующие функции-члены CWnd или их связанных функций API Windows.

Объекты OLE управления могут также создать окно, только когда они стали активными, но объем работ, необходимые для перехода Неактивен- проходит активный скорость перехода становится вверх и вниз.Случаи, когда это проблема: в качестве примера рассмотрим сетку текстовых полей.Cursoring вверх и вниз по столбцу, каждый элемент управления должен быть затем выключенным в- размещение и активированным.Скорость перехода неактивного/активного непосредственно влияет на скорость прокрутки.

Дополнительные сведения о разработке OLE границы элемента управления см. в разделе статьи Элементы управления ActiveX MFC и Общие сведения: Создание программы элемент управления ActiveX MFC.Дополнительные сведения о оптимизировать OLE элементов управления, в том числе управления безоконных и фликер- свободна см. в разделе Элементы управления ActiveX MFC: оптимизация.