Native FireMonkey-Windows-Steuerelemente

Nach oben zu Native FireMonkey-Steuerelemente

In diesem Thema werden die nativen Windows-Steuerelemente von FireMonkey beschrieben.

Darstellung von nativen FireMonkey-Windows-Steuerelementen

FireMonkey bietet für bestimmte visuelle Komponenten eine native Darstellung.

• Setzen Sie die Eigenschaft ControlType auf Styled, um das Steuerelement in der Standard-FireMonkey-Darstellung anzuzeigen. Styled ist der Vorgabewert von ControlType.
• Setzen Sie die Eigenschaft ControlType auf Platform, um dieses Steuerelement im nativen Stil anzuzeigen.

Verfügbare native FireMonkey-Windows-Steuerelemente

Die folgende Liste enthält alle Steuerelemente, die eine native Darstellung unterstützen:

• TEdit
• TMemo
• TPresentedScrollBox
• TPresentedVertScrollBox
• TPresentedHorzScrollBox
• TPresentedFramedScrollBox
• TPresentedFramedVertScrollBox

Visuelle Änderungen an nativen Windows-Steuerelementen

Wenn die Eigenschaft ControlType einer visuellen Komponente auf Platform gesetzt wird, ändert sich die Darstellung dieses Steuerelements im Formular-Designer, um anzuzeigen, dass es sich um ein natives Steuerelement handelt, und ein kleines telefonähnliches Symbol erscheint in der rechten unteren Ecke. Die folgenden Bilder zeigen das Aussehen von nativen Windows-Steuerelementen zur Entwurfszeit und zur Laufzeit, wenn die Eigenschaft ControlType auf Styled bzw. Platform gesetzt ist:

Steuerelement	Entwurfszeit		Laufzeit
	Styled	Platform	Styled	Platform
TEdit
TMemo
TPresentedScrollBox

Hinzufügen von nativen Windows-Steuerelementen zu Anwendungen

So fügen Sie Ihrer Anwendung native Windows-Steuerelemente hinzu:

1. Fügen Sie dem Formular eine Komponente hinzu, die die native Darstellung unterstützt (Liste der unterstützten Steuerelemente).
2. Setzen Sie im Objektinspektor auf der Registerkarte Eigenschaften die Eigenschaft ControlType auf Platform. Die Darstellung der Komponente zur Entwurfszeit ändert sich (siehe Visuelle Änderungen an nativen Windows-Steuerelementen).
3. Führen Sie Ihre Anwendung aus.

Alternativ können Sie den Wert von ControlType zur Laufzeit ändern. Um die native Darstellung für ein TEdit-Steuerelement zu ändern, fügen Sie Ihrer Anwendung den folgenden Code hinzu:

Delphi:

Edit1.ControlType := TPresentedControl.TControlType.Platform;

C++:

Edit1->ControlType = TPresentedControl::TControlType::Platform;

Kombinieren nativer Windows-Steuerelemente mit nicht nativen Steuerelementen

Die gemeinsame Verwendung von nicht nativen Steuerelementen mit nativen Steuerelementen wird nicht empfohlen, weil die nativen Steuerelemente die Z-Reihenfolge des Formulars nicht unterstützen: Ein natives Steuerelement befindet sich immer über allen Steuerelementen auf dem Formular. Es gibt aber einige nicht native Steuerelemente, die Sie mit nativen Steuerelementen kombinieren können, weil sie die Z-Reihenfolge unterstützen.

Die folgende Liste enthält alle Steuerelemente, die über die Eigenschaft ControlType verfügen und daher mit nativen Steuerelementen kombiniert werden können:

• TMultiView
• TButton
• TSpeedButton
• TColorButton
• TCornerButton
• TPopupBox
• TMagnifierGlass
• TPanel
• TLabel
• TCheckBox
• TRadioButton
• TGroupBox
• TStatusBar
• TToolBar
• TProgressBar
• TTrackBar
• TListView

Die folgende Liste enthält alle Steuerelemente, die nicht über die Eigenschaft ControlType verfügen, aber trotzdem mit nativen Steuerelementen kombiniert werden können:

• TWebBrowser
• TMediaPlayer

Vorteile von nativen Windows-Steuerelementen

Einige Steuerelemente unterstützen zusätzliche Funktionen, wenn sie als native Steuerelemente verwendet werden:

TMemo und TEdit

• Zusätzliche Einträge im Kontextmenü:
  • Rückgängig: Die letzte Aktion rückgängig machen.
  • Von rechts nach links lesen: Ändert die Lese-Reihenfolge und richtet den Text an der rechten Seite des Steuerelements aus. Weitere Informationen finden Sie unter Microsoft Documentation - To set right-to-left reading order (EN).
  • Unicode-Steuerzeichen anzeigen: Zeigt Unicode-Steuerzeichen an.
  • Unicode-Steuerzeichen einfügen: Fügt ein Unicode-Steuerzeichen ein.
  • IME öffnen: IME ist die Abkürzung für Eingabemethoden-Editor. Er ermöglicht die Eingabe von Japanisch, Chinesisch und Koreanisch in unterstützende Anwendungen unter anderen Versionen von Windows.

Die oben aufgeführten Funktionen stehen im Kontextmenü des Steuerelements zur Verfügung, daher unterscheiden sich die Kontextmenüs für Memo-Steuerelemente oder Eingabe-Steuerelemente für Styled und Platform:

Steuerelement	Kontextmenü (Styled)	Kontextmenü (Platform)
TMemo
TEdit

Beschränkungen von nativen Windows-Steuerelementen

Bevor Sie die nativen Steuerelemente verwenden, sollten Sie die folgenden Beschränkungen beachten:

• Native Steuerelemente unterstützen keine vordefinierten oder benutzerdefinierten Stile. Wenn die Eigenschaft ControlType eines nativen Steuerelements auf Platform gesetzt ist, wird der Wert der Eigenschaft StyleLookup ignoriert.
• Native Steuerelemente unterstützen transparente Hintergründe nur begrenzt. Transparente Steuerelemente werden nicht korrekt gezeichnet.
• Native Steuerelemente unterstützen die Z-Reihenfolge des Formulars nicht: Ein natives Steuerelement befindet sich immer über allen auf dem Formular verfügbaren FireMonkey-Steuerelementen. Einzelheiten finden Sie unter Kombinieren nativer Windows-Steuerelemente mit nicht nativen Steuerelementen.
• Die folgenden Ereignisbehandlungsroutinen werden nicht unterstützt und können nicht implementiert werden:
  • OnApplyStyleLookup
  • OnDblClick
  • OnGesture
• Die folgenden Ereignisse werden ausgelöst, aber Sie können sie nicht wie beabsichtigt verwenden (zum Überschreiben der Visualisierung des Steuerelements). Sie können Sie jedoch als Indikator für den Zeitpunkt verwenden, zu dem das System das Steuerelement neu zeichnet:
  • OnPaint
  • OnPainting

Es gibt auch einige steuerelementspezifische Beschränkungen:

TMemo

Das folgende Ereignis wird nicht unterstützt und kann nicht in TMemo implementiert werden:

• OnViewportPositionChange

TMemo und TEdit

Durch Festlegen der Parameterwerte in der OnKeyXX-Ereignisbehandlungsroutine wird die Tastatureingabe nicht unterdrückt. Wenn Sie beispielsweise in der Ereignisbehandlungsroutine OnKeyDown KeyChar := #0; festlegen und die s-Taste drücken, gibt die native Darstellung weiterhin das s aus, während in der mit Stilen versehenen Darstellung keine Ausgabe erfolgt.

Die obige Beschränkung betrifft diese Ereignisbehandlungsroutinen:

• OnKeyDown
• OnKeyUp

Die folgenden Ereignisse werden nicht unterstützt und können nicht in TMemo und TEdit implementiert werden:

• OnValidate

Hinweis: Das Ereignis OnValidating wird in der FireMonkey- und der nativen Darstellung von TMemo und TEdit ausgelöst.

Siehe auch

• Native FireMonkey-Steuerelemente
• Native FireMonkey-iOS-Steuerelemente
• TPresentedControl.ControlType
• Anpassen der Darstellung von FireMonkey-Listenansichten

Beispiele

• FireMonkey Native Controls (Beispiel)