FMX.Graphics.TBitmap.LoadFromFile

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure LoadFromFile(const AFileName: string);

C++

void __fastcall LoadFromFile(const System::UnicodeString AFileName);

Eigenschaften

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

Beschreibung

Lädt den Bildinhalt des aktuellen TBitmap-Objekts aus einer Datei.

Das vorhandene Bild wird ersetzt und die Größe des Objekts wird dem Bild entsprechend angepasst.

Hinweis: Falls das TBitmap in anderen Komponenten, wie TImage oder TImageControl enthalten ist, kann es sein, dass nicht das gesamte geladene Bild sichtbar ist.

Der Parameter AFileName gibt die Bilddatei an, die geladen werden soll.

TBitmap wird nicht verändert:

  • wenn AFileName nicht gefunden wird.
  • wenn AFileName nicht geöffnet werden kann, weil dieser in einem anderen Vorgang (exklusiv) verwendet wird.
  • wenn AFileName ein nicht unterstütztes Bildformat hat oder eigentlich kein Bild ist.

LoadFromFile löst in diesen Fällen keine Fehler aus.

Der optionale Parameter Rotate gibt an, um wie viel Grad das Bild beim Laden gegen den Uhrzeigersinn gedreht werden soll. Bei 180 wird das Bild z.B. um 180 Grad gedreht, jedoch kein Spiegelbild erstellt. Für die Größe des Objekts wird das kleinste Rechteck verwendet, in dem das gesamte gedrehte Bild angezeigt werden kann.

Hinweis: Eine Liste der von jeder Plattform unterstützten Formate finden Sie unter TBitmapCodecManager.

Siehe auch