InjectUIComponent

From the Fallout3 GECK Wiki
Jump to navigation Jump to search
< [[::Category:Functions|Category:Functions]]

A function added by the JIP NVSE Plugin.

Description

Injects the contents of a formatted string into a menu, at componentPath (see Notes, below).

Syntax

[help]
(successful:0/1) InjectUIComponent componentPath:string component:formattedString formatVars(up to 20)

Example

InjectUIComponent "HUDMainMenu" "<_Var1>%g</_Var1> <text name=%qTestText%q> <_Var2> <copy src=%qparent()%q trait=%q_Var1%q/> </_Var2> </text>" intVar
InjectUIComponent "StartMenu\NOGLOW_BRANCH" "<rect name=%qTestRect%q> <image name=%qTestImage%q> <text name=%q%z%q> </text> </image> </rect>" strVar

Notes

  • component supports format specifiers, and up to 20 variables may be used.
  • The new components are injected directly into the game's memory - no files on disk are modified (or even accessed).
  • Once injected, all UI functions can be used on the new components.
  • Most menus are loaded in memory only while open, and are unloaded when closed. This means:
    • New components will be injected successfully only if the target menu is currently loaded.
    • New components must be re-injected every time the target menu is re-loaded. The only exceptions are the following menus, which are always loaded (and are never re-loaded): HUDMainMenu, InventoryMenu, MapMenu, RepairMenu, StatsMenu, ItemModMenu.

See Also