# Select/Deselect Unit Group
Grammar — select|Select/Deselect group|Unit Group for player player
Flags —Native
|Action
Selects or deselects a unit group for a player.
# Arguments
unitgroup
— Groupint
— Playerbool
[ preset::SelectDeselectOption ] — Select
Returns — void
native void UnitGroupSelect(
unitgroup inGroup,
int inPlayer,
bool inSelect,
);
# Related
Category: Selection / Unit Selection
- [F] —
int
— Subgroup Index — ( UnitSubgroupIndexSelected ) - [F] —
unitgroup
— Selected Subgroup Units — ( UnitSubgroupSelected ) - [F] —
void
— Select/Deselect Unit — ( UnitSelect ) - [F] —
void
— Select Next Subgroup — ( UnitSubgroupIndexNext ) - [F] —
void
— Select Previous Subgroup — ( UnitSubgroupIndexPrevious ) - [F] —
void
— Select/Deselect Unit Group — ( UnitGroupSelect ) - [F] —
void
— Clear Unit Selection — ( UnitClearSelection ) - [F] —
bool
— Unit Is Selected — ( UnitIsSelected ) - [F] —
bool
— Unit Type Is Selected — ( libNtve_gf_UnitTypeIsSelected ) - [F] —
unitgroup
— Selected Units — ( UnitGroupSelected ) - [F] —
void
— Unit Is Selected — ( TriggerAddEventUnitSelected ) - [F] —
void
— Store Unit Selection — ( libNtve_gf_StoreUnitSelection ) - [F] —
void
— Restore Unit Selection — ( libNtve_gf_RestoreUnitSelection ) - [F] —
void
— Flash Unit Selection — ( UnitFlashSelection )
# Examples
# campaigns/liberty.sc2campaign
// L4674
UnitGroupSelect(UnitGroup("VikingFighter", gv_p01_USER, RegionFromId(18), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_p01_USER, true)
// L758
UnitGroupSelect(UnitGroup(null, gv_p01_USER, RegionFromId(8), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_p01_USER, true)
// L11444
UnitGroupSelect(UnitGroupFilterPlayer(gv_playerUnitGroup, gv_p01_USER, 0), gv_p01_USER, true)
// L4988
UnitGroupSelect(gv_gROUPPlayersStartingUNITS, gv_pLAYER_01_USER, true)
// L922
UnitGroupSelect(UnitGroup(null, gv_p1_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_p1_USER, true)
// L3679
UnitGroupSelect(UnitGroup(null, gv_p1_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_p1_USER, true)
// L5611
UnitGroupSelect(UnitGroup(null, gv_p1_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_p1_USER, true)
// L7551
UnitGroupSelect(UnitGroup(null, gv_p1_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_p1_USER, true)
// L11424
UnitGroupSelect(UnitGroup(null, gv_p1_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_p1_USER, true)
// L9725
UnitGroupSelect(UnitGroup(null, gv_p1_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1, true)
// L4674
UnitGroupSelect(UnitGroup("VikingFighter", gv_p01_USER, RegionFromId(18), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_p01_USER, true)
// L758
UnitGroupSelect(UnitGroup(null, gv_p01_USER, RegionFromId(8), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_p01_USER, true)
// L11444
UnitGroupSelect(UnitGroupFilterPlayer(gv_playerUnitGroup, gv_p01_USER, 0), gv_p01_USER, true)
// L4988
UnitGroupSelect(gv_gROUPPlayersStartingUNITS, gv_pLAYER_01_USER, true)
// L922
UnitGroupSelect(UnitGroup(null, gv_p1_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_p1_USER, true)
// L3679
UnitGroupSelect(UnitGroup(null, gv_p1_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_p1_USER, true)
// L5611
UnitGroupSelect(UnitGroup(null, gv_p1_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_p1_USER, true)
// L7551
UnitGroupSelect(UnitGroup(null, gv_p1_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_p1_USER, true)
// L11424
UnitGroupSelect(UnitGroup(null, gv_p1_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_p1_USER, true)
// L9725
UnitGroupSelect(UnitGroup(null, gv_p1_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1, true)
// L5701
UnitGroupSelect(gv_midSpawnedUnits, gv_pLAYER_01_USER, true)
// L5673
UnitGroupSelect(UnitGroup(null, gv_pLAYER_01_USER, RegionPlayableMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_pLAYER_01_USER, true)
// L7240
UnitGroupSelect(UnitGroup(null, gv_pLAYER_01_USER, RegionPlayableMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_pLAYER_01_USER, true)
// L6684
UnitGroupSelect(gv_startingUnits, gv_pLAYER_01_USER, true)
// L6833
UnitGroupSelect(gv_startingUnits, gv_pLAYER_01_USER, true)
// L6512
UnitGroupSelect(UnitGroupSelected(gv_pLAYER_01_USER), gv_pLAYER_01_USER, false)
// L6797
UnitGroupSelect(UnitGroupSelected(gv_pLAYER_01_USER), gv_pLAYER_01_USER, false)
// L6947
UnitGroupSelect(UnitGroupSelected(gv_pLAYER_01_USER), gv_pLAYER_01_USER, false)
// L7183
UnitGroupSelect(UnitGroupSelected(gv_pLAYER_01_USER), gv_pLAYER_01_USER, false)
// L10634
UnitGroupSelect(UnitGroup("Zergling", gv_pLAYER_01_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_pLAYER_01_USER, true)
// L1265
UnitGroupSelect(gv_swarmHostGroup, gv_pLAYER_01_USER, true)
// L5391
UnitGroupSelect(lv_startingSelection, gv_pLAYER_01_USER, true)
// L10412
UnitGroupSelect(UnitGroup(null, gv_pLAYER_01_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_pLAYER_01_USER, true)
// L10836
UnitGroupSelect(UnitGroup(null, gv_pLAYER_01_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_pLAYER_01_USER, true)
// L10916
UnitGroupSelect(UnitGroup(null, gv_pLAYER_01_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_pLAYER_01_USER, true)
// L11267
UnitGroupSelect(UnitGroup(null, gv_pLAYER_01_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_pLAYER_01_USER, true)
// L11372
UnitGroupSelect(UnitGroup(null, gv_pLAYER_01_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_pLAYER_01_USER, true)
// L11765
UnitGroupSelect(UnitGroup(null, gv_pLAYER_01_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_pLAYER_01_USER, true)
// L11867
UnitGroupSelect(UnitGroup(null, gv_pLAYER_01_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_pLAYER_01_USER, true)
// L12292
UnitGroupSelect(UnitGroup(null, gv_pLAYER_01_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_pLAYER_01_USER, true)
// L12407
UnitGroupSelect(UnitGroup(null, gv_pLAYER_01_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_pLAYER_01_USER, true)
// L1002
UnitGroupSelect(lv_backupUnits, gv_pLAYER_01_USER, true)
// L3812
UnitGroupSelect(gv_splitterStartGroup, gv_pLAYER_01_USER, true)
// L3870
UnitGroupSelect(gv_splitterStartGroup, gv_pLAYER_01_USER, true)
// L4143
UnitGroupSelect(lv_banelings, gv_pLAYER_01_USER, true)
// L4435
UnitGroupSelect(gv_hunterPlayerUnitGroup, gv_pLAYER_01_USER, true)
// L1086
UnitGroupSelect(lv_backupUnits, gv_pLAYER_01_USER, true)
// L1248
UnitGroupSelect(gv_impalerPlayerUnits, gv_pLAYER_01_USER, true)
// L2522
UnitGroupSelect(gv_lurkerPlayerUnits, gv_pLAYER_01_USER, true)
// L4662
UnitGroupSelect(gv_lurkerPlayerUnits, gv_pLAYER_01_USER, true)
// L1003
UnitGroupSelect(gv_mutaliskGroup, gv_pLAYER_01_USER, true)
// L1178
UnitGroupSelect(gv_mutaliskGroup, gv_pLAYER_01_USER, true)
// L1551
UnitGroupSelect(gv_mutaliskGroup, gv_pLAYER_01_USER, true)
// L2567
UnitGroupSelect(lv_backupUnits, gv_pLAYER_01_USER, true)
// L4218
UnitGroupSelect(gv_viperGroup, gv_pLAYER_01_USER, true)
// L879
UnitGroupSelect(lv_backupUnits, gv_pLAYER_01_USER, true)
// L1103
UnitGroupSelect(gv_corpserPlayerUnits, gv_pLAYER_01_USER, true)
// L3374
UnitGroupSelect(gv_vilePlayerUnits, gv_pLAYER_01_USER, true)
// L898
UnitGroupSelect(gv_swarmHostPlayerUnits, gv_pLAYER_01_USER, true)
// L1646
UnitGroupSelect(gv_swarmHostPlayerUnits, gv_pLAYER_01_USER, true)
// L2391
UnitGroupSelect(lv_backupUnits, gv_pLAYER_01_USER, true)
// L2557
UnitGroupSelect(gv_swarmHostPlayerUnits, gv_pLAYER_01_USER, true)
// L2577
UnitGroupSelect(gv_swarmHostPlayerUnits, gv_pLAYER_01_USER, true)
// L2726
UnitGroupSelect(gv_swarmHostPlayerUnits, gv_pLAYER_01_USER, true)
// L2746
UnitGroupSelect(gv_swarmHostPlayerUnits, gv_pLAYER_01_USER, true)
// L3622
UnitGroupSelect(gv_swarmHostPlayerUnits, gv_pLAYER_01_USER, true)
// L3909
UnitGroupSelect(gv_swarmHostPlayerUnits, gv_pLAYER_01_USER, true)
// L976
UnitGroupSelect(lv_backupUnits, gv_pLAYER_01_USER, true)
// L4029
UnitGroupSelect(gv_torrasques, gv_pLAYER_01_USER, true)
// L1040
UnitGroupSelect(lv_backupUnits, gv_pLAYER_01_USER, true)
// L2621
UnitGroupSelect(gv_raptorPlayerUnits, gv_pLAYER_01_USER, true)
// L2932
UnitGroupSelect(gv_raptorPlayerUnits, gv_pLAYER_01_USER, true)
// L3242
UnitGroupSelect(UnitGroup("Larva", gv_pLAYER_01_USER, RegionFromId(21), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), gv_pLAYER_01_USER, true)
// L1002
UnitGroupSelect(lv_backupUnits, gv_pLAYER_01_USER, true)
// L3812
UnitGroupSelect(gv_splitterStartGroup, gv_pLAYER_01_USER, true)
// L3870
UnitGroupSelect(gv_splitterStartGroup, gv_pLAYER_01_USER, true)
// L4143
UnitGroupSelect(lv_banelings, gv_pLAYER_01_USER, true)
// L4435
UnitGroupSelect(gv_hunterPlayerUnitGroup, gv_pLAYER_01_USER, true)
// L1086
UnitGroupSelect(lv_backupUnits, gv_pLAYER_01_USER, true)
// L1248
UnitGroupSelect(gv_impalerPlayerUnits, gv_pLAYER_01_USER, true)
// L2522
UnitGroupSelect(gv_lurkerPlayerUnits, gv_pLAYER_01_USER, true)
// L4662
UnitGroupSelect(gv_lurkerPlayerUnits, gv_pLAYER_01_USER, true)
// L1003
UnitGroupSelect(gv_mutaliskGroup, gv_pLAYER_01_USER, true)
// L1178
UnitGroupSelect(gv_mutaliskGroup, gv_pLAYER_01_USER, true)
// L1551
UnitGroupSelect(gv_mutaliskGroup, gv_pLAYER_01_USER, true)
// L2567
UnitGroupSelect(lv_backupUnits, gv_pLAYER_01_USER, true)
// L4218
UnitGroupSelect(gv_viperGroup, gv_pLAYER_01_USER, true)
// L879
UnitGroupSelect(lv_backupUnits, gv_pLAYER_01_USER, true)
// L1103
UnitGroupSelect(gv_corpserPlayerUnits, gv_pLAYER_01_USER, true)
// L3374
UnitGroupSelect(gv_vilePlayerUnits, gv_pLAYER_01_USER, true)
// L898
UnitGroupSelect(gv_swarmHostPlayerUnits, gv_pLAYER_01_USER, true)
// L1646
UnitGroupSelect(gv_swarmHostPlayerUnits, gv_pLAYER_01_USER, true)
// L2391
UnitGroupSelect(lv_backupUnits, gv_pLAYER_01_USER, true)
// L2557
UnitGroupSelect(gv_swarmHostPlayerUnits, gv_pLAYER_01_USER, true)
// L2577
UnitGroupSelect(gv_swarmHostPlayerUnits, gv_pLAYER_01_USER, true)
// L2726
UnitGroupSelect(gv_swarmHostPlayerUnits, gv_pLAYER_01_USER, true)
// L2746
UnitGroupSelect(gv_swarmHostPlayerUnits, gv_pLAYER_01_USER, true)
// L3622
UnitGroupSelect(gv_swarmHostPlayerUnits, gv_pLAYER_01_USER, true)
// L3909
UnitGroupSelect(gv_swarmHostPlayerUnits, gv_pLAYER_01_USER, true)
// L976
UnitGroupSelect(lv_backupUnits, gv_pLAYER_01_USER, true)