Standaardeigenschappen

OLE definieert een set standaard-DISPID's voor alle drie de eigenschappen: controle, omgeving en uitgebreid. De volgende tabellen bevatten deze standaarden voor besturingseigenschappen, omgevingseigenschappen en uitgebreide eigenschappen.

Besturingselementeigenschap	Type	Beschrijving
BackColor, ForeColor, FillColor, BorderColor	OLE_COLOR	Het kleurenschema van het besturingselement
BackStyle, FillStyle, BorderStyle, BorderWidth, BorderVisible, DrawStyle, DrawWidth	korte of lange	Bits die het visuele gedrag van een besturingselement definiëren, zoals effen of transparant zijn, met dikke of dunne randen, lijnstijlen enzovoort.
Lettertype	IDispatch *	Het lettertype dat in het besturingselement wordt gebruikt, is een IDispatch aanwijzer naar een standaardlettertypeobject. Zie standaardlettertypeobject voor meer informatie.
Bijschrift, tekst	BSTR-	Tekenreeksen met het label van het besturingselement (het bijschrift) of de bijbehorende tekstuele inhoud (de tekst). Houd er rekening mee dat het besturingselement in de container niet noodzakelijkerwijs een naam krijgt voor het bijschrift. Zie de eigenschap uitgebreide naam in de volgende tabel.
Ingeschakeld	BOOL-	Bepaalt of het besturingselement is ingeschakeld of uitgeschakeld. Als dit is uitgeschakeld, wordt het besturingselement waarschijnlijk grijs weergegeven.
Venster	HWND-	De venstergreep van het besturingselement, als het er een heeft.
TabStop	BOOL-	Bepaalt of dit besturingselement een tabstop is.

Omgevingseigenschap	Type	Beschrijving
BackColor, ForeColor	OLE_COLOR	Biedt besturingselementen met de standaardachtergrond- en voorgrondkleuren. Gebruik door een besturingselement is optioneel.
Lettertype	IDispatch *	Een aanwijzer naar een standaardlettertypeobject dat het standaardlettertype voor het formulier definieert. Gebruik door een besturingselement is optioneel. Zie standaardlettertypeobject voor meer informatie.
LocaleID	LCID-	De taal die in de container wordt gebruikt. Gebruik door een besturingselement wordt aanbevolen.
UserMode	BOOL-	Beschrijft of de container zich in een ontwerpmodus bevindt (FALSE) of de uitvoeringsmodus (TRUE), die een besturingselement indien nodig moet gebruiken om de beschikbare functionaliteit te wijzigen.
UIDead	BOOL-	Beschrijft of de container zich in een modus bevindt waarin besturingselementen gebruikersinvoer moeten negeren. Dit geldt ongeacht UserMode. Een container kan UIDead altijd instellen op TRUE- in de ontwerpmodus en kan deze instellen op TRUE- wanneer het een onderbrekingspunt of dergelijke bereikt tijdens de uitvoeringsmodus. Een besturingselement moet aandacht besteden aan deze eigenschap.
MessageReflect	BOOL-	Hiermee geeft u op of de container Windows-berichten zoals WM_CTLCOLOR, WM_DRAWITEM, WM_PARENTNOTIFY, enzovoort als gebeurtenissen wilt ontvangen.
OndersteuntMnemonics	BOOL-	Beschrijft of de container mnemonics verwerkt of niet. Een besturingselement kan doen wat het met deze informatie wil, zoals geen onderstrepingstekens die normaal gesproken als een nemonic worden gebruikt.
ShowGrabHandles, ShowHatching	BOOL-	Beschrijft of een besturingselement een luikrand of handgrepen (in de rand van het luik) moet weergeven wanneer deze actief is. Besturingselementen moeten deze eigenschappen gehoorzamen, waardoor de container uiteindelijk controle heeft over wie deze bits van de gebruikersinterface daadwerkelijk tekent. Een besturingscontainer wil mogelijk een eigen container tekenen in plaats van te vertrouwen op elk besturingselement. In dat geval worden deze omgevingen altijd ONWAAR.
DisplayAsDefault	BOOL-	De container toont een TRUE voor deze eigenschap via een site die bevat wat is gemarkeerd als de standaardknop wanneer het knopbesturingselement zichzelf met een dikker standaardframe moet tekenen.

Uitgebreide eigenschap	Type	Beschrijving
Naam	BSTR-	De naam van de container voor het besturingselement.
Zichtbaar	BOOL-	De zichtbaarheid van het besturingselement.
Ouder	IDispatch *	De dispinterface van het formulier met het besturingselement.
Standaard, Annuleren	BOOL-	Geeft aan of dit besturingselement de standaardknop of de knop Annuleren is.

Al deze standaardeigenschappen hebben negatieve DISPID-waarden, wat de standaardstatus aangeeft.

Houd er rekening mee dat om conflicten in de programmatische symbolen voor deze DISPID's te voorkomen, alle omgevingseigenschappen symbolen krijgen in de vorm DISPID_AMBIENT_eigenschap zoals in DISPID_AMBIENT_FORECOLOR. Alle andere symbolen gebruiken DISPID_eigenschap zoals gebruikelijk.

Sommige omgevingseigenschappen, evenals besturingseigenschappen, hebben betrekking op kleuren. Het OLE_COLOR type dat in de vorige tabellen wordt genoemd, kan verwijzen naar een standaard COLORREF type, een index naar een palet, een palet-relatieve index of een systeemkleurindex die wordt gebruikt met de functie GetSysColor. De functie OleTranslateColor converteert een OLE_COLOR type naar een COLORREF- type dat een palet krijgt.

Verwante onderwerpen

eigenschappen van besturingselementen