System.Classes.TResourceStream.CreateFromID

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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.

Siehe auch