System.TypInfo.GetUnicodeStrProp

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function GetUnicodeStrProp(Instance: TObject; const PropName: string): UnicodeString;
function GetUnicodeStrProp(Instance: TObject; PropInfo: PPropInfo): UnicodeString;

C++

extern DELPHI_PACKAGE System::UnicodeString __fastcall GetUnicodeStrProp _DEPRECATED_ATTRIBUTE1("use GetStrProp") (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

Avertissement : GetUnicodeStrProp est obsolète. Veuillez utiliser GetStrProp.

Renvoie la valeur d'une propriété de composant de type UnicodeString.

GetUnicodeStrProp 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 là où cette propriété est un UnicodeString. Une chaîne vide est renvoyée si la propriété n'est pas de ce type.

Dans une forme de cette fonction, la propriété est recherchée en utilisant les données du paramètre 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 chaîne.

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.

Voir aussi