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.