FMX.Graphics.TBitmap.LoadFromFile

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure LoadFromFile(const AFileName: string);

C++

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

Propriétés

Type Visibilité  Source Unité  Parent
procedure
function
public
FMX.Graphics.pas
FMX.Graphics.hpp
FMX.Graphics TBitmap

Description

Charge le contenu d'image de l'objet TBitmap en cours à partir d'un fichier.

Toute image existante sera remplacée. L'objet est redimensionné pour qu'il s'adapte à l'image.

Remarque : La taille visible de l'image chargée peut être affectée si TBitmap est contenu dans d'autres composants, tels que TImage ou TImageControl.

Le paramètre AFileName spécifie le fichier image à charger.

TBitmap reste inchangé si :

  • AFileName est introuvable.
  • AFileName ne peut pas être ouvert car il est utilisé (exclusivement) par un autre processus.
  • AFileName a un format d'image non pris en charge ou n'est pas une image.

Dans ces cas, LoadFromFile ne déclenche pas d'erreur.

Le paramètre facultatif Rotate spécifie l'angle de la rotation anti-horaire de l'image lors du chargement. Par exemple, 180 fait pivoter l'image verticalement, mais ne la retourne pas en miroir. L'objet est redimensionné conformément au rectangle le plus petit qui puisse afficher l'image pivotée entière.

Remarque : Voir TBitmapCodecManager pour une liste des formats pris en charge par chaque plate-forme.

Voir aussi