VBA-Programmierung in Microsoft Excel

Tutorial: Die Dialoge

SpecialEffect-Eigenschaft

Gibt die Art der Darstellung eines Objekts an.

Syntax

Für Kontrollkästchen-, Optionsfeld- oder Umschaltfeld-Steuerelemente (CheckBox, OptionButton oder ToggleButton)
object.SpecialEffect [= fmButtonEffect]

Für andere Steuerelemente
object.SpecialEffect [= fmSpecialEffect]

Die Syntax für die SpecialEffect-Eigenschaft besteht aus folgenden Teilen:

Teil Beschreibung
object Erforderlich. Ein gültiges Objekt.
fmButtonEffect Optional. Die gewünschte Darstellung für ein Kontrollkästchen-, Optionsfeld- oder Umschaltfeld-Steuerelement.
fmSpecialEffect Optional. Die gewünschte Darstellungsart eines Objekts, das kein Kontrollkästchen-, Optionsfeld- oder Umschaltfeld-Steuerelement ist.

Einstellungen

Die Einstellungen für fmSpecialEffect sind:

Konstante Wert Beschreibung
fmSpecialEffectFlat 0 Das Objekt erscheint flach, hebt sich vom umgebenden Formular durch einen Rahmen, eine Farbänderung oder beides ab. Dies ist für das Anzeige-Steuerelement (Image) und Bezeichnungsfeld-Steuerelement (Label) die Voreinstellung und für alle Steuerelemente gültig.
fmSpecialEffectRaised 1 Das Objekt ist am oberen und linken Rand hervorgehoben und hat am unteren und rechten Rand einen Schatten. Diese Einstellung ist für Kontrollkästchen und Optionsfelder nicht gültig.
fmSpecialEffectSunken 2 Das Objekt hat am oberen und linken Rand einen Schatten; der untere und rechte Rand sind heller. Das Steuerelement und der zugehörige Rahmen erscheinen wie in das Formular "eingelassen", das dieses Steuerelement enthält. Dies ist die Voreinstellung für das Kontrollkästchen- und das Optionsfeld-Steuerelement und ist für alle Steuerelemente gültig (Voreinstellung).
fmSpecialEffectEtched 3 Der Rahmen erscheint in die Ränder des Steuerelements "eingemeißelt". Diese Einstellung ist für Kontrollkästchen und Optionsfelder nicht gültig.
fmSpecialEffectBump 6 Das Objekt ist am unteren und rechten Rand hervorgehoben und erscheint am oberen und linken Rand flach. Diese Einstellung ist für Kontrollkästchen und Optionsfelder nicht gültig.

Bei einem Rahmen-Steuerelement (Frame) ist der Standardwert fmSpecialEffectSunken.

Beachten Sie, dass nur fmSpecialEffectFlat und fmSpecialEffectSunken (0 und 2) als Werte für das Kontrollkästchen-, Optionsfeld- und Umschaltfeld-Steuerelement zulässig sind. Für andere Steuerelemente sind alle aufgeführten Werte zulässig.

Hinweise

Sie können entweder die SpecialEffect- oder die BorderStyle-Eigenschaft verwenden, um die Darstellungsart der Ränder für ein Steuerelement anzugeben, jedoch nicht beide Eigenschaften. Wenn Sie einen Wert für eine dieser Eigenschaften angeben, der ungleich Null ist, legt das System den Wert der anderen Eigenschaft auf Null fest. Wenn Sie z.B. SpecialEffect auf den Wert fmSpecialEffectRaised festlegen, legt das System BorderStyle auf den Wert Null (fmBorderStyleNone) fest.

Bei einem Rahmen-Steuerelement wird BorderStyle ignoriert, wenn SpecialEffect den Wert fmSpecialEffectFlat hat.

SpecialEffect verwendet die Systemfarben, um die zugehörigen Rahmen zu definieren.

Anmerkung   Obwohl die SpecialEffect-Eigenschaft für das Umschaltfeld-Steuerelement vorhanden ist, kann diese Eigenschaft nicht verwendet werden. Bei einem Umschaltfeld-Steuerelement können Sie für diese Eigenschaft weder einen Wert setzen noch zurückgeben.