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

Misst den von einem Textstring mit der angegebenen Ausrichtung, dem festgelegten Flag und der aktuellen Schriftart auf dem TCanvas belegten Platz.

MeasureText wird von den Nachkommen von TCanvas implementiert, um den rechteckigen Bereich zu ermitteln, den ein Textstring mit dem angegebenen Umbruch, der Ausrichtung, dem Flag und der aktuellen Schriftart belegt. Der String-Text ist von einem Rechteck umgeben.

Der Parameter ARect gibt den maximalen Größenbereich des umgebenden Rechtecks an. ARect ist die Rückgabevariable. Wenn ARect nicht initialisiert ist, liegt der Mittelpunkt des Rechtecks bei (0,0).

Der Parameter AText gibt den zu messenden Text an.

Der Parameter WordWrap gibt die Zeilenumbruchsoption an. Bei True werden Wörter in eine neue Zeile umbrochen, um den Überlauf des Textes über das Layout-Feld zu verhindern. Bei False werden Wörter in derselben Zeile behalten, auch wenn der Text über das Layout-Feld hinausgeht.

Der Parameter Flags gibt die Leserichtung von AText an.

ATextAlign ist die horizontale Ausrichtung des Textes in ARect.

AVTextAlign ist die vertikale Ausrichtung des Textes in ARect. AVTextAlign ist optional. Standardmäßig ist dieser Parameter auf Center gesetzt.

Siehe auch