Propriétés standard

OLE définit un ensemble de DISPID standard pour les trois types de propriétés : contrôle, ambiant et étendu. Les tableaux suivants répertorient ces normes pour les propriétés de contrôle, les propriétés ambiantes et les propriétés étendues.

Propriété de contrôle	Type	Description
BackColor, ForeColor, FillColor, BorderColor	OLE_COLOR	Jeu de couleurs du contrôle
BackStyle, FillStyle, BorderStyle, BorderWidth, BorderVisible, DrawStyle, DrawWidth	court ou long	Bits qui définissent le comportement visuel d’un contrôle, tels que le fait d’être solide ou transparent, d’avoir des bordures épaisses ou minces, des styles de traits, etc.
Police	Idispatch*	Police utilisée dans le contrôle, qui est un pointeur IDispatch vers un objet de police standard. Pour plus d’informations, consultez Standard Font Object .
Légende, Texte	BSTR	Chaînes contenant l’étiquette du contrôle (le légende) ou son contenu textuel (le texte). Notez que le légende ne nomme pas nécessairement le contrôle dans le conteneur. Consultez la propriété Name étendue dans le tableau suivant.
activé	BOOL	Détermine si le contrôle est activé ou désactivé. S’il est désactivé, le contrôle est probablement grisé.
Fenêtre	HWND	Poignée de fenêtre du contrôle, le cas échéant.
TabStop	BOOL	Détermine si ce contrôle est un taquet de tabulation.

Propriété ambiante	Type	Description
BackColor, ForeColor	OLE_COLOR	Fournit des contrôles avec les couleurs d’arrière-plan et de premier plan par défaut. L’utilisation par un contrôle est facultative.
Police	Idispatch*	Pointeur vers un objet de police standard qui définit la police par défaut du formulaire. L’utilisation par un contrôle est facultative. Pour plus d’informations, consultez Standard Font Object .
LocaleID	LCID	Langue utilisée dans le conteneur. L’utilisation par un contrôle est recommandée.
Usermode	BOOL	Indique si le conteneur est en mode création (FALSE) ou en mode d’exécution (TRUE), qu’un contrôle doit utiliser pour modifier ses fonctionnalités disponibles si nécessaire.
UIDead	BOOL	Décrit si le conteneur est en mode où les contrôles doivent ignorer l’entrée utilisateur. Cela s’applique indépendamment de UserMode. Un conteneur peut toujours définir UIDead sur TRUE en mode création, et peut le définir sur TRUE lorsqu’il a atteint un point d’arrêt ou tel pendant le mode d’exécution. Un contrôle doit prêter attention à cette propriété.
MessageReflect	BOOL	Spécifie si le conteneur souhaite recevoir des messages Windows tels que WM_CTLCOLOR, WM_DRAWITEM, WM_PARENTNOTIFY, etc. en tant qu’événements.
SupportsMnemonics	BOOL	Indique si le conteneur traite des mnémoniques ou non. Un contrôle peut faire ce qu’il veut avec ces informations, par exemple sans souligner les caractères qu’il utiliserait normalement comme mnémonique.
ShowGrabHandles, ShowHatching	BOOL	Indique si un contrôle doit afficher une bordure de hachure ou des poignées de saisie (dans la bordure de la trappe) lorsqu’il est actif sur place. Les contrôles doivent respecter ces propriétés, ce qui donne au conteneur le contrôle ultime sur qui dessine réellement ces bits d’interface utilisateur. Un conteneur de contrôle peut vouloir dessiner son propre au lieu de s’appuyer sur chaque contrôle, auquel cas ces éléments ambiants seront toujours FALSE.
DisplayAsDefault	BOOL	Le conteneur expose un TRUE pour cette propriété par le biais de n’importe quel site contenant ce qui est marqué comme bouton par défaut lorsque le contrôle de bouton doit dessiner lui-même avec un cadre par défaut plus épais.

Propriété étendue	Type	Description
Nom	BSTR	Nom du conteneur pour le contrôle.
Visible	BOOL	Visibilité du contrôle.
Parent	Idispatch*	Dispinterface du formulaire contenant le contrôle.
Par défaut, Annuler	BOOL	Indique si ce contrôle est le bouton par défaut ou annuler.

Toutes ces propriétés standard ont des valeurs DISPID négatives, ce qui indique leur status standard.

Notez que pour éviter les conflits dans les symboles programmatiques de ces DISPID, toutes les propriétés ambiantes reçoivent des symboles sous la forme DISPID_AMBIENT_propriété comme dans DISPID_AMBIENT_FORECOLOR. Tous les autres symboles utilisent DISPID_propriété comme d’habitude .

Certaines propriétés ambiantes, ainsi que les propriétés de contrôle, impliquent des couleurs. Le type OLE_COLOR mentionné dans les tables précédentes peut faire référence à un type COLORREF standard, à un index d’une palette, à un index relatif à la palette ou à un index de couleur système utilisé avec la fonction GetSysColor . La fonction OleTranslateColor convertit un type OLE_COLOR en type COLORREF en fonction d’une palette.

Rubriques connexes

Propriétés du contrôle