OnGetContainerChild
1. Definition
This hook is called when a Blackbox object is dragged into the timeline and an object or a Blackbox effect is deleted.
2. Method
function OnGetContainerChild(SlideShowObject: ISlideShowObject): string;
3. Parameters
SlideShowObject: ISlideShowObject
4. Return value
The return value is a string of the form 'x.y.z'. x, y and z are integers greater than or equal to 0, that result in a path (zero-based!) by the structure of the object. Also angenommen, man fügt ein Blackbox-Objekt ein, welches durch ein Script schon einen bestimmten Inhalt hat. So kann also eine Vorlage schon zwei Kapitel angelegt haben. Eines für den Inhalt, auf den der Effekt angewendet werden soll und eines für etwas anderes, zum Beispiel eine Maske. Dieser Hook zeigt nun an, dass das angewendete Objekt nun in dem Inhalts-Kapitel landen soll, also beispielsweise im 1. Kind der Vorlage. Der Rückgabewert wäre nun '0'. Wollte man das Objekt, auf das die Vorlage angewendet wird, im 2. Kapitel und dessen 4. Kapitel gelegt haben, wäre der Rückgabewert '1.3'.
Deletion runs accordingly. It searches the container object and everything but its contents is cleared.
If this hook or its return value doesn't exist or the return value isn't valid then the object will be inserted into the template as the first child. When deleting only the Blackbox object is deleted, the entire contents is retained.