System.TypInfo.GetPropValue

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function GetPropValue(Instance: TObject; const PropName: string;
PreferStrings: Boolean): Variant;
function GetPropValue(Instance: TObject; PropInfo: PPropInfo;
PreferStrings: Boolean): Variant;

C++

extern DELPHI_PACKAGE System::Variant __fastcall GetPropValue(System::TObject* Instance, const System::UnicodeString PropName, bool PreferStrings = true)/* overload */;

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.TypInfo.pas
System.TypInfo.hpp
System.TypInfo System.TypInfo

Description

Récupère la valeur d'une propriété d'un composant sous la forme d'un variant.

GetPropValue utilise le système RTTI (Informations de type à l'exécution) de Delphi pour récupérer une propriété d'un composant sous la forme d'un variant.

Généralement, le type Variant ne peut pas conserver les types TObject, Set, pointeur de méthode et classe. Cependant, GetPropValue et SetPropValue peuvent gérer ces types. Dans ces cas, la valeur Variant renvoyée est uniquement utilisée par SetPropValue avec le même type de propriété. Vous ne devez pas utiliser cette valeur Variant renvoyée à d'autres fins.

Si vous voulez obtenir le type de propriété Variant, vous devez utiliser GetVariantProp au lieu de GetPropValue.

Dans une forme de cette fonction, la propriété de l'Instance d'objet est définie par un enregistrement PropInfo. GetPropInfo et GetPropList peuvent être utilisés pour obtenir un tel enregistrement.

Dans l'autre forme de cette fonction, le nom de la propriété, PropName, est donné explicitement.

Dans les deux formes de la fonction, la valeur de la propriété spécifiée est renvoyée sous la forme d'un variant.

Le paramètre PreferStrings spécifie si les valuers des propriétés du type énumération ou ensemble doivent être renvoyées sous forme de représentation chaîne.

Remarque :  Si la propriété spécifiée n'existe pas, ou si elle n'est pas une propriété publiée, une exception EPropertyError est déclenchée.

Voir aussi