WoW:API GetZoneText: Difference between revisions

Latest revision as of 04:46, 15 August 2023

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

→ WoW API

← WoW API < GetZoneText

Returns the localized name of the zone the player is in.

zoneName = GetZoneText();

Parameters[edit]

Returns[edit]

zoneName (string) - zone name (localized).

Result[edit]

Message box appears displaying your current zone.

Examples[edit]

local zoneName = GetZoneText();
message(zoneName);

Notes[edit]

The event ZONE_CHANGED_NEW_AREA is triggered when the text changes. See also the related functions GetSubZoneText and GetMinimapZoneText.

Additional note: Blizzard also registers the event ZONE_CHANGED_INDOORS. If you know what this event is used for, please edit this page.

The event ZONE_CHANGED_INDOORS would most likely be used if you were creating a minimap modification to notify you that you have gone into a building to change the minimap texture and the text above it to indicate the building you are in -- Salanex

See also the related function GetRealZoneText to find the name of the instance instead of the subzone you happen to be in.

@@ Line 1: / Line 1: @@
-{{wowapi}}
+{{wowapi|toc=0}}
-Returns the zone text.
+Returns the localized name of the zone the player is in.
-  GetZoneText();
+  zoneName = GetZoneText();
-----
+== Parameters ==
-;''Arguments''
+=== Returns ===
+* zoneName (string) - zone name (localized).
-:''none''
+=== Result ===
+Message box appears displaying your current zone.
-----
+== Examples ==
-;''Returns''
+ local zoneName = GetZoneText();
+ message(zoneName);
-:
+== Notes ==
-:;zonetext : String - zone name (localized).
+The event '''ZONE_CHANGED_NEW_AREA''' is triggered when the text changes. See also the related functions [[API_GetSubZoneText|GetSubZoneText]] and [[API_GetMinimapZoneText|GetMinimapZoneText]].
-----
+Additional note: Blizzard also registers the event '''ZONE_CHANGED_INDOORS'''. If you know what this event is used for, please edit this page.
-;''Example''
- local zonetext = GetZoneText();
- message(zonetext);
-;''Result''
+: The event ZONE_CHANGED_INDOORS would most likely be used if you were creating a minimap modification to notify you that you have gone into a building to change the minimap texture and the text above it to indicate the building you are in -- Salanex
-: Message box appears displaying your current zone.
-----
+See also the related function [[API_GetRealZoneText|GetRealZoneText]] to find the name of the instance instead of the subzone you happen to be in.
-;''Description''
-: Returns the zone text, in which the player currently is. The event '''ZONE_CHANGED_NEW_AREA''' is triggered when the text changes. See also the related functions [[API_GetSubZoneText|GetSubZoneText]] and [[API_GetMinimapZoneText|GetMinimapZoneText]].
-: Additional note: Blizzard also registers the event '''ZONE_CHANGED_INDOORS'''. If you know what this event is used for, please edit this page.
-: This is just a guess, but I imagine it dismounts you for one.  -- lCine7ic

Navigation menu

Search