System.Classes.TResourceStream.Create
Delphi
constructor Create(Instance: THandle; const ResName: string; ResType: PChar);
C++
__fastcall TResourceStream(Winapi::Windows::THandle Instance, const System::UnicodeString ResName, System::WideChar * ResType);
__fastcall TResourceStream(Winapi::Windows::THandle Instance, int ResID, System::WideChar * ResType);
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
constructor | public | System.Classes.pas System.Classes.hpp |
System.Classes | TResourceStream |
Beschreibung
Erzeugt eine TResourceStream-Instanz, der ein bestimmter Ressourcennname und -typ zugeordnet ist.
Mit Create wird ein TResourceStream-Objekt instantiiert. Die Parameter geben die Ressource in der festgelegten Instanz an. TResourceStream findet die Ressourcendaten und lädt sie in den Speicherpuffer.
Der Parameter Instance bezeichnet das Instanzen-Handle, das der ausführbaren Datei oder dem gemeinsamen genutzten Bibliothek zugeordnet ist, in der sich die Ressource befindet.
In der ersten Kontruktorsyntax ist ResName der String, der mit der Ressource in derjenigen .rc-Datei verbunden ist, die mit der Anwendung compiliert wurde. Ist die Ressource anstelle des Strings mit einem Integer-ID verbunden, verwenden Sie die String-Repräsentation des Integers nach dem Nummernzeichen (#). Eine Ressource mit dem Integer-ID 128 wird also beispielsweise den Ressourcennamen (ResName) #128 identifiziert.
Anmerkung: Die Referenzierung von Ressourcen über ihre ID erfordert weniger Speicher als die Referenzierung per Name.
Der Typ der Ressource wird mit dem Parameter ResType identifiziert. Anwendungen können eigene Ressourcentypen definieren und per Name in der RC-Datei referenzieren. Außerdem gibt es eine Reihe vordefinierter Ressourcetypen (die den Windows-Ressourcetypen entsprechen). Um eine Ressource zu ermitteln, die zu den vordefinierten Ressourcetypen gehört, setzen Sie ResType auf den entsprechenden Wert aus der folgenden Tabelle:
ResType | Ressourcentyp |
---|---|
RT_ACCELERATOR |
Tabelle der Tastenkürzel |
RT_BITMAP |
Bitmap |
RT_DIALOG |
Dialogfeld |
RT_FONT |
Schrift |
RT_FONTDIR |
Schriftenverzeichnis |
RT_MENU |
Menü |
RT_RCDATA |
Anwendungsdefinierte Ressource (Rohdaten) |
RT_STRING |
Eintrag in String-Tabelle |
RT_MESSAGETABLE |
Eintrag in Meldungstabelle |
RT_CURSOR |
Hardware-abhängige Cursor-Ressource |
RT_GROUP_CURSOR |
Hardware-unabhängige Cursor-Ressource |
RT_ICON |
Hardware-abhängige Symbolressource |
RT_GROUP_ICON |
Hardware-unabhängige Symbolressource |
RT_VERSION |
Versionsressource |