System.SysUtils.Exception.CreateResFmtHelp
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.