FMX.Graphics.TCanvas.MeasureText

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure MeasureText(var ARect: TRectF; const AText: string; const WordWrap: Boolean; const Flags: TFillTextFlags;  const ATextAlign: TTextAlign; const AVTextAlign: TTextAlign = TTextAlign.Center); virtual;

C++

virtual void __fastcall MeasureText(System::Types::TRectF &ARect, const System::UnicodeString AText, const bool WordWrap, const TFillTextFlags Flags, const Fmx::Types::TTextAlign ATextAlign, const Fmx::Types::TTextAlign AVTextAlign = (Fmx::Types::TTextAlign)(0x0));

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
FMX.Graphics.pas
FMX.Graphics.hpp
FMX.Graphics TCanvas

Beschreibung

Hinweis: MeasureText ist NICHT veraltet.

Misst den Bereich des TCanvas-Objekts, der von einem Text-String mit den angegebenen Ausrichtungen, dem angegebenen Flag und der aktuellen Schriftart eingenommen wird.

MeasureText wird von den TCanvas-Nachkommen implementiert, um den Rechteckbereich festzulegen, der von einem Text-String mit dem angegebenen Zeilenumbruch, dem angegebenen Flag, den angegebenen Ausrichtungen und der aktuellen Schriftart eingenommen wird. Der String-Text ist von einem Rechteck umgeben.

Der Parameter ARect gibt das umgebende Rechteck des Texts an. ARect ist die Rückgabevariable. Wenn ARect nicht initialisiert ist, befindet sich der Mittelpunkt des zurückgegebenen Rechtecks an der Position (0,0).

Der Parameter AText gibt den Text an, der gemessen werden soll.

Der Parameter WordWrap gibt die Zeilenumbruch-Option an. Der Wert True gibt an, dass ein Zeilenumbruch erfolgt, um den Textüberlauf über den Layout-Bereich zu vermeiden. Der Wert False gibt an, dass Wörter in derselben Zeile angezeigt werden, selbst wenn der Text nicht in den Layout-Bereich passt.

Der Parameter Flags gibt die Leserichtung von AText an.

ATextAlign ist die horizontale Ausrichtung des Texts innerhalb von ARect.

AVTextAlign ist die vertikale Ausrichtung des Texts innerhalb von ARect. AVTextAlign ist optional und standardmäßig auf Center gesetzt.

Siehe auch