Compartir a través de


COleControl Class

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.

Jerarquía de herencia

CObject

CCmdTarget

CWnd

COleControl

Requisitos

encabezado: afxctl.h

Vea también

Referencia

COlePropertyPage Class

CWnd (clase)

Gráfico de jerarquías

CFontHolder (Clase)

CPictureHolder Class

Conceptos

ejemplo CIRC3 de MFC

ejemplo TESTHELP de MFC