System.Classes.TResourceStream.CreateFromID
Delphi
constructor CreateFromID(Instance: THandle; ResID: Integer; ResType: PChar);
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
constructor | public | System.Classes.pas | System.Classes | TResourceStream |
Beschreibung
Erzeugt eine TResourceStream-Instanz, die einer bestimmten Ressourcen-ID und einem bestimmten Ressourcentyp zugeordnet ist.
Mit CreateFromID wird für eine Ressource in der angegebenen Instanz ein TResourceStream-Objekt erzeugt. Die Ressource kann dabei über eine Integer-ID bezeichnet werden. Create ermittelt die Ressourcendaten und lädt diese 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.
ResID ist der Integer-ID, der mit der Ressource in derjenigen .rc-Datei verbunden ist, die mit der Anwendung compiliert wurde. Wenn die Ressource anstelle einer ID-Nummer durch einen String identifiziert wurde, verwenden Sie stattdessen die Methode Create.
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 |
Anmerkung: Die Referenzierung von Ressourcen über ihre ID erfordert weniger Speicher als die Referenzierung per Name.