Standardeigenschaften
OLE definiert eine Reihe von Standard-DISPIDs für alle drei Arten von Eigenschaften: Steuerelement, Umgebung und erweitert. In den folgenden Tabellen sind diese Standards für Steuerelementeigenschaften, Umgebungseigenschaften und erweiterte Eigenschaften aufgeführt.
| Control-Eigenschaft | Typ | BESCHREIBUNG |
|---|---|---|
| BackColor, ForeColor, FillColor, BorderColor |
OLE_COLOR |
Farbschema des Steuerelements |
| BackStyle, FillStyle, BorderStyle, BorderWidth, BorderVisible, DrawStyle, DrawWidth |
kurz oder lang |
Bits, die das visuelle Verhalten eines Steuerelements definieren, z. B. einfarbig oder transparent, mit dicken oder dünnen Rahmen, Linienstilen usw. |
| Schriftart |
Idispatch* |
Die im -Steuerelement verwendete Schriftart, bei der es sich um einen IDispatch-Zeiger auf ein Standardschriftartobjekt handelt. Weitere Informationen finden Sie unter Standardschriftartobjekt . |
| Beschriftung, Text |
BSTR |
Zeichenfolgen, die die Bezeichnung des Steuerelements (die Untertitel) oder den Textinhalt (text) des Steuerelements enthalten. Beachten Sie, dass der Untertitel das Steuerelement im Container nicht unbedingt benennen muss. Sehen Sie sich die erweiterte Name-Eigenschaft in der folgenden Tabelle an. |
| Aktiviert |
BOOL |
Bestimmt, ob das Steuerelement aktiviert oder deaktiviert ist. Wenn es deaktiviert ist, ist das Steuerelement wahrscheinlich abgeblendet. |
| Fenster |
HWND |
Das Fensterhandle des Steuerelements, sofern es über einen verfügt. |
| TabStop |
BOOL |
Bestimmt, ob es sich bei diesem Steuerelement um einen Tabstopp handelt. |
| Ambient-Eigenschaft | Typ | BESCHREIBUNG |
|---|---|---|
| BackColor, ForeColor |
OLE_COLOR |
Stellt Steuerelemente mit den Standardmäßigen Hintergrund- 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 Standardschriftartobjekt . |
| LocaleID |
LCID |
Die sprache, die im Container verwendet wird. Die Verwendung durch ein Steuerelement wird empfohlen. |
| Usermode |
BOOL |
Beschreibt, ob sich der Container in einem Entwurfsmodus (FALSE) oder im Ausführungsmodus (TRUE) befindet, den ein Steuerelement verwenden sollte, um die verfügbare Funktionalität nach Bedarf zu ändern. |
| 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 kann UIDead im Entwurfsmodus immer auf TRUE festlegen und auf TRUE festlegen, wenn er im Ausführungsmodus einen Haltepunkt oder einen solchen 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 mit diesen Informationen alles tun, was es möchte, z. B. keine Unterstreichungszeichen, die es normalerweise als mnemonisch verwenden würde. |
| ShowGrabHandles, ShowHatching |
BOOL |
Beschreibt, ob ein Steuerelement einen Schraffurrahmen oder Haltegriffe (im Schraffurrahmen) anzeigen soll, wenn es aktiv ist. Steuerelemente müssen diesen Eigenschaften gehorchen und dem Container die ultimative Kontrolle darüber geben, wer diese Elemente der Benutzeroberfläche tatsächlich zeichnet. Ein Steuerelementcontainer möchte möglicherweise einen eigenen zeichnen, anstatt sich auf jedes Steuerelement zu verlassen. In diesem Fall sind diese Umgebungsumgebung immer FALSE. |
| DisplayAsDefault |
BOOL |
Der Container macht einen TRUE für diese Eigenschaft über den Standort verfügbar, der als Standardschaltfläche markiert ist, wenn sich das Schaltflächensteuerelement selbst mit einem dickeren Standardrahmen zeichnen soll. |
| Erweiterte Eigenschaft | Typ | BESCHREIBUNG |
|---|---|---|
| Name |
BSTR |
Der Name des Containers für das Steuerelement. |
| Sichtbar |
BOOL |
Die Sichtbarkeit des Steuerelements. |
| Parent |
Idispatch* |
Das Dispinterface des Formulars, das das Steuerelement enthält. |
| Standard, Abbrechen |
BOOL |
Gibt an, ob dieses Steuerelement die Standard- oder Abbrechenschaltfläche ist. |
Alle diese Standardeigenschaften weisen negative DISPID-Werte auf, die ihre Standard-status angeben.
Beachten Sie, dass alle Umgebungseigenschaften Symbole in der Form DISPID_AMBIENT_Eigenschaften wie in DISPID_AMBIENT_FORECOLOR erhalten, um Konflikte in den programmgesteuerten Symbolen zu vermeiden. Alle anderen Symbole verwenden wie gewohnt DISPID_Eigenschaften .
Einige Umgebungseigenschaften sowie Steuerelementeigenschaften umfassen Farben. Der in den vorherigen Tabellen erwähnte OLE_COLOR-Typ kann auf einen COLORREF-Standardtyp , einen Index für eine 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 , wenn eine Palette angegeben wird.