Classe de COleControl

Article
03/15/2013

Une classe de base puissante pour développer des contrôles OLE.

class COleControl : public CWnd

Membres

Constructeurs publics

Nom	Description
COleControl::COleControl	Crée un objet COleControl.

Méthodes publiques

Nom	Description
COleControl::AmbientAppearance	Récupère l'apparence actuelle du contrôle.
COleControl::AmbientBackColor	Retourne la valeur de la propriété ambiante BackColor.
COleControl::AmbientDisplayName	Retourne le nom du contrôle comme spécifié par le conteneur.
COleControl::AmbientFont	Retourne la valeur de la propriété Font ambiante.
COleControl::AmbientForeColor	Retourne la valeur de la propriété ambiante de ForeColor.
COleControl::AmbientLocaleID	Retourne l'ID de paramètres régionaux du conteneur
COleControl::AmbientScaleUnits	Retourne le type d'unités utilisées par le conteneur.
COleControl::AmbientShowGrabHandles	Détermine si les poignées de manipulation sont affichés.
COleControl::AmbientShowHatching	Détermine si la marque de hachage est affichée.
COleControl::AmbientTextAlign	Retourne le type d'alignement de texte spécifié par le conteneur.
COleControl::AmbientUIDead	Détermine si le contrôle répond aux actions d'interface utilisateur.
COleControl::AmbientUserMode	Détermine le mode du conteneur.
COleControl::BoundPropertyChanged	Informe le conteneur qu'une propriété liée a été modifiée.
COleControl::BoundPropertyRequestEdit	Demande l'autorisation de modifier la valeur de propriété.
COleControl::ClientToParent	Convertit un point par rapport à l'origine du contrôle à un point par rapport à l'origine de son conteneur.
COleControl::ClipCaretRect	Règle un rectangle de signe insertion s'il est chevauché par un contrôle.
COleControl::ControlInfoChanged	Appelez cette fonction après que l'ensemble des mnémoniques gérée par le contrôle a changé.
COleControl::DisplayError	Les affichages stockent des événements d'erreur à l'utilisateur du contrôle.
COleControl::DoClick	Implémentation de la méthode magasin d' DoClick .
COleControl::DoPropExchange	Sérialise les propriétés d'un objet d' COleControl .
COleControl::DoSuperclassPaint	Redessine un contrôle OLE qui a été sous-classé d'un contrôle Windows.
COleControl::EnableSimpleFrame	Permet la prise en charge simple de frame d'un contrôle.
COleControl::ExchangeExtent	Sérialise la largeur et la hauteur du contrôle.
COleControl::ExchangeStockProps	Sérialise les propriétés des actions du contrôle.
COleControl::ExchangeVersion	Sérialise le numéro de version du contrôle.
COleControl::FireClick	Déclenche l'événement magasin d' Click .
COleControl::FireDblClick	Déclenche l'événement magasin d' DblClick .
COleControl::FireError	Déclenche l'événement magasin d' Error .
COleControl::FireEvent	Déclenche un événement personnalisé.
COleControl::FireKeyDown	Déclenche l'événement magasin d' KeyDown .
COleControl::FireKeyPress	Déclenche l'événement magasin d' KeyPress .
COleControl::FireKeyUp	Déclenche l'événement magasin d' KeyUp .
COleControl::FireMouseDown	Déclenche l'événement magasin d' MouseDown .
COleControl::FireMouseMove	Déclenche l'événement magasin d' MouseMove .
COleControl::FireMouseUp	Déclenche l'événement magasin d' MouseUp .
COleControl::FireReadyStateChange	Déclenche un événement lorsque les modifications d'état prêt du contrôle.
COleControl::GetActivationPolicy	Modifie le comportement par défaut de l'activation d'un contrôle qui prend en charge l'interface d' IPointerInactive .
COleControl::GetAmbientProperty	Retourne la valeur de la propriété ambiante spécifiée.
COleControl::GetAppearance	Retourne la valeur de la propriété d'apparence boursières.
COleControl::GetBackColor	Retourne la valeur de la propriété stock BackColor.
COleControl::GetBorderStyle	Retourne la valeur de la propriété boursières de BorderStyle.
COleControl::GetCapture	Détermine si un objet de contrôles sans fenêtre et a activé la capture de la souris.
COleControl::GetClassID	Récupère l'ID de classe OLE du contrôle.
COleControl::GetClientOffset	Extrait la différence entre l'angle supérieur gauche de la zone rectangulaire du contrôle et le coin supérieur gauche de sa zone cliente.
COleControl::GetClientRect	Extrait la taille de la zone cliente du contrôle.
COleControl::GetClientSite	Interroge un objet pour le pointeur à son site client actuel dans son conteneur.
COleControl::GetControlFlags	Récupère les paramètres de balise de contrôle.
COleControl::GetControlSize	Retourne la position et la taille du contrôle OLE.
COleControl::GetDC	Fournit un moyen pour un contrôle sans fenêtre obtenir un contexte de périphérique de son conteneur.
COleControl::GetEnabled	Retourne la valeur de la propriété Enabled boursières.
COleControl::GetExtendedControl	Extrait un pointeur vers un objet contrôle étendu appartenant au conteneur.
COleControl::GetFocus	Détermine si le contrôle a le focus.
COleControl::GetFont	Retourne la valeur de la propriété stock Font.
COleControl::GetFontTextMetrics	Retourne la métrique d'un objet d' CFontHolder .
COleControl::GetForeColor	Retourne la valeur de la propriété de stock ForeColor.
COleControl::GetHwnd	Retourne la valeur de la propriété boursières de hWnd.
COleControl::GetMessageString	Fournit le texte de la barre d'état d'un élément de menu.
COleControl::GetNotSupported	Empêché l'accès à la valeur de propriété d'un contrôle par l'utilisateur.
COleControl::GetReadyState	Retourne l'état de la disponibilité du contrôle.
COleControl::GetRectInContainer	Retourne le rectangle du contrôle par rapport à son conteneur.
COleControl::GetStockTextMetrics	Retourne la métrique de propriétés stock Font.
COleControl::GetText	Retourne la valeur de la propriété magasin de texte ou de légende.
COleControl::GetWindowlessDropTarget	Substitution pour permettre à un contrôle sans fenêtre à être la cible les opérations de glisser-déplacer.
COleControl::InitializeIIDs	Notifie la classe de base des IID que le contrôle utilisera.
COleControl::InternalGetFont	Retourne un objet d' CFontHolder pour la propriété stock Font.
COleControl::InternalGetText	Extrait la légende ou la propriété Text boursières.
COleControl::InternalSetReadyState	Définit l'état de la disponibilité du contrôle et déclenche l'événement de prêt-état- modification.
COleControl::InvalidateControl	Invalide un domaine du contrôle affiché, le causant d'être redessiné.
COleControl::InvalidateRgn	Invalide la zone cliente de la fenêtre de conteneur dans la zone donnée.Peut être utilisé pour redessiner des contrôles sans fenêtre dans une région.
COleControl::IsConvertingVBX	Allows un spécialisé le chargement d'un contrôle OLE.
COleControl::IsModified	Détermine si l'état du contrôle a changé.
COleControl::IsOptimizedDraw	Indique si le conteneur en charge le dessin optimisé pour l'exécution actuelle de dessin.
COleControl::IsSubclassedControl	Appelé pour déterminer si les sous-classes d'un contrôle Windows.
COleControl::Load	Réinitialise toutes les données asynchrones précédentes et initialise un nouveau charge de la propriété asynchrone du contrôle.
COleControl::LockInPlaceActive	Détermine si votre contrôle peut être désactivé par le conteneur.
COleControl::OnAmbientPropertyChange	Appelé lorsqu'une propriété ambiante est modifiée.
COleControl::OnAppearanceChanged	Appelé lorsque la propriété d'apparence stock est modifiée.
COleControl::OnBackColorChanged	Appelé lorsque la propriété BackColor d'actions est modifiée.
COleControl::OnBorderStyleChanged	Appelé lorsque la propriété de BorderStyle d'actions est modifiée.
COleControl::OnClick	Appelé pour déclencher l'événement clic du stock.
COleControl::OnClose	Informe le contrôle qu' IOleControl::Close a été appelé.
COleControl::OnDoVerb	Appelé après qu'un verbe de contrôle a été exécuté.
COleControl::OnDraw	Appelé lorsqu'un contrôle est demandé se repeindre.
COleControl::OnDrawMetafile	Appelé par le conteneur lorsqu'un contrôle est demandé se repeindre avec un contexte de périphérique de métafichier.
COleControl::OnEdit	Appelé par le conteneur à l'interface utilisateur d'activer un contrôle OLE.
COleControl::OnEnabledChanged	Appelé lorsque la propriété Enabled stock est modifiée.
COleControl::OnEnumVerbs	Appelé par le conteneur pour énumérer les verbes d'un contrôle.
COleControl::OnEventAdvise	Appelée lorsque les gestionnaires d'événements sont connectés ou déconnectés d'un contrôle.
COleControl::OnFontChanged	Appelé lorsque la propriété du stock Font est modifiée.
COleControl::OnForeColorChanged	Appelé lorsque la propriété de ForeColor d'actions est modifiée.
COleControl::OnFreezeEvents	Appelée lorsque les événements d'un contrôle sont figés ou dégelés.
COleControl::OnGetColorSet	Informe le contrôle qu' IOleObject::GetColorSet a été appelé.
COleControl::OnGetControlInfo	Fournit des informations mnémoniques au conteneur.
COleControl::OnGetDisplayString	Appelé pour obtenir une chaîne représentant une valeur de propriété.
COleControl::OnGetInPlaceMenu	Demande le handle du menu de contrôle qui sera fusionné avec le menu du conteneur.
COleControl::OnGetNaturalExtent	Substitution pour récupérer la taille d'affichage du contrôle la plus proche du mode proposé de taille et d'étendue.
COleControl::OnGetPredefinedStrings	Retourne des chaînes représentant les valeurs possibles pour une propriété.
COleControl::OnGetPredefinedValue	Retourne la valeur correspondant à une chaîne prédéfinie.
COleControl::OnGetViewExtent	Substitution pour récupérer la taille des zones d'affichage du contrôle (peut être utilisé pour activer le dessin de deux exécution).
COleControl::OnGetViewRect	Substitution pour convertir la taille du contrôle dans un rectangle en commençant à un emplacement spécifique.
COleControl::OnGetViewStatus	Substitution pour récupérer le mode de la vue du contrôle.
COleControl::OnHideToolBars	Appelé par le conteneur lorsque le contrôle est interface utilisateur désactivé.
COleControl::OnInactiveMouseMove	Substitution pour que le conteneur du contrôle inactif sous les messages d' WM_MOUSEMOVE de dispatch du pointeur de la souris au contrôle.
COleControl::OnInactiveSetCursor	Substitution pour que le conteneur du contrôle inactif sous les messages d' WM_SETCURSOR de dispatch du pointeur de la souris au contrôle.
COleControl::OnKeyDownEvent	Appelé après l'événement KeyDown d'actions a été déclenché.
COleControl::OnKeyPressEvent	Appelé après l'événement KeyPress d'actions a été déclenché.
COleControl::OnKeyUpEvent	Appelé après l'événement de KeyUp d'actions a été déclenché.
COleControl::OnMapPropertyToPage	Indique que la page de propriétés à utiliser pour modifier une propriété.
COleControl::OnMnemonic	Appelé lorsqu'une touche mnémonique du contrôle a été enfoncée.
COleControl::OnProperties	Appelé lorsque le verbe des « properties » du contrôle a été appelé.
COleControl::OnQueryHitPoint	Substitution à interroger si l'affichage d'un contrôle chevauche un point donné.
COleControl::OnQueryHitRect	Substitution à interroger si l'affichage d'un contrôle chevauche tout point dans un rectangle donné.
COleControl::OnRenderData	Appelé par l'infrastructure pour récupérer des données dans le format spécifié.
COleControl::OnRenderFileData	Appelé par l'infrastructure pour récupérer des données à partir d'un fichier au format spécifié.
COleControl::OnRenderGlobalData	Appelé par l'infrastructure pour récupérer les données de mémoire globale dans le format spécifié.
COleControl::OnResetState	Réinitialise les propriétés d'un contrôle aux valeurs par défaut.
COleControl::OnSetClientSite	Informe le contrôle qu' IOleControl::SetClientSite a été appelé.
COleControl::OnSetData	Remplace les paramètres par une autre valeur.
COleControl::OnSetExtent	Appelé après l'étendue du contrôle a changé.
COleControl::OnSetObjectRects	Appelé après les dimensions du contrôle ont été changés.
COleControl::OnShowToolBars	Appelé lorsque le contrôle a été interface utilisateur activé.
COleControl::OnTextChanged	Appelé lorsque la propriété magasin de texte ou de légende est modifiée.
COleControl::OnWindowlessMessage	Traite les messages de fenêtre (autre que les messages de clavier et de souris) pour les contrôles sans fenêtre.
COleControl::ParentToClient	Convertit un point par rapport à l'origine du conteneur à un point par rapport à l'origine du contrôle.
COleControl::PostModalDialog	Informe le conteneur qu'une boîte de dialogue modale a été fermée.
COleControl::PreModalDialog	Informe le conteneur qu'une boîte de dialogue modale est sur le point d'être affiché.
COleControl::RecreateControlWindow	Détruit et recrée la fenêtre du contrôle.
COleControl::Refresh	Force un redessiner de l'apparence d'un contrôle.
COleControl::ReleaseCapture	Libère la capture de la souris.
COleControl::ReleaseDC	Libère le contexte de périphérique d'affichage d'un conteneur d'un contrôle sans fenêtre.
COleControl::ReparentControlWindow	Réinitialise le parent de la fenêtre du contrôle.
COleControl::ResetStockProps	Initialise les propriétés d'actions d' COleControl à leurs valeurs par défaut.
COleControl::ResetVersion	Initialise le numéro de version à une valeur donnée.
COleControl::ScrollWindow	Permet à un contrôle sans fenêtre pour faire défiler une zone dans son image active sur place de l'affichage.
COleControl::SelectFontObject	Sélectionne une propriété Font personnalisée dans un contexte de périphérique.
COleControl::SelectStockFont	Sélectionne la propriété stock Font dans un contexte de périphérique.
COleControl::SerializeExtent	Sérialise ou initialise l'espace d'affichage du contrôle.
COleControl::SerializeStockProps	Sérialise ou initialise les propriétés d'actions d' COleControl .
COleControl::SerializeVersion	Sérialise ou initialise les informations de version du contrôle.
COleControl::SetAppearance	Définit la valeur de la propriété d'apparence boursières.
COleControl::SetBackColor	Définit la valeur de la propriété stock BackColor.
COleControl::SetBorderStyle	Définit la valeur de la propriété boursières de BorderStyle.
COleControl::SetCapture	Pour prendre la fenêtre de conteneur du contrôle la propriétaire de la capture de la souris sur le nom du contrôle.
COleControl::SetControlSize	Définit la position et la taille du contrôle OLE.
COleControl::SetEnabled	Définit la valeur de la propriété Enabled boursières.
COleControl::SetFocus	Pour prendre la fenêtre de conteneur du contrôle le propriétaire du focus d'entrée le nom du contrôle.
COleControl::SetFont	Définit la valeur de la propriété stock Font.
COleControl::SetForeColor	Définit la valeur de la propriété de stock ForeColor.
COleControl::SetInitialSize	Définit la taille d'un contrôle OLE une fois d'abord affiché dans un conteneur.
COleControl::SetModifiedFlag	Modifie l'état modifié d'un contrôle.
COleControl::SetNotPermitted	Indique qu'une demande de modification a échoué.
COleControl::SetNotSupported	Empêché la modification de la valeur de propriété d'un contrôle par l'utilisateur.
COleControl::SetRectInContainer	Définit le rectangle du contrôle par rapport à son conteneur.
COleControl::SetText	Définit la valeur de la propriété magasin de texte ou de légende.
COleControl::ThrowError	Signale qu'une erreur s'est produite dans un contrôle OLE.
COleControl::TransformCoords	Les transformations coordonnent des valeurs entre un conteneur et.
COleControl::TranslateColor	Convertit une valeur d' OLE_COLOR à une valeur de COLORREF .
COleControl::WillAmbientsBeValidDuringLoad	Détermine si les propriétés ambiantes soient disponibles la prochaine fois le contrôle est chargé.
COleControl::WindowProc	Fournit une procédure de fenêtre pour un objet d' COleControl .

Méthodes protégées

Nom	Description
COleControl::DrawContent	Appelé par l'infrastructure lorsque l'apparence du contrôle doit être mise à jour.
COleControl::DrawMetafile	Appelé par l'infrastructure lorsque le contexte de périphérique de métafichier est utilisé.
COleControl::IsInvokeAllowed	Active l'appel de méthode automation.
COleControl::SetInitialDataFormats	Appelé par l'infrastructure pour initialiser la liste de formats de données pris en charge par le contrôle.

Notes

Dérivé d' CWnd, cette classe hérite de toutes les fonctionnalités d'un objet window windows ainsi que le détail de fonctionnalités supplémentaires OLE, tel que le déclenchement d'événements et une fonctionnalité de prendre en charge les méthodes et les propriétés.

Les contrôles OLE peuvent être insérés dans les applications de conteneur OLE et communiquer avec le conteneur à l'aide d'un système bidirectionnel de déclenchement d'événements et des méthodes pour exposer les propriétés et au conteneur.Notez que les conteneurs OLE standard prennent uniquement en charge les fonctionnalités de base d'un contrôle OLE.Ils ne peuvent pas prendre en charge les fonctionnalités étendues d'un contrôle OLE.Le déclenchement d'événements se produit lorsque les événements sont envoyés au conteneur à la suite de certaines actions ayant lieu dans le contrôle.Ensuite, le conteneur communique avec le contrôle à l'aide d'un ensemble exposé de méthodes et les propriétés analogues aux fonctions membres et aux membres de données C++ classe.Cette approche permet au développeur pour contrôler l'apparence du contrôle et pour informer le conteneur lorsque certaines actions se produisent.

Contrôles sans fenêtre

Les contrôles OLE peuvent être actif sur place utilisé sans fenêtre.Les contrôles sans fenêtre présentent des avantages importants :

Les contrôles sans fenêtre peuvent être transparents et non rectangulaires
Les contrôles sans fenêtre de réduire la taille d'instance et l'heure de création de l'objet

Les contrôles n'ont pas besoin d'une fenêtre.Les services qu'une fenêtre offre peuvent facilement être disponibles via une fenêtre partagée unique (généralement le conteneur) et d'un bit de distribuer le code.Avoir une fenêtre est principalement difficulté une inutile dans l'objet.

Lorsque l'activation sans fenêtre est utilisé, le conteneur (qui possède une fenêtre) permet de fournir des services qui auraient normalement fournis par la propre fenêtre du contrôle.Par exemple, si votre contrôle doit interroger le focus clavier, d'interroger la capture de la souris, ou pour obtenir un contexte de périphérique, ces opérations sont gérés par le conteneur.COleControlfonctions membres de sans fenêtres-exécution appellent ces opérations sur le conteneur.

Lorsque l'activation sans fenêtre est activé, le conteneur délègue les messages d'entrée à l'interface d' IOleInPlaceObjectWindowless du contrôle (une extension d' IOleInPlaceObject pour la prise en charge sans fenêtre).l'implémentation d'COleControl de cette interface acheminera ces messages dans la table des messages de votre contrôle, après avoir défini les coordonnées de la souris correctement.Vous pouvez traiter ces messages comme les messages des fenêtres ordinaires, en ajoutant les entrées correspondantes dans la table des messages.

Dans un contrôle sans fenêtre, vous devez toujours utiliser les fonctions membres d' COleControl à la place des fonctions membres correspondantes d' CWnd ou de leurs fonctions API Windows connexes.

Les objets de contrôle OLE peuvent également créer une fenêtre uniquement lorsqu'ils deviennent actifs, mais la quantité de travail nécessaire à la transition inactif- active monte et la vitesse de la transition descend.Dans certains cas lorsqu'il s'agit d'un problème : par exemple, considérez une grille des zones de texte.Cursoring haut et bas dans la colonne, chaque contrôle doit être activé sur place et ensuite désactivé.La vitesse de transition inactive/active affecte directement la vitesse de défilement.

Pour plus d'informations sur le développement d'une infrastructure de contrôle OLE, consultez les articles Contrôles ActiveX MFC et présentation : créer un programme de contrôle ActiveX MFC.Pour plus d'informations sur l'optimisation des contrôles OLE, y compris les contrôles sans fenêtre et sans scintillement, consultez Contrôles ActiveX MFC : optimisation.