# Add List Item

Grammar — Add list item text to list for players
Flags — Native | Action

Adds a list item to a dialog item with a list, such as a pulldown or a list box.

# Arguments

• int [ control ] — List
• playergroup — Players
• text — Text

Returns — void

native void DialogControlAddItem(
	int control,
	playergroup players,
	text value,
);

# Related

Category: Dialog / Dialog Item Values

• [F] — void — Set Dialog Item Current Value — ( libNtve_gf_SetDialogItemCurrentValue )
• [F] — void — Set Dialog Item Minimum Value — ( libNtve_gf_SetDialogItemMinimumValue )
• [F] — void — Set Dialog Item Maximum Value — ( libNtve_gf_SetDialogItemMaximumValue )
• [F] — void — Set Dialog Item Checked — ( libNtve_gf_SetDialogItemChecked )
• [F] — void — Set Dialog Item Edit Value — ( libNtve_gf_SetDialogItemEditorValue )
• [F] — fixed — Dialog Item Current Value — ( libNtve_gf_DialogItemValue )
• [F] — fixed — Dialog Item Maximum Value — ( libNtve_gf_DialogItemMaximumValue )
• [F] — fixed — Dialog Item Minimum Value — ( libNtve_gf_DialogItemMinimumValue )
• [F] — bool — Dialog Item Is Checked — ( libNtve_gf_DialogItemIsChecked )
• [F] — string — Dialog Item Edit Value — ( libNtve_gf_DialogItemEditValue )
• [F] — void — Add List Item — ( DialogControlAddItem )
• [F] — void — Select List Item — ( DialogControlSelectItem )
• [F] — void — Clear List Selection — ( DialogControlClearSelectedItem )
• [F] — int — Selected List Item — ( DialogControlGetSelectedItem )
• [F] — int — Count Of List Items — ( DialogControlGetItemCount )
• [F] — void — Remove List Item — ( DialogControlRemoveItem )
• [F] — void — Remove All List Items — ( DialogControlRemoveAllItems )
• [F] — void — Add Graph Data Point — ( DialogControlAddDataPoint )
• [F] — void — Remove All Graph Data Points — ( DialogControlRemoveAllDataPoints )
• [F] — void — Set Graph Data Color — ( DialogControlSetDataColor )
• [F] — void — Set Graph Data Name — ( DialogControlSetDataName )
• [F] — void — Set Graph Minimum X Visible — ( DialogControlSetMinXVisible )
• [F] — fixed — Get Graph Minimum X Value — ( DialogControlGetMinXValue )
• [F] — void — Set Graph Maximum X Visible — ( DialogControlSetMaxXVisible )
• [F] — fixed — Get Graph Maximum X Value — ( DialogControlGetMaxXValue )
• [F] — void — Set Graph Minimum Y Visible — ( DialogControlSetMinYVisible )
• [F] — fixed — Get Graph Minimum Y Value — ( DialogControlGetMinYValue )
• [F] — void — Set Graph Maximum Y Visible — ( DialogControlSetMaxYVisible )
• [F] — fixed — Get Graph Maximum Y Value — ( DialogControlGetMaxYValue )

# Examples

# campaigns/liberty.sc2campaign

— MapScript.galaxy

// L10470
DialogControlAddItem(DialogControlLastCreated(), PlayerGroupAll(), TextCase(DifficultyNameCampaign(lp_difficulty), true))

// L10470
DialogControlAddItem(DialogControlLastCreated(), PlayerGroupAll(), TextCase(DifficultyNameCampaign(lp_difficulty), true))

# campaigns/swarmstory.sc2campaign

— SwarmCampaignLib.galaxy

// L14421
DialogControlAddItem(libSwaC_gv_zS_VSRestartDifficultyPulldown, PlayerGroupAll(), DifficultyNameCampaign(libSwaC_gf_ZS_DifficultyFromIndex(lv_index)))

# campaigns/swarmstoryutil.sc2mod

— Lib281DEC45.galaxy

// L2317
DialogControlAddItem(lib281DEC45_gv_zSS_DebugStorySceneList, PlayerGroupAll(), StringToText(UserDataGetString("ScriptedScenes", lv_indexScene, "DisplayName", 1)))

// L6712
DialogControlAddItem(lib281DEC45_gv_zSS_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty01Campaign"))

// L6713
DialogControlAddItem(lib281DEC45_gv_zSS_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty02Campaign"))

// L6714
DialogControlAddItem(lib281DEC45_gv_zSS_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty03Campaign"))

// L6715
DialogControlAddItem(lib281DEC45_gv_zSS_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty04Campaign"))

// L7746
DialogControlAddItem(lib281DEC45_gv_zSS_DebugStoryTypeList, PlayerGroupAll(), StringToText(lib281DEC45_gv_zSS_DebugStorySceneTypes[lv_index]))

// L7769
DialogControlAddItem(lib281DEC45_gv_zSS_DebugStoryStateList, PlayerGroupAll(), StringToText((UserDataInstance("WriterStates", lv_index))))

// L7775
DialogControlAddItem(lib281DEC45_gv_zSS_DebugStoryStateList, PlayerGroupAll(), StringToText((UserDataInstance("StoryStates", lv_index))))

# campaigns/voidstory.sc2campaign

— VoidCampaignStoryLib.galaxy

// L473
DialogControlAddItem(libVCST_gv_pS_DebugStoryPreviewList, PlayerGroupAll(), TextExpressionAssemble("Param/Expression/lib_VCST_A03ACF50"))

// L542
DialogControlAddItem(libVCST_gv_pS_DebugStorySceneList, PlayerGroupAll(), StringToText(lp_name))

# campaigns/voidstory.sc2campaign

— VoidCampaignUILib.galaxy

// L5731
DialogControlAddItem(libVCUI_gv_pU_VSRestartDifficultyPulldown, PlayerGroupAll(), DifficultyNameCampaign(libVoiC_gf_PC_DifficultyFromIndex(lv_index)))

// L7394
DialogControlAddItem(libVCUI_gv_pU_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty01Campaign"))

// L7395
DialogControlAddItem(libVCUI_gv_pU_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty02Campaign"))

// L7396
DialogControlAddItem(libVCUI_gv_pU_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty03Campaign"))

// L7397
DialogControlAddItem(libVCUI_gv_pU_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty04Campaign"))

// L7566
DialogControlAddItem(libVCUI_gv_pU_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty01Campaign"))

// L7567
DialogControlAddItem(libVCUI_gv_pU_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty02Campaign"))

// L7568
DialogControlAddItem(libVCUI_gv_pU_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty03Campaign"))

// L7569
DialogControlAddItem(libVCUI_gv_pU_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty04Campaign"))

// L7679
DialogControlAddItem(libVCUI_gv_pU_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty01Campaign"))

# mods/heroes.stormmod

— MapScript.galaxy

// L767
DialogControlAddItem(gv_tryMeModePanel.lv_changeAllyPulldown, PlayerGroupAll(), StringExternal("Param/Value/8C8838EB"))

// L774
DialogControlAddItem(gv_tryMeModePanel.lv_changeAllyPulldown, PlayerGroupAll(), StringExternal(("Hero/Name/" + DataTableGetString(true, ("HeroIndex_" + IntToString(lv_itHeroIndex))))))

// L809
DialogControlAddItem(gv_tryMeModePanel.lv_changeEnemyPulldown, PlayerGroupAll(), StringExternal("Param/Value/40BAD03B"))

// L816
DialogControlAddItem(gv_tryMeModePanel.lv_changeEnemyPulldown, PlayerGroupAll(), StringExternal(("Hero/Name/" + DataTableGetString(true, ("HeroIndex_" + IntToString(lv_itHeroIndex))))))

// L767
DialogControlAddItem(gv_tryMeModePanel.lv_changeAllyPulldown, PlayerGroupAll(), StringExternal("Param/Value/8C8838EB"))

// L774
DialogControlAddItem(gv_tryMeModePanel.lv_changeAllyPulldown, PlayerGroupAll(), StringExternal(("Hero/Name/" + DataTableGetString(true, ("HeroIndex_" + IntToString(lv_itHeroIndex))))))

// L809
DialogControlAddItem(gv_tryMeModePanel.lv_changeEnemyPulldown, PlayerGroupAll(), StringExternal("Param/Value/40BAD03B"))

// L816
DialogControlAddItem(gv_tryMeModePanel.lv_changeEnemyPulldown, PlayerGroupAll(), StringExternal(("Hero/Name/" + DataTableGetString(true, ("HeroIndex_" + IntToString(lv_itHeroIndex))))))

# mods/heroesdata.stormmod

— SupportLib.galaxy

// L830
DialogControlAddItem(DialogControlLastCreated(), PlayerGroupAll(), StringToText(libSprt_gv_compiledBehaviorList[lv_i]))

// L1031
DialogControlAddItem(DialogControlLastCreated(), PlayerGroupAll(), StringToText(libSprt_gv_qACheatsCompiledSpawnUnitsList[lv_i]))

// L1204
DialogControlAddItem(DialogControlLastCreated(), PlayerGroupAll(), StringToText(libSprt_gv_qACheatsCompiledSpawnItemsList[lv_i]))

# mods/heroesdata.stormmod

— UILib.galaxy

// L1934
DialogControlAddItem(libUIUI_gv_uIDebugPanel.lv_forceMinionWaveCompDropdown, PlayerGroupAll(), libCore_gv_dataMinionWaveCompositions[lv_itMinionComp].lv_name)

// L2057
DialogControlAddItem(libUIUI_gv_uIDebugPanel.lv_heroDropdown, libCore_gv_playerGroupFromPlayer[lp_player], StringExternal(("Hero/Name/" + DataTableGetString(true, ("HeroIndex_" + IntToString(lv_itHeroIndex))))))

// L2058
DialogControlAddItem(libUIUI_gv_uIDebugPanel.lv_voiceLineRadioHeroDropdown, libCore_gv_playerGroupFromPlayer[lp_player], StringExternal(("Hero/Name/" + DataTableGetString(true, ("HeroIndex_" + IntToString(lv_itHeroIndex))))))

// L2087
DialogControlAddItem(libUIUI_gv_uIDebugPanel.lv_skinDropdown, libCore_gv_playerGroupFromPlayer[lp_player], StringExternal(("Skin/Name/" + lv_skinID)))

// L2120
DialogControlAddItem(libUIUI_gv_uIDebugPanel.lv_mountTypeDropdown, libCore_gv_playerGroupFromPlayer[lp_player], TextExpressionAssemble("Param/Expression/lib_UIUI_FCFB9990"))

// L2160
DialogControlAddItem(libUIUI_gv_uIDebugPanel.lv_mountBaseDropdown, libCore_gv_playerGroupFromPlayer[lp_player], TextExpressionAssemble("Param/Expression/lib_UIUI_8460D0C1"))

// L2191
DialogControlAddItem(libUIUI_gv_uIDebugPanel.lv_mountVariationDropdown, libCore_gv_playerGroupFromPlayer[lp_player], StringExternal(("Mount/Name/" + (lv_mountLink))))

// L2199
DialogControlAddItem(libUIUI_gv_uIDebugPanel.lv_mountVariationDropdown, libCore_gv_playerGroupFromPlayer[lp_player], StringExternal(("Mount/Name/" + lv_variationID)))

// L2227
DialogControlAddItem(lv_dropdown, libCore_gv_playerGroupFromPlayer[lp_player], StringExternal(("Spray/Name/" + (libCore_gf_GetSprayFromIndex(lv_itSpray)))))

// L2253
DialogControlAddItem(lv_dropdown, libCore_gv_playerGroupFromPlayer[lp_player], StringExternal(("Banner/Name/" + (libCore_gf_GetBannerFromIndex(lv_itBanner)))))

# mods/missionpacks/novacampaign.sc2mod

— LibNCST.galaxy

// L419
DialogControlAddItem(libNCST_gv_nS_DebugStoryPreviewList, PlayerGroupAll(), TextExpressionAssemble("Param/Expression/lib_NCST_A03ACF50"))

// L486
DialogControlAddItem(libNCST_gv_nS_DebugStorySceneList, PlayerGroupAll(), StringToText(lp_name))

# mods/missionpacks/novacampaign.sc2mod

— LibNCUI.galaxy

// L966
DialogControlAddItem(libNCUI_gv_nU_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty01Campaign"))

// L967
DialogControlAddItem(libNCUI_gv_nU_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty02Campaign"))

// L968
DialogControlAddItem(libNCUI_gv_nU_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty03Campaign"))

// L969
DialogControlAddItem(libNCUI_gv_nU_MissionDifficultyDropdown, PlayerGroupAll(), StringExternal("UI/Difficulty04Campaign"))

// L3986
DialogControlAddItem(libNCUI_gv_NU_VSRestartDifficultyPulldown, PlayerGroupAll(), DifficultyNameCampaign(libComC_gf_CC_DifficultyFromIndex(lv_index)))

# mods/starcoop/starcoop.sc2mod

— LibCOUI.galaxy

// L549
DialogControlAddItem(libCOUI_gv_cU_AIChoiceListBox, PlayerGroupAll(), UserDataGetText("CoopAICommanders", lv_indexPersonality, "Name", 1))

// L885
DialogControlAddItem(libCOUI_gv_cU_CommanderMutatorChallengePulldown, PlayerGroupAll(), StringExternal("Param/Value/lib_COUI_ADB604BB"))

// L892
DialogControlAddItem(libCOUI_gv_cU_CommanderMutatorChallengePulldown, PlayerGroupAll(), UserDataGetText("MutatorChallenges", lv_indexChallenge, "Name", 1))

// L1860
DialogControlAddItem(libCOUI_gv_cU_CustomMutatorSpeedDropDown, PlayerGroupAll(), TextCase(StringExternal("UI/GameSpeed/Fasr"), true))

// L1864
DialogControlAddItem(libCOUI_gv_cU_CustomMutatorSpeedDropDown, PlayerGroupAll(), TextCase(StringExternal("UI/GameSpeed/Fast"), true))

// L1871
DialogControlAddItem(libCOUI_gv_cU_CustomMutatorSpeedDropDown, PlayerGroupAll(), TextCase(StringExternal("UI/GameSpeed/Norm"), true))

// L1875
DialogControlAddItem(libCOUI_gv_cU_CustomMutatorSpeedDropDown, PlayerGroupAll(), TextCase(StringExternal("UI/GameSpeed/Slow"), true))

# mods/voidprologue.sc2mod

— LibA3DDD02B.galaxy

// L7160
DialogControlAddItem(libA3DDD02B_gv_pU_VSRestartDifficultyPulldown, PlayerGroupAll(), DifficultyNameCampaign(libA3DDD02B_gf_PP_DifficultyFromIndex(lv_index)))

// L9098
DialogControlAddItem(libA3DDD02B_gv_pP_MLDifficultyPulldown, PlayerGroupAll(), StringExternal("UI/Difficulty01Campaign"))

// L9099
DialogControlAddItem(libA3DDD02B_gv_pP_MLDifficultyPulldown, PlayerGroupAll(), StringExternal("UI/Difficulty02Campaign"))

// L9100
DialogControlAddItem(libA3DDD02B_gv_pP_MLDifficultyPulldown, PlayerGroupAll(), StringExternal("UI/Difficulty03Campaign"))

// L9101
DialogControlAddItem(libA3DDD02B_gv_pP_MLDifficultyPulldown, PlayerGroupAll(), StringExternal("UI/Difficulty04Campaign"))