Akcia COPYOBJECT

Funkcia

Akcia vytvorí kópiu daného objektu.

Deklarácia

COPYOBJECT

srcObject, newNameStr, aliasNewObject

Parametre

srcObject	in	Odkaz na objekt.
newNameStr	in	Identifikátor hodnoty typu Text.
aliasNewObject	out	Identifikátor - kde bude vložený odkaz na novovzniknutý objekt.

Popis

Zdrojový (vzorový objekt) môže byť objekt len objekt typu Graf. Akcia tento skopíruje pod novým menom, ktoré je dané parametrom newNameStr. Nové meno musí vyhovovať pravidlám pre meno objektu v D2000. Zlé meno generuje chybu _ERR_RANGE_ERROR.
Po úspešnom vytvorení nového objektu je do parametra aliasNewObject vložený odkaz na novovzniknutý objekt.

Poznámka

V kontexte aktívnej schémy akcia umožňuje vytvoriť dočasnú kópiu objektu, ak parameter newNameStr je prázdny reťazec. Kópia zaniká zatvorením aktívnej schémy, v rámci ktorej bola volaná akcia COPYOBJECT, alebo zatvorením skopírovaného objektu.
Dočasná kópia má význam v prípade, že nie je potrebné uchovávať kópiu objektu v konfigurácii aplikácie. Systém D2000 automaticky zabezpečí ich zmazanie, ak nie sú naďalej používané.

Príklad

Príklad predpokladá existenciu objektu D.Graf typu Graf.

 ALIAS _newObject

 COPYOBJECT D.Graf, "D.GrafCopy", _newObject
 ; Test úspechu akcie
 IF _newObject\HBJ = 0 THEN
   ; Kópia grafu sa nevytvorila
 ELSE
   ; Kópia grafu je hotová
   ; Otvorím ju v procese D2000 HI
 OPEN _newObject ON WS_PC.HIP
 ENDIF

Súvisiace stránky:

Akcie v skriptoch