Partager via


Classe de COleControl

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

class COleControl : public CWnd

Membres

77hhz71h.collapse_all(fr-fr,VS.110).gifConstructeurs publics

Nom

Description

COleControl::COleControl

Crée un objet COleControl.

77hhz71h.collapse_all(fr-fr,VS.110).gifMé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 .

77hhz71h.collapse_all(fr-fr,VS.110).gifMé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.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

COleControl

Configuration requise

Header: afxctl.h

Voir aussi

Référence

Classe de COlePropertyPage

CWnd, classe

Graphique de la hiérarchie

Classe de CFontHolder

Classe de CPictureHolder

Concepts

exemple MFC CIRC3

exemple MFC TESTHELP