System.SysUtils.Exception.CreateResFmtHelp

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

constructor CreateResFmtHelp(ResStringRec: PResStringRec; const Args: array of const;
AHelpContext: Integer); {$IFNDEF NEXTGEN} overload; {$ENDIF !NEXTGEN}
constructor CreateResFmtHelp(Ident: NativeUInt; const Args: array of const;
AHelpContext: Integer); overload;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
constructor public System.SysUtils.pas System.SysUtils Exception

Beschreibung

Erzeugt eine Instanz einer Exception mit einer Hilfekontext-ID und einem formatierten Meldungs-String, der aus den Ressourcen der Anwendung geladen wird.

Eine durch einen Aufruf von CreateResFmtHelp erzeugte Exception verfügt über

1einen Meldungs-String, der aus den Ressourcen der Anwendung geladen und mit zusätzlichen Informationen formatiert wird.

2eine Hilfekontext-ID.

Ressourcen werden während des Compilierens in die ausführbare Datei der Anwendung eingebunden. Während des Entwurfs befinden sie in separaten Ressourcedateien. Ident ist die eindeutige Kennung der String-Ressource für die Fehlermeldung. Wenn Ident keine gültige Ressourcen-ID ist, erzeugt CreateResFmtHelp für die Exception einen leeren Meldungs-String.

ResStringRec ist ein Zeiger auf einen Ressourcenstring. Die Syntax lautet folgendermaßen:



resourcestring sMyNewErrorMessage = 'Illegal value: %s';
const IDH_MYNEWERROR: Integer = 30000;
...
Exception.CreateResFmt(@sMyNewErrorMessage, [-1], IDH_MYNEWERROR);



Args ist ein Konstanten-Array, dessen Werte

aufgrund der im String eingebetteten Formatierungsanweisungen formatiert und

in den Meldungs-String eingefügt werden.

CreateResFmtHelp bedient sich der Funktion Format, um die Werte aus Args in den Meldungs-String einzusetzen.

AHelpContext ist eineGanzzahl, die die ID der kontextsensitiven Hilfe für die Exception festlegt.

Siehe auch