API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

ITRIGMLEXTENSION_CHILDRENCOMPLETE()

Brew Release
Brew MP 1.0.2
Description
Called by Trigplayer when all the children of the current node have been inserted. This will happen either when the element close is detected during the parse, or when explicitly called from LUA script.
Every loaded extension is notified for every element whose child list is completed. You should return SUCCESS if there is no action for your extension to take for this element. In particular, you can always ignore this notification for any non-container element.
Params
po
[]:
A pointer to an ITrigmlExtension object.
node
[]:
A pointer to the element whose children are complete.
Interface
  • ITRIGMLEXTENSION
Prototype
  •    int ITRIGMLEXTENSION_ChildrenComplete(ITrigmlExtension* po, ITrigmlElement* node);
    
Return
  •    A BREW error code.
    
Side Effect
  • None
Comments
This notification exists for elements that contain other elements and have action that they need to take when all the child elements are present. For example, can't process any s until it has all of them. You may also wish to use this notification for containers that have complicated layout requirements. For example, doesn't call IGRIDCONTAINER_SetGridDescriptors() until it receives this notification, because although it could choose to do so during the call to ITRIGMLEXTENSION_ChildInserted(), this would mean that the grid container was invalidated multiple times during a single Trigml parse.