clear_template — Freigabe des Speichers eines Templates.
clear_template ist veraltet und wird nur aus Gründen
der Rückwärtskompatibilität zur Verfügung gestellt. Neue
Applikationen sollten stattdessen die
Form-basierten oder NCC-basierten Operatoren verwenden.
clear_template( : : TemplateID : )
clear_template gibt den Speicher eines Templates,
das mit create_template oder create_template_rot
angelegt wurde, wieder frei.
Das Template kann nach dem Aufruf nicht mehr
verwendet werden. Der Wert von TemplateID ist
ungültig. Die Nummer kann jedoch bei nachfolgenden
Aufrufen von create_template oder create_template_rot
wieder vergeben werden.
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.
TemplateID (input_control, Zustand wird modifiziert) template → (handle)
Nummer des Templates.
Ist die Nummer des Templates gültig, dann liefert
clear_template den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
create_template,
create_template_rot,
read_template,
write_template
Matching