COleControl Class

Artículo
06/10/2015

Una clase base eficaz para controles OLE que se convierten.

class COleControl : public CWnd

Miembros

Constructores públicos

Name	Descripción
COleControl::COleControl	Crea un objeto COleControl.

Métodos públicos

Name	Descripción
COleControl::AmbientAppearance	Recupera el aspecto del control actual.
COleControl::AmbientBackColor	devuelve el valor de la propiedad BackColor ambiente.
COleControl::AmbientDisplayName	Devuelve el nombre del control según lo especificado por el contenedor.
COleControl::AmbientFont	Devuelve el valor de la propiedad de fuente ambiente.
COleControl::AmbientForeColor	Devuelve el valor de la propiedad ForeColor de ambiente.
COleControl::AmbientLocaleID	Devuelve el identificador de la configuración regional del contenedor
COleControl::AmbientScaleUnits	devuelve el tipo de unidades utilizadas por el contenedor.
COleControl::AmbientShowGrabHandles	Determina si se muestran los controladores de arrastre.
COleControl::AmbientShowHatching	Determina si se muestra la trama.
COleControl::AmbientTextAlign	Devuelve el tipo de alineación del texto especificado en el contenedor.
COleControl::AmbientUIDead	Determina si el control responde a las acciones de la interfaz de usuario.
COleControl::AmbientUserMode	Determina el modo del contenedor.
COleControl::BoundPropertyChanged	Notifica al contenedor que se ha cambiado una propiedad enlazada.
COleControl::BoundPropertyRequestEdit	Solicita permiso para modificar el valor de propiedad.
COleControl::ClientToParent	Convierte un punto en relación con el origen del control a un punto en relación con el origen del contenedor.
COleControl::ClipCaretRect	Ajusta un rectángulo del símbolo de intercalación si es superpuesto por un control.
COleControl::ControlInfoChanged	Llame a esta función después del conjunto de teclas controlado por el control ha cambiado.
COleControl::DisplayError	Muestra almacenan eventos Error al usuario del control.
COleControl::DoClick	Implementación del método común de DoClick .
COleControl::DoPropExchange	Serializa las propiedades de un objeto de COleControl .
COleControl::DoSuperclassPaint	Rediseña un control OLE que se ha derivado de un control de Windows.
COleControl::EnableSimpleFrame	Compatibilidad simple del cuadro de permisos para un control.
COleControl::ExchangeExtent	Serializa el ancho y el alto del control.
COleControl::ExchangeStockProps	Serializa las propiedades estándar de control.
COleControl::ExchangeVersion	Serializa el número de versión del control.
COleControl::FireClick	Desencadena el evento común de Click .
COleControl::FireDblClick	Desencadena el evento común de DblClick .
COleControl::FireError	Desencadena el evento común de Error .
COleControl::FireEvent	Desencadena un evento personalizado.
COleControl::FireKeyDown	Desencadena el evento común de KeyDown .
COleControl::FireKeyPress	Desencadena el evento común de KeyPress .
COleControl::FireKeyUp	Desencadena el evento común de KeyUp .
COleControl::FireMouseDown	Desencadena el evento común de MouseDown .
COleControl::FireMouseMove	Desencadena el evento común de MouseMove .
COleControl::FireMouseUp	Desencadena el evento común de MouseUp .
COleControl::FireReadyStateChange	Activa un evento cuando cambia el estado listo del control.
COleControl::GetActivationPolicy	Modifica el comportamiento predeterminado de activación de un control que admita la interfaz de IPointerInactive .
COleControl::GetAmbientProperty	Devuelve el valor de propiedad de ambiente especificada.
COleControl::GetAppearance	Devuelve el valor de la propiedad de apariencia común.
COleControl::GetBackColor	Devuelve el valor de la propiedad BackColor común.
COleControl::GetBorderStyle	Devuelve el valor de la propiedad común BorderStyle.
COleControl::GetCapture	Determina si un objeto sin ventana, se genera el control tiene la captura del mouse.
COleControl::GetClassID	Recupera el id. de clase OLE del control.
COleControl::GetClientOffset	Recupera la diferencia entre la esquina superior izquierda del área rectangular de control y la esquina superior izquierda del área cliente.
COleControl::GetClientRect	Recupera el tamaño del área de cliente del control.
COleControl::GetClientSite	Consultas un objeto para el puntero al sitio actual del cliente dentro de su contenedor.
COleControl::GetControlFlags	Recupera los valores de marcador del control.
COleControl::GetControlSize	Devuelve la posición y el tamaño de controles activex.
COleControl::GetDC	Proporciona los medios para que un control sin ventana obtenga un contexto de dispositivo de su contenedor.
COleControl::GetEnabled	Devuelve el valor de la propiedad enabled común.
COleControl::GetExtendedControl	Recupera un puntero a un objeto extendido de control que pertenece al contenedor.
COleControl::GetFocus	Determina si el control tiene el foco.
COleControl::GetFont	Devuelve el valor de la propiedad de fuente común.
COleControl::GetFontTextMetrics	Devuelve métricas de un objeto de CFontHolder .
COleControl::GetForeColor	Devuelve el valor de la propiedad ForeColor común.
COleControl::GetHwnd	Devuelve el valor de la propiedad común de HWND.
COleControl::GetMessageString	Proporciona el texto de la barra de estado para un elemento de menú.
COleControl::GetNotSupported	Evita el acceso al valor de propiedad de un control de usuario.
COleControl::GetReadyState	Devuelve el estado de la eliminación del control.
COleControl::GetRectInContainer	Devuelve el rectángulo de control en relación con el contenedor.
COleControl::GetStockTextMetrics	Devuelve métricas de la propiedad de fuente común.
COleControl::GetText	Devuelve el valor de texto o de la propiedad caption común.
COleControl::GetWindowlessDropTarget	Reemplace para permitir que un control sin ventana sea el destino de las operaciones de arrastrar y colocar.
COleControl::InitializeIIDs	Informa a la clase base el los identificadores IID que el control utilizará.
COleControl::InternalGetFont	Devuelve un objeto de CFontHolder para la propiedad de fuente común.
COleControl::InternalGetText	Recupera la leyenda o la propiedad de texto común.
COleControl::InternalSetReadyState	Establece el estado de la eliminación del control y desencadena el evento de listo-provincia- cambio.
COleControl::InvalidateControl	Reemplaza un área de control mostrado, produciendolo que se rediseñará.
COleControl::InvalidateRgn	Reemplaza el área cliente de la ventana contenedora dentro de la región determinada. Se puede utilizar para actualizar los controles sin ventana en la región.
COleControl::IsConvertingVBX	Allows especializado la carga de un control OLE.
COleControl::IsModified	Determina si el estado de control ha cambiado.
COleControl::IsOptimizedDraw	Indica si el contenedor admite el dibujo optimizado para la operación actual del gráfico.
COleControl::IsSubclassedControl	Denominado para determinar si el control crea una subclase de un control de Windows.
COleControl::Load	Restaura los datos asincrónico anterior e inicia una nueva carga de propiedad asincrónica del control.
COleControl::LockInPlaceActive	Determina si el control se puede desactivar en el contenedor.
COleControl::OnAmbientPropertyChange	Se invoca cuando cambia una propiedad de ambiente.
COleControl::OnAppearanceChanged	Se invoca cuando cambia la propiedad de apariencia común.
COleControl::OnBackColorChanged	Se invoca cuando cambia la propiedad BackColor común.
COleControl::OnBorderStyleChanged	Se invoca cuando cambia la propiedad BorderStyle de la acción.
COleControl::OnClick	Denominado para desencadenar el evento Click común.
COleControl::OnClose	Notifica al control que se ha llamado a IOleControl::Close .
COleControl::OnDoVerb	Se llama después de que se ha ejecutado un verbo del control.
COleControl::OnDraw	Llamado cuando un control se solicita para actualizarse.
COleControl::OnDrawMetafile	Llamado por el contenedor cuando un control se solicita para actualizarse mediante un contexto de dispositivo de metarchivo.
COleControl::OnEdit	Llamado por el contenedor a la interfaz de usuario Activar un control OLE.
COleControl::OnEnabledChanged	Se invoca cuando cambia la propiedad enabled común.
COleControl::OnEnumVerbs	Llamado por el contenedor para enumerar los verbos de un control.
COleControl::OnEventAdvise	Se invoca cuando los controladores de eventos están conectados o desconectados de un control.
COleControl::OnFontChanged	Se invoca cuando cambia la propiedad de fuente común.
COleControl::OnForeColorChanged	Se invoca cuando se cambia la propiedad ForeColor común.
COleControl::OnFreezeEvents	Se invoca cuando se inmovilizan o se liberan los eventos de un control.
COleControl::OnGetColorSet	Notifica al control que se ha llamado a IOleObject::GetColorSet .
COleControl::OnGetControlInfo	Proporciona información mnemotécnica al contenedor.
COleControl::OnGetDisplayString	Denominado para obtener una cadena que represente un valor de propiedad.
COleControl::OnGetInPlaceMenu	Solicita el identificador del menú de control que se combina con el menú del contenedor.
COleControl::OnGetNaturalExtent	Reemplazo para recuperar el tamaño de presentación del control más cercano al modo propuesto del tamaño y la extensión.
COleControl::OnGetPredefinedStrings	Cadenas de retornos que representan los valores posibles para la propiedad.
COleControl::OnGetPredefinedValue	Devuelve el valor correspondiente a una cadena predefinida.
COleControl::OnGetViewExtent	Reemplace para recuperar el tamaño de las áreas de presentación del control (se puede utilizar para habilitar el gráfico de dos- paso).
COleControl::OnGetViewRect	Reemplace para convertir el tamaño del control en un rectángulo inicial en una posición determinada.
COleControl::OnGetViewStatus	Reemplace para recuperar el estado de vista del control.
COleControl::OnHideToolBars	Llamado por el contenedor cuando el control se interfaz de usuario unchecked.
COleControl::OnInactiveMouseMove	Reemplace para obtener el contenedor del control inactivo en los mensajes de WM_MOUSEMOVE de envío del puntero del mouse en el control.
COleControl::OnInactiveSetCursor	Reemplace para obtener el contenedor del control inactivo en los mensajes de WM_SETCURSOR de envío del puntero del mouse en el control.
COleControl::OnKeyDownEvent	Se llama después de que se ha desencadenado el evento KeyDown de la acción.
COleControl::OnKeyPressEvent	Se llama después de que se ha desencadenado el evento KeyPress de la acción.
COleControl::OnKeyUpEvent	Se llama después de que se ha desencadenado el evento KeyUp de la acción.
COleControl::OnMapPropertyToPage	Indica qué página de propiedades para editar una propiedad.
COleControl::OnMnemonic	Llamado cuando una clave mnemotécnica de control se ha presionado.
COleControl::OnProperties	Se invoca cuando se ha invocado el verbo de “properties” del control.
COleControl::OnQueryHitPoint	Reemplace para ver si la presentación de un control se superpone a un punto determinado.
COleControl::OnQueryHitRect	Reemplace para ver si la presentación de un control se superpone a cualquier punto en un rectángulo determinado.
COleControl::OnRenderData	Llamado por el marco para recuperar datos en el formato especificado.
COleControl::OnRenderFileData	Llamado por el marco para recuperar datos de un archivo en el formato especificado.
COleControl::OnRenderGlobalData	Llamado por el marco para recuperar datos de la memoria global en el formato especificado.
COleControl::OnResetState	Restablece las propiedades de un control a los valores predeterminados.
COleControl::OnSetClientSite	Notifica al control que se ha llamado a IOleControl::SetClientSite .
COleControl::OnSetData	Reemplaza los datos del control con otro valor.
COleControl::OnSetExtent	Con el nombre de la extensión de control ha cambiado.
COleControl::OnSetObjectRects	Se llama después de que se han modificado las dimensiones del control.
COleControl::OnShowToolBars	Se llama cuando el control se ha interfaz de usuario elevado.
COleControl::OnTextChanged	Se invoca cuando se cambia el texto o la propiedad caption común.
COleControl::OnWindowlessMessage	Mensajes de la ventana procesos (distinto de mensajes del teclado y de mouse) para los controles sin ventana.
COleControl::ParentToClient	Convierte un punto en relación con el origen del contenedor a un punto en relación con el origen del control.
COleControl::PostModalDialog	Notifica al contenedor que se ha cerrado un cuadro de diálogo modal.
COleControl::PreModalDialog	Notifica al contenedor de un cuadro de diálogo modal está a punto de mostrarse.
COleControl::RecreateControlWindow	Destruye y vuelve a crear la ventana de control.
COleControl::Refresh	Fuerza una repintura de la apariencia de un control.
COleControl::ReleaseCapture	Captura del mouse de las versiones.
COleControl::ReleaseDC	Libera el contexto del dispositivo de pantalla de un contenedor de un control sin ventana.
COleControl::ReparentControlWindow	Restablece el elemento primario de la ventana de control.
COleControl::ResetStockProps	Inicialice las propiedades de la acción de COleControl a sus valores predeterminados.
COleControl::ResetVersion	Inicializa el número de versión a un valor especificado.
COleControl::ScrollWindow	Permite que un control sin ventana desplácese un área dentro de su imagen activo en contexto en la pantalla.
COleControl::SelectFontObject	Seleccione una propiedad de la fuente personalizada en un contexto de dispositivo.
COleControl::SelectStockFont	Selecciona la propiedad de la fuente común en un contexto de dispositivo.
COleControl::SerializeExtent	Serializa o inicializa el espacio de presentación del control.
COleControl::SerializeStockProps	Serializa o inicializa las propiedades de la acción de COleControl .
COleControl::SerializeVersion	Serializa o inicializa la información de versión del control.
COleControl::SetAppearance	Establece el valor de la propiedad de apariencia común.
COleControl::SetBackColor	Establece el valor de la propiedad BackColor común.
COleControl::SetBorderStyle	Establece el valor de la propiedad común BorderStyle.
COleControl::SetCapture	Hace que la ventana del contenedor del control para tomar la propiedad de la captura del mouse en nombre del control.
COleControl::SetControlSize	Establece la posición y el tamaño de controles activex.
COleControl::SetEnabled	Establece el valor de la propiedad enabled común.
COleControl::SetFocus	Hace que la ventana del contenedor del control para tomar la propiedad del foco de entrada en nombre del control.
COleControl::SetFont	Establece el valor de la propiedad de fuente común.
COleControl::SetForeColor	Establece el valor de la propiedad ForeColor común.
COleControl::SetInitialSize	Establece el tamaño de un control OLE cuando se muestra por primera vez en un contenedor.
COleControl::SetModifiedFlag	Cambia el estado modificada de un control.
COleControl::SetNotPermitted	Indica que hay un error en una llamada de edición de texto.
COleControl::SetNotSupported	Evita la modificación en el valor de propiedad de un control de usuario.
COleControl::SetRectInContainer	Establece el rectángulo de control en relación con el contenedor.
COleControl::SetText	Establece el valor de texto o de la propiedad caption común.
COleControl::ThrowError	Indica que se ha producido un error a en un control OLE.
COleControl::TransformCoords	Las transformaciones coordinan valores entre un contenedor y.
COleControl::TranslateColor	Convierte un valor de OLE_COLOR a un valor de COLORREF .
COleControl::WillAmbientsBeValidDuringLoad	Determina si las propiedades de ambiente estará disponible la próxima vez que el control se cargan.
COleControl::WindowProc	proporciona un procedimiento de Windows para un objeto de COleControl .

Métodos protegidos

Name	Descripción
COleControl::DrawContent	Llamado por el marco cuando la apariencia del control debe actualizarse.
COleControl::DrawMetafile	Llamado por el marco cuando se utiliza el contexto de dispositivo de metarchivo.
COleControl::IsInvokeAllowed	Habilita la invocación de método de automatización.
COleControl::SetInitialDataFormats	Llamado por el marco para inicializar la lista de formatos de datos admitidos por el control.

Comentarios

Derivado de CWnd, esta clase hereda toda la funcionalidad de un objeto de la ventana de Windows más específico de la función adicional a OLE, como desencadenamiento de eventos y la capacidad de admitir métodos y propiedades.

Controles OLE pueden incrustar en aplicaciones contenedoras VIEJAS y comunicarse con el contenedor mediante un sistema bidireccional de desencadenamiento de eventos y métodos el exponer y propiedades al contenedor. Observe que los contenedores de OLE estándar sólo admiten la funcionalidad básica de un control activex. No pueden admitir características extendidas de un control OLE. El desencadenamiento de evento se produce cuando los eventos se envían al contenedor como resultado de acciones que tienen lugar en el control. A su vez, el contenedor se comunica con el control utilizando un conjunto expuesto de métodos y propiedades análogas a las funciones miembro y los miembros de datos de C++. ordenan. Este enfoque permite al desarrollador controla la apariencia del control y notifica el contenedor cuando algunas acciones aparecen.

Controles sin ventana

Controles OLE pueden estar activo en contexto utilizado sin una ventana. Los controles sin ventana tienen ventajas importantes:

Los controles sin ventana pueden ser transparente y no rectangulares
Los controles sin ventana reduce el tamaño de la instancia y la hora de creación de objetos

Los Controles no necesitan una ventana. Los servicios que una ventana proporciona se pueden proporcionar con facilidad mediante una sola ventana compartida (normalmente el contenedor) y un poco de enviar codificada. Tener una ventana es principalmente una complicación innecesaria del objeto.

Cuando se utiliza la activación sin ventana, el contenedor (que tiene una ventana) es responsable de proporcionar los servicios que pudieran estar proporcionados de otra manera por la propia ventana de control. Por ejemplo, si sus necesidades de control de ver el foco de teclado, de ver la captura del mouse, o de obtener un contexto de dispositivo, estas operaciones son administradas por el contenedor. COleControlfunciones miembro de la sin ventana- operación invoca estas operaciones en el contenedor.

Cuando está sin ventana se habilita la activación, los mensajes de entrada de los delegados de contenedor a la interfaz de IOleInPlaceObjectWindowless de control (una extensión de IOleInPlaceObject para compatibilidad sin ventana). la implementación de los entity_COleControl de esta interfaz envía estos mensajes a través del mapa de mensajes del control, después de ajustar las coordenadas del mouse correctamente. Puede procesar estos mensajes como mensajes normales de la ventana, agregando las entradas correspondientes al mapa de mensajes.

En un control sin ventana, debe utilizar siempre las funciones miembro de COleControl en lugar de las funciones correspondientes del miembro de CWnd o la API de Windows relacionada funciona.

Los objetos de controles activex también pueden crear una ventana cuando pasan a ser activo, pero la cantidad de trabajo necesaria para la transición de inactivo- activo sube y la velocidad de transición va a continuación. Hay casos cuando éste es un problema: como ejemplo, considere una cuadrícula de cuadros de texto. El cursoring arriba y abajo a través de la columna, cada control se debe haber producido en contexto y después unchecked. La velocidad de transición inactiva/activo afecta directamente a la velocidad de desplazamiento.

Para obtener más información sobre cómo desarrollar un marco de controles activex, vea los artículos Controles ActiveX de MFC y información general: Crear un programa de control ActiveX de MFC. Para obtener información sobre cómo optimizar controles OLE, incluidos los controles sin ventana y libres de centelleo, vea Controles ActiveX de MFC: optimización.