# Dialog Item Invoke As Text

Grammar — Invokes method method(parameter1, parameter2, parameter3, parameter4) on flash dialog item flash for players
Flags — Native | Action | Restricted

Calls a method invoke on a loaded flash dialog item. The flash dialog item must have a flash file loaded which has the specified method name in it. The parameters for the invoked method are optional.

# Arguments

• int<control> — Flash
• playergroup — Players
• string — Method
• text — Parameter 1
• text — Parameter 2
• text — Parameter 3
• text — Parameter 4

Returns — void

native void DialogControlInvokeAsText(
	int control,
	playergroup players,
	string method,
	text param1,
	text param2,
	text param3,
	text param4,
);

# Related

Category: Dialog / Dialog Item Tools

• Dialog Item Send Animation Event 2 — void — DialogControlSetAnimationState
• Position Subtitle to Dialog Item — void — DialogSetSubtitlePositionOverrideControl
• Clear Subtitle Position Dialog Item — void — DialogClearSubtitlePositionOverrideControl
• Destroy All Dialog Items — void — DialogControlDestroyAll
• Dialog Containing Dialog Item — int<dialog> — DialogControlGetDialog
• Dialog Item Type — int<preset::ControlType> — DialogControlGetType
• Set Dialog Item Color — void — libNtve_gf_SetDialogItemColor
• Set Dialog Item Style — void — libNtve_gf_SetDialogItemStyle
• Set Dialog Item Text Writeout — void — libNtve_gf_SetDialogItemTextWriteout
• Set Dialog Item Text Writeout Duration — void — libNtve_gf_SetDialogItemTextWriteoutDuration
• Set Dialog Item Tooltip — void — libNtve_gf_SetDialogItemTooltip
• Dialog Item Color — color — libNtve_gf_DialogItemColor
• Dialog Item Style — string<fontstyle> — libNtve_gf_DialogItemStyle
• Dialog Item Tooltip — text — libNtve_gf_DialogItemTooltip
• Destroy Dialog Item — void — DialogControlDestroy
• Set Dialog Item Image — void — libNtve_gf_SetDialogItemImage
• Set Dialog Item Hover Image — void — libNtve_gf_SetDialogItemImage2
• Set Dialog Item Image Type — void — libNtve_gf_SetDialogItemImageType
• Set Dialog Item Blend Mode — void — libNtve_gf_SetDialogItemBlendMode
• Set Dialog Item Tiled — void — libNtve_gf_SetDialogItemImageType2
• Set Dialog Background — void — DialogSetImage
• Dialog Item Image — string — libNtve_gf_DialogItemImage
• Dialog Item Image Type — int<preset::ImageType> — libNtve_gf_DialogItemImageType
• Fade Dialog Item Transparency — void — DialogControlFadeTransparency
• Set Dialog Item Flash — void — libNtve_gf_SetDialogItemFlash
• Set Dialog Item Cutscene — void — libNtve_gf_SetDialogItemCutscene
• Dialog Item Invoke As Text — void — DialogControlInvokeAsText
• Dialog Item Invoke As String — void — DialogControlInvokeAsString
• Dialog Item Send Animation Event — void — DialogControlSendAnimationEvent
• Dialog Item Set Animation Speed — void — DialogControlSetAnimationSpeed
• Dialog Item Set Animation Time — void — DialogControlSetAnimationTime
• Dialog Item Advance Animation — void — DialogControlAdvanceAnimation
• Dialog Item Force Transition — void — DialogControlForceTransition
• Dialog Item Request Focus — void — DialogControlRequestFocus
• Set Dialog Item Achievement — void — libNtve_gf_SetDialogItemAchievement
• Set Dialog Item Render Priority — void — libNtve_gf_SetDialogItemRenderPriority
• Set Dialog Item Click On Down — void — libNtve_gf_SetDialogItemClickOnDown
• Set Dialog Item Toggled — void — libNtve_gf_SetDialogItemToggled
• Set Dialog Item Movie — void — libNtve_gf_SetDialogItemMovie
• Set Dialog Item Desaturated — void — libNtve_gf_SetDialogItemDesaturated
• Set Dialog Item Desaturation Color — void — libNtve_gf_SetDialogItemDesaturationColor
• Set Dialog Item Custom Tooltip — void — libNtve_gf_SetDialogItemCustomTooltip
• Set Dialog Item Unit — void — libNtve_gf_SetDialogItemUnit
• Set Dialog Item Model — void — libNtve_gf_SetDialogItemModel
• Set Dialog Item Animation — void — libNtve_gf_SetDialogItemAnimation
• Set Dialog Item Camera — void — libNtve_gf_SetDialogItemCamera
• Set Dialog Item Border Visible — void — libNtve_gf_SetDialogItemBorderVisible
• Set Dialog Item Border Image — void — libNtve_gf_SetDialogItemBorderImage
• Set Dialog Item Background Visible — void — libNtve_gf_SetDialogItemBackgroundVisible
• Set Dialog Item Use Transition — void — libNtve_gf_SetDialogItemUseTransition
• Set Dialog Item Muted — void — libNtve_gf_SetDialogItemMuted
• Set Dialog Item Paused — void — libNtve_gf_SetDialogItemPaused
• Set Dialog Item Accept Mouse — void — libNtve_gf_SetDialogItemAcceptMouse
• Set Dialog Item Tint Color — void — libNtve_gf_SetDialogItemTintColor
• Set Dialog Item Team Color — void — libNtve_gf_SetDialogItemTeamColor
• Set Dialog Item Light — void — libNtve_gf_SetDialogItemLight
• Set Dialog Item Transition Model — void — libNtve_gf_SetDialogItemTransitionModel
• Set Dialog Item Force Visible — void — libNtve_gf_SetDialogItemForceVisible
• Set Dialog Item Render Type — void — libNtve_gf_SetDialogItemRenderType
• Set Dialog Item Unit Link — void — libNtve_gf_SetDialogItemUnitLink
• Set Dialog Item Team Color Index — void — libNtve_gf_SetDialogItemTeamColorIndex
• Set Dialog Item Animation Duration — void — libNtve_gf_SetDialogItemAnimationDuration
• Set Dialog Item Animation Time — void — libNtve_gf_SetDialogItemAnimationTime
• Set Dialog Item Actor — void — libNtve_gf_SetDialogItemActor
• Set Dialog Item Behavior — void — libNtve_gf_SetDialogItemBehavior
• Set Dialog Item Hotkey — void — libNtve_gf_SetDialogItemHotkey
• Set Dialog Item Allowed Mouse Buttons — void — libNtve_gf_SetDialogItemAllowedMouseButtons
• Set Dialog Item Alpha Mask — void — libNtve_gf_SetDialogItemAlphaMask
• Set Dialog Item Animation Index — void — libNtve_gf_SetDialogItemAnimationIndex
• Set Dialog Item Handle — void — libNtve_gf_SetDialogItemHandle
• Set Dialog Item Border Color — void — libNtve_gf_SetDialogItemBorderColor
• Set Dialog Item Fill Color — void — libNtve_gf_SetDialogItemFillColor
• Set Dialog Item Submenu — void — libNtve_gf_SetDialogItemSubmenu
• Set Dialog Item Unit Group — void — libNtve_gf_SetDialogItemUnitGroup
• Set Dialog Item PlayerId — void — libNtve_gf_SetDialogItemPlayerId
• Set Dialog Item Score Value Link — void — libNtve_gf_SetDialogItemScoreValueLink
• Set Dialog Item State Index — void — libNtve_gf_SetDialogItemStateIndex

# Examples

campaigns/swarmstory.sc2campaign — base.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:2137

        if (((libSwaC_gf_CurrentMap() == "ZLab1") || (libSwaC_gf_CurrentMap() == "ZLab2") || (libSwaC_gf_CurrentMap() == "ZSpace1"))) {
            TextExpressionSetToken("Param/Expression/lib_SwaC_903D3715", "A", StringExternal("Param/Value/lib_SwaC_E59ABB37"));
            DialogControlInvokeAsText(libSwaC_gv_zS_MissionHelpButtonTipPanel, PlayerGroupAll(), "PlayTip_Terr", TextExpressionAssemble("Param/Expression/lib_SwaC_903D3715"), StringExternal("Param/Value/lib_SwaC_0567AF67"), null, null);
        }
        else {

campaigns/swarmstory.sc2campaign — base.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:2141

        else {
            TextExpressionSetToken("Param/Expression/lib_SwaC_EAD00EF2", "A", StringExternal("Param/Value/lib_SwaC_39CFFFD1"));
            DialogControlInvokeAsText(libSwaC_gv_zS_MissionHelpButtonTipPanel, PlayerGroupAll(), "PlayTip_Zerg", TextExpressionAssemble("Param/Expression/lib_SwaC_EAD00EF2"), null, null, null);
        }
        TriggerEnable(libSwaC_gt_ZS_MissionTipClicked, true);

campaigns/swarmstory.sc2campaign — base.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:11758

    // Implementation
    DialogControlSetVisible(libSwaC_gv_zS_KerriganUITierLevelUpFlash, PlayerGroupAll(), true);
    DialogControlInvokeAsText(libSwaC_gv_zS_KerriganUITierLevelUpFlash, PlayerGroupAll(), "SetLevelInfo", StringExternal("Param/Value/lib_SwaC_B4507058"), IntToText((libSwaC_gv_zS_KerriganUIFinalXP-libSwaC_gv_zS_KerriganUIOriginalXP)), null, null);
    if ((libSwaC_gv_zS_KerriganUIDeltaHealth > 0)) {
        DialogControlInvokeAsText(libSwaC_gv_zS_KerriganUITierLevelUpFlash, PlayerGroupAll(), "SetValues", StringExternal("Param/Value/lib_SwaC_8BC0753C"), IntToText(libSwaC_gv_zS_KerriganUIDeltaHealth), IntToText(1), null);

campaigns/swarmstory.sc2campaign — base.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:11760

    DialogControlInvokeAsText(libSwaC_gv_zS_KerriganUITierLevelUpFlash, PlayerGroupAll(), "SetLevelInfo", StringExternal("Param/Value/lib_SwaC_B4507058"), IntToText((libSwaC_gv_zS_KerriganUIFinalXP-libSwaC_gv_zS_KerriganUIOriginalXP)), null, null);
    if ((libSwaC_gv_zS_KerriganUIDeltaHealth > 0)) {
        DialogControlInvokeAsText(libSwaC_gv_zS_KerriganUITierLevelUpFlash, PlayerGroupAll(), "SetValues", StringExternal("Param/Value/lib_SwaC_8BC0753C"), IntToText(libSwaC_gv_zS_KerriganUIDeltaHealth), IntToText(1), null);
    }

campaigns/swarmstory.sc2campaign — base.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:11764

    if ((libSwaC_gv_zS_KerriganUIDeltaEnergy > 0)) {
        DialogControlInvokeAsText(libSwaC_gv_zS_KerriganUITierLevelUpFlash, PlayerGroupAll(), "SetValues", StringExternal("Param/Value/lib_SwaC_09465941"), IntToText(libSwaC_gv_zS_KerriganUIDeltaEnergy), IntToText(2), null);
    }

campaigns/swarmstory.sc2campaign — base.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:11768

    if ((libSwaC_gv_zS_KerriganUIDeltaDamage > 0)) {
        DialogControlInvokeAsText(libSwaC_gv_zS_KerriganUITierLevelUpFlash, PlayerGroupAll(), "SetValues", StringExternal("Param/Value/lib_SwaC_ED79A5FE"), IntToText(libSwaC_gv_zS_KerriganUIDeltaDamage), IntToText(3), null);
    }

campaigns/swarmstory.sc2campaign — base.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:11772

    if ((libSwaC_gv_zS_KerriganUIDeltaArmor > 0)) {
        DialogControlInvokeAsText(libSwaC_gv_zS_KerriganUITierLevelUpFlash, PlayerGroupAll(), "SetValues", StringExternal("Param/Value/lib_SwaC_F3C699AA"), IntToText(libSwaC_gv_zS_KerriganUIDeltaArmor), IntToText(4), null);
    }

campaigns/swarmstory.sc2campaign — base.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:17750

    TriggerEnable(TriggerGetCurrent(), false);
    DialogControlInvokeAsText(libSwaC_gv_zS_ArmyButtonTipPanel, PlayerGroupAll(), "PlayArmyTip_Zerg", StringExternal("Param/Value/lib_SwaC_2E4E132D"), null, null, null);
    TriggerEnable(libSwaC_gt_ZS_ArmyButtonUsed, true);
    return true;

campaigns/swarmstory.sc2campaign — base.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:17782

    TriggerEnable(TriggerGetCurrent(), false);
    DialogControlInvokeAsText(libSwaC_gv_zS_ArmyButtonTipPanel, PlayerGroupAll(), "CloseArmyTip_Zerg", StringExternal("Param/Value/lib_SwaC_3D4F09CA"), null, null, null);
    return true;
}

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignUILib.galaxy:9209

        autoCFD98E36_val = PlayerRace(1);
        if (autoCFD98E36_val == "Prot") {
            DialogControlInvokeAsText(libVCUI_gv_pU_ArmyButtonTipPanel, PlayerGroupAll(), "PlayArmyTip_Prot", StringExternal("Param/Value/lib_VCUI_034F4713"), null, null, null);
        }
        else if (autoCFD98E36_val == "Zerg") {

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignUILib.galaxy:9212

        }
        else if (autoCFD98E36_val == "Zerg") {
            DialogControlInvokeAsText(libVCUI_gv_pU_ArmyButtonTipPanel, PlayerGroupAll(), "PlayArmyTip_Zerg", StringExternal("Param/Value/lib_VCUI_B4347E4E"), null, null, null);
        }
        else if (autoCFD98E36_val == "Terr") {

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignUILib.galaxy:9215

        }
        else if (autoCFD98E36_val == "Terr") {
            DialogControlInvokeAsText(libVCUI_gv_pU_ArmyButtonTipPanel, PlayerGroupAll(), "PlayArmyTip_Terr", StringExternal("Param/Value/lib_VCUI_ED15A899"), null, null, null);
        }
        else {

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignUILib.galaxy:9289

    autoBCDDD362_val = PlayerRace(1);
    if (autoBCDDD362_val == "Prot") {
        DialogControlInvokeAsText(libVCUI_gv_pU_ArmyButtonTipPanel, PlayerGroupAll(), "CloseArmyTip_Prot", StringExternal("Param/Value/lib_VCUI_F2711687"), null, null, null);
    }
    else if (autoBCDDD362_val == "Zerg") {

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignUILib.galaxy:9292

    }
    else if (autoBCDDD362_val == "Zerg") {
        DialogControlInvokeAsText(libVCUI_gv_pU_ArmyButtonTipPanel, PlayerGroupAll(), "CloseArmyTip_Zerg", StringExternal("Param/Value/lib_VCUI_5A02F843"), null, null, null);
    }
    else if (autoBCDDD362_val == "Terr") {

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignUILib.galaxy:9295

    }
    else if (autoBCDDD362_val == "Terr") {
        DialogControlInvokeAsText(libVCUI_gv_pU_ArmyButtonTipPanel, PlayerGroupAll(), "CloseArmyTip_Terr", StringExternal("Param/Value/lib_VCUI_1B09ADE8"), null, null, null);
    }
    else {

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:6445

        autoCFD98E36_val = PlayerRace(1);
        if (autoCFD98E36_val == "Prot") {
            DialogControlInvokeAsText(libNCUI_gv_NU_ArmyButtonTipPanel, PlayerGroupAll(), "PlayArmyTip_Prot", StringExternal("Param/Value/lib_NCUI_034F4713"), null, null, null);
        }
        else if (autoCFD98E36_val == "Zerg") {

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:6448

        }
        else if (autoCFD98E36_val == "Zerg") {
            DialogControlInvokeAsText(libNCUI_gv_NU_ArmyButtonTipPanel, PlayerGroupAll(), "PlayArmyTip_Zerg", StringExternal("Param/Value/lib_NCUI_B4347E4E"), null, null, null);
        }
        else if (autoCFD98E36_val == "Terr") {

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:6451

        }
        else if (autoCFD98E36_val == "Terr") {
            DialogControlInvokeAsText(libNCUI_gv_NU_ArmyButtonTipPanel, PlayerGroupAll(), "PlayArmyTip_Terr", StringExternal("Param/Value/lib_NCUI_ED15A899"), null, null, null);
        }
        else {

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:6522

    autoBCDDD362_val = PlayerRace(1);
    if (autoBCDDD362_val == "Prot") {
        DialogControlInvokeAsText(libNCUI_gv_NU_ArmyButtonTipPanel, PlayerGroupAll(), "CloseArmyTip_Prot", StringExternal("Param/Value/lib_NCUI_F2711687"), null, null, null);
    }
    else if (autoBCDDD362_val == "Zerg") {

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:6525

    }
    else if (autoBCDDD362_val == "Zerg") {
        DialogControlInvokeAsText(libNCUI_gv_NU_ArmyButtonTipPanel, PlayerGroupAll(), "CloseArmyTip_Zerg", StringExternal("Param/Value/lib_NCUI_5A02F843"), null, null, null);
    }
    else if (autoBCDDD362_val == "Terr") {

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCUI.galaxy:6528

    }
    else if (autoBCDDD362_val == "Terr") {
        DialogControlInvokeAsText(libNCUI_gv_NU_ArmyButtonTipPanel, PlayerGroupAll(), "CloseArmyTip_Terr", StringExternal("Param/Value/lib_NCUI_1B09ADE8"), null, null, null);
    }
    else {

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOUI.galaxy:5806

    DialogSetVisible(libCOUI_gv_cU_FanfareDialog, lv_fanfarePlayers, true);
    if ((lp_result == c_gameOverVictory)) {
        DialogControlInvokeAsText(libCOUI_gv_cU_FanfareFlash, lv_fanfarePlayers, "SetVictoryText", StringExternal("@UI/Text/Victory"), null, null, null);
    }
    else {

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOUI.galaxy:5809

    }
    else {
        DialogControlInvokeAsText(libCOUI_gv_cU_FanfareFlash, lv_fanfarePlayers, "SetVictoryText", StringExternal("@UI/Text/Defeat"), null, null, null);
    }
    DialogControlInvokeAsText(libCOUI_gv_cU_FanfareFlash, lv_fanfarePlayers, "SetNameText", PlayerName(lp_player), null, null, null);

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOUI.galaxy:5811

        DialogControlInvokeAsText(libCOUI_gv_cU_FanfareFlash, lv_fanfarePlayers, "SetVictoryText", StringExternal("@UI/Text/Defeat"), null, null, null);
    }
    DialogControlInvokeAsText(libCOUI_gv_cU_FanfareFlash, lv_fanfarePlayers, "SetNameText", PlayerName(lp_player), null, null, null);
    DialogControlInvokeAsString(libCOUI_gv_cU_FanfareFlash, lv_fanfarePlayers, "PlayVictoryScreen", StringCase((lv_playerRace), false), null, null, null);
    SoundPlayForPlayer(SoundLink("UI_Victory_All", 0), c_maxPlayers, lv_fanfarePlayers, 100.0, 0.0);

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOUI.galaxy:7812

    TriggerEnable(TriggerGetCurrent(), false);
    DialogControlInvokeAsText(libCOUI_gv_cU_ArmyButtonTipPanel, PlayerGroupAll(), "PlayArmyTip_Zerg", StringExternal("Param/Value/lib_COUI_B4347E4E"), null, null, null);
    TriggerEnable(libCOUI_gt_CU_ArmyButtonUsed, true);
    return true;

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOUI.galaxy:7844

    TriggerEnable(TriggerGetCurrent(), false);
    DialogControlInvokeAsText(libCOUI_gv_cU_ArmyButtonTipPanel, PlayerGroupAll(), "CloseArmyTip_Zerg", StringExternal("Param/Value/lib_COUI_F2711687"), null, null, null);
    return true;
}

mods/voidprologue.sc2mod — base.sc2data/LibA3DDD02B.galaxy:1440

    if ((libHots_gf_DifficultyValueInt2(1, 1, 0) == 1)) {
        TextExpressionSetToken("Param/Expression/lib_A3DDD02B_903D3715", "A", StringExternal("Param/Value/lib_A3DDD02B_E59ABB37"));
        DialogControlInvokeAsText(libA3DDD02B_gv_pP_MissionHelpButtonTipPanel, PlayerGroupAll(), "PlayTip_Prot", TextExpressionAssemble("Param/Expression/lib_A3DDD02B_903D3715"), StringExternal("Param/Value/lib_A3DDD02B_0567AF67"), null, null);
        TriggerEnable(libA3DDD02B_gt_PP_MissionTipClicked, true);
    }

mods/voidprologue.sc2mod — base.sc2data/LibA3DDD02B.galaxy:8136

    TriggerEnable(TriggerGetCurrent(), false);
    DialogControlInvokeAsText(libA3DDD02B_gv_pP_ArmyButtonTipPanel, PlayerGroupAll(), "PlayArmyTip_Prot", StringExternal("Param/Value/lib_A3DDD02B_2E4E132D"), null, null, null);
    TriggerEnable(libA3DDD02B_gt_PP_ArmyButtonUsed, true);
    return true;

mods/voidprologue.sc2mod — base.sc2data/LibA3DDD02B.galaxy:8168

    TriggerEnable(TriggerGetCurrent(), false);
    DialogControlInvokeAsText(libA3DDD02B_gv_pP_ArmyButtonTipPanel, PlayerGroupAll(), "CloseArmyTip_Zerg", StringExternal("Param/Value/lib_A3DDD02B_3D4F09CA"), null, null, null);
    return true;
}