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é Control |
Type |
Description |
BackColor, ForeColor, FillColor, BorderColor
|
OLE_COLOR
|
Jeu de couleurs du contrôle
|
BackStyle, FillStyle, BorderStyle, BorderWidth, BorderVisible, DrawStyle, DrawWidth
|
courte ou longue
|
Bits qui définissent le comportement visuel d’un contrôle, comme être solide ou transparent, ayant des bordures épaisses ou minces, des styles de trait, 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 (la légende) ou son contenu textuel (le texte). Notez que la 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é. Si elle est désactivée, le contrôle est probablement grisé.
|
Fenêtre
|
HWND
|
Handle de fenêtre du contrôle, s’il en a un.
|
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 pour le 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
|
Décrit si le conteneur est en mode conception (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
|
Décrit si le conteneur traite les mnémoniques ou non. Un contrôle peut faire ce qu’il veut avec ces informations, comme ne pas souligner les caractères qu’il utiliserait normalement comme un mnémonique.
|
ShowGrabHandles, ShowHatching
|
BOOL
|
Décrit si un contrôle doit afficher une bordure de hachure ou saisir des poignées (dans la bordure de hachure) lorsqu’il est actif sur place. Les contrôles doivent obéir à 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 sa propre propriété au lieu de s’appuyer sur chaque contrôle, auquel cas ces environnements ambiants seront toujours FAUX.
|
DisplayAsDefault
|
BOOL
|
Le conteneur expose une TRUE pour cette propriété par le biais de ce site contient ce qui est marqué comme bouton par défaut lorsque le contrôle bouton bouton doit se 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, indiquant leur état 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 à une palette, un index relatif à une 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.
-
propriétés de contrôle