System.TypInfo.GetOrdProp
Delphi
function GetOrdProp(Instance: TObject; const PropName: string): NativeInt;
function GetOrdProp(Instance: TObject; PropInfo: PPropInfo): NativeInt;
C++
extern DELPHI_PACKAGE NativeInt __fastcall GetOrdProp(System::TObject* Instance, const System::UnicodeString PropName)/* overload */;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.TypInfo.pas System.TypInfo.hpp |
System.TypInfo | System.TypInfo |
Description
Renvoie la valeur d'une propriété de composant de type ordinal ou classe.
GetOrdProp utilise le système RTTI (Informations de type à l'exécution) de Delphi pour renvoyer la valeur en cours d'une propriété d'un composant. Cette propriété doit être de type scalaire, comme Integer, Char, WideChar ou de type classe.
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 en cours de la propriété est renvoyée sous la forme d'une valeur entière NativeInt.
La valeur intrinsèque de cette fonction est de permettre la récupération des propriétés d'un composant sans devoir coder en dur le nom de la propriété. Cela permet un traitement des composants visuels de masse à l'exécution.
Utilisez GetPropValue pour récupérer une valeur de propriété où le type est inconnu - elle est renvoyée dans un type Variant.
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.