# Purchase Research Item

Grammar — Purchase researchItem
Flags — Native | Action

Combined with the “Set Research Tier Max Purchases Allowed”, this function will perform logic to mark the given research item as purchased, and flag any other research items in the tier that are past the max purchases allowed as disabled.

# Arguments

• int<preset::ResearchItem> — Research Item

Returns — void

native void ResearchItemPurchase(int inResearchItemId);

# Related

Category: Story / Research Panel

• Research Panel Close Button Clicked — void — TriggerAddEventResearchPanelExit
• Create Research Tier — int<preset::ResearchTier> — ResearchTierCreate
• Last Created Research Tier — int<preset::ResearchTier> — ResearchTierLastCreated
• Destroy Research Tier — void — ResearchTierDestroy
• Destroy All Research Tiers — void — ResearchTierDestroyAll
• Set Research Tier Required Level — void — ResearchTierSetRequiredLevel
• Set Research Tier Max Purchases Allowed — void — ResearchTierSetMaxPurchasesAllowed
• Create Research Category — int<preset::ResearchCategory> — ResearchCategoryCreate
• Last Created Research Category — int<preset::ResearchCategory> — ResearchCategoryLastCreated
• Destroy Research Category — void — ResearchCategoryDestroy
• Destroy All Research Categories — void — ResearchCategoryDestroyAll
• Set Research Category Name — void — ResearchCategorySetNameText
• Set Research Category Current Level — void — ResearchCategorySetCurrentLevel
• Set Research Category Last Level — void — ResearchCategorySetLastLevel
• Create Research Item — int<preset::ResearchItem> — ResearchItemCreate
• Last Created Research Item — int<preset::ResearchItem> — ResearchItemLastCreated
• Destroy Research Item — void — ResearchItemDestroy
• Purchase Research Item — void — ResearchItemPurchase
• Set Research Item State — void — ResearchItemSetState
• Set Research Item Icon — void — ResearchItemSetIconFilePath
• Set Research Item Movie — void — ResearchItemSetMovieFilePath
• Set Research Item Name — void — ResearchItemSetNameText
• Set Research Item Description — void — ResearchItemSetDescriptionText
• Set Research Item Tooltip — void — ResearchItemSetTooltipText
• Set Research Item Confirmation — void — ResearchItemSetConfirmationText
• Research Panel Research Button Clicked — void — TriggerAddEventResearchPanelPurchase
• Research Panel Selection Changed — void — TriggerAddEventResearchPanelSelectionChanged
• Set Research Item Recently Purchased — void — ResearchItemSetRecentlyPurchased
• Research Item Is Recently Purchased — bool — ResearchItemIsRecentlyPurchased
• Set Selected Research Item — void — ResearchItemSetSelected
• Selected Research Item — int<preset::ResearchItem> — ResearchItemGetSelected

# Examples

campaigns/libertystory.sc2campaign — base.sc2data/TriggerLibs/CampaignLib.galaxy:12484

    }

    ResearchItemPurchase(ResearchItemGetSelected(1));
    libCamp_gf_SetStoryResearchPurchased(lv_researchID);
    libCamp_gf_TS_ResearchUIUpdate();