Standardeigenschaften

OLE definiert eine Reihe von Standard-DISPIDs für alle drei Arten von Eigenschaften: Steuerung, Umgebung und erweitert. In den folgenden Tabellen sind diese Standards für Steuerelementeigenschaften, Umgebungseigenschaften und erweiterte Eigenschaften aufgeführt.

Control-Eigenschaft	Art	Beschreibung
BackColor, ForeColor, FillColor, BorderColor	OLE_COLOR	Farbschema des Steuerelements
BackStyle, FillStyle, BorderStyle, BorderWidth, BorderVisible, DrawStyle, DrawWidth	kurzen oder langen	Bits, die das visuelle Verhalten eines Steuerelements definieren, z. B. einfarbig oder transparent, mit dicken oder dünnen Rahmen, Linienarten usw.
Schriftart	IDispatch *	Die im Steuerelement verwendete Schriftart, bei der es sich um eine IDispatch Zeiger auf ein Standardschriftartobjekt handelt. Weitere Informationen finden Sie unter Standard Font Object.
Beschriftung, Text	BSTR-	Zeichenfolgen, die die Beschriftung des Steuerelements (die Beschriftung) oder deren Textinhalte (den Text) enthalten. Beachten Sie, dass die Beschriftung das Steuerelement nicht unbedingt im Container benament. Weitere Informationen finden Sie in der folgenden Tabelle in der erweiterten Name-Eigenschaft.
Ermöglichte	BOOL-	Bestimmt, ob das Steuerelement aktiviert oder deaktiviert ist. Wenn das Steuerelement deaktiviert ist, ist das Steuerelement wahrscheinlich grau dargestellt.
Fenster	HWND-	Der Fensterziehpunkt des Steuerelements, sofern es über einen verfügt.
Tabstop	BOOL-	Bestimmt, ob es sich bei diesem Steuerelement um einen Tabstopp handelt.

Ambient-Eigenschaft	Art	Beschreibung
BackColor, ForeColor	OLE_COLOR	Stellt Steuerelemente mit den Standardhintergrund- und Vordergrundfarben bereit. Die Verwendung durch ein Steuerelement ist optional.
Schriftart	IDispatch *	Ein Zeiger auf ein Standardschriftartobjekt, das die Standardschriftart für das Formular definiert. Die Verwendung durch ein Steuerelement ist optional. Weitere Informationen finden Sie unter Standard Font Object.
LocaleID	LCID-	Die im Container verwendete Sprache. Die Verwendung durch ein Steuerelement wird empfohlen.
UserMode	BOOL-	Beschreibt, ob sich der Container in einem Entwurfsmodus (FALSE) oder im Ausführungsmodus (TRUE) befindet, mit dem ein Steuerelement bei Bedarf seine verfügbare Funktionalität ändern soll.
UIDead	BOOL-	Beschreibt, ob sich der Container in einem Modus befindet, in dem Steuerelemente Benutzereingaben ignorieren sollen. Dies gilt unabhängig von UserMode. Ein Container legt UIDead möglicherweise immer auf "TRUE" fest, im Entwurfsmodus und kann auf "TRUE" festlegen, wenn er während des Ausführungsmodus einen Haltepunkt oder eine solche erreicht hat. Ein Steuerelement muss auf diese Eigenschaft achten.
MessageReflect	BOOL-	Gibt an, ob der Container Windows-Nachrichten wie WM_CTLCOLOR, WM_DRAWITEM, WM_PARENTNOTIFY usw. als Ereignisse empfangen möchte.
SupportsMnemonics	BOOL-	Beschreibt, ob der Container Mnemonics verarbeitet oder nicht. Ein Steuerelement kann alles tun, was es mit diesen Informationen will, z. B. nicht unterstrichene Zeichen, die normalerweise als Mnemonic verwendet werden.
ShowGrabHandles, ShowHatching	BOOL-	Beschreibt, ob ein Steuerelement einen Schlupfrahmen oder Ziehpunkte (im Schlupfrahmen) anzeigen soll, wenn es aktiv ist. Steuerelemente müssen diesen Eigenschaften gehorchen, sodass der Container letztendlich steuern kann, wer diese Bits der Benutzeroberfläche zeichnet. Ein Steuerelementcontainer kann sich selbst zeichnen, anstatt sich auf jedes Steuerelement zu verlassen, in diesem Fall werden diese Umgebungsarten immer FALSE.
DisplayAsDefault	BOOL-	Der Container macht einen TRUE- für diese Eigenschaft über jede Website verfügbar, die als Standardschaltfläche gekennzeichnet ist, wenn sich das Schaltflächensteuerelement mit einem dickeren Standardrahmen selbst zeichnen soll.

Erweiterte Eigenschaft	Art	Beschreibung
Name	BSTR-	Der Name des Containers für das Steuerelement.
Sichtbar	BOOL-	Die Sichtbarkeit des Steuerelements.
Elternteil	IDispatch *	Die Dispinterface des Formulars, das das Steuerelement enthält.
Standard, Abbrechen	BOOL-	Gibt an, ob es sich bei diesem Steuerelement um die Standard- oder Abbruchschaltfläche handelt.

Alle diese Standardeigenschaften weisen negative DISPID-Werte auf, die ihren Standardstatus angeben.

Beachten Sie, dass um Konflikte in den programmgesteuerten Symbolen für diese DISPIDs zu vermeiden, werden alle Umgebungseigenschaften in form DISPID_AMBIENT_Eigenschaft wie in DISPID_AMBIENT_FORECOLOR. Alle anderen Symbole verwenden DISPID_Eigenschaft wie gewohnt.

Einige Umgebungseigenschaften sowie Steuerelementeigenschaften umfassen Farben. Der in den vorherigen Tabellen erwähnte OLE_COLOR Typ kann auf einen StandardCOLORREF- Typ, einen Index zu einer Palette, einen palettenrelativen Index oder einen Systemfarbindex verweisen, der mit der GetSysColor--Funktion verwendet wird. Die OleTranslateColor--Funktion konvertiert einen OLE_COLOR Typ in einen COLORREF- Typ einer Palette.

Verwandte Themen

-Steuerelementeigenschaften