Méthodes facultatives dans les interfaces de contrôle

L’implémentation d’une interface ne signifie pas nécessairement l’implémentation de toutes les méthodes de cette interface pour faire autre chose que retourner E_NOTIMPL ou S_OK le cas échéant. Le tableau suivant identifie les méthodes des interfaces répertoriées dans la rubrique Prise en charge d’une interface signifie qu’un contrôle peut implémenter de cette manière. Toute méthode non répertoriée ici doit être entièrement implémentée si l’interface est prise en charge.

IOleControl	Commentaires
GetControlInfo, OnMnemonic	Obligatoire pour les contrôles avec des mnémoniques.
IOleControl::OnAmbientPropertyChange	Obligatoire pour les contrôles qui utilisent des propriétés ambiantes.
IOleControl::FreezeEvents	Voir Gel des événements
IOleObject
SetMoniker	Obligatoire si le contrôle n’est pas marqué avec OLEMISC_CANTLINKINSIDE
GetMoniker	Obligatoire si le contrôle n’est pas marqué avec OLEMISC_CANTLINKINSIDE
InitFromData	Facultatif
GetClipboardData	Facultatif
SetExtent	Obligatoire uniquement pour DVASPECT_CONTENT
GetExtent	Obligatoire uniquement pour DVASPECT_CONTENT
SetColorScheme	Facultatif
DoVerb	Voir la note 1
IOleInPlaceObject
ContextSensitiveHelp	Facultatif
RéactiverAndUndo	Facultatif
IOleInPlaceActiveObject
ContextSensitiveHelp	Facultatif
IViewObject2
Freeze	Facultatif
Dégeler	Facultatif
GetColorSet	Facultatif
IPersistStream, IPersistStreamInit, IPersistMemory
GetSizeMax	Voir la remarque 2

1. Un contrôle avec des pages de propriétés doit prendre en charge IOleObject::D oVerb pour les verbes OLEIVERB_PROPERTIES et OLEIVERB_PRIMARY. Un contrôle qui peut être actif doit prendre en charge DoVerb pour le verbe OLEIVERB_INPLACEACTIVATE. Un contrôle qui peut être actif dans l’interface utilisateur doit également prendre en charge DoVerb pour le verbe OLEIVERB_UIACTIVATE.
2. Si un contrôle prend en charge IPersistStream ou IPersistStreamInit et peut retourner une valeur précise, il doit le faire.

Rubriques connexes

Contrôles