From 4991a25d4633e146ead43872277d67685cb2e23b Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <github@jplamondonw.com>
Date: Fri, 3 Mar 2017 20:57:52 -0500
Subject: add content language changed event (#243)

---
 src/StardewModdingAPI/Events/ContentEvents.cs      | 12 +++++++++
 .../Events/EventArgsIntChanged.cs                  |  5 ++--
 .../Events/EventArgsValueChanged.cs                | 31 ++++++++++++++++++++++
 src/StardewModdingAPI/Framework/SGame.cs           | 14 ++++++++++
 src/StardewModdingAPI/StardewModdingAPI.csproj     |  1 +
 5 files changed, 60 insertions(+), 3 deletions(-)
 create mode 100644 src/StardewModdingAPI/Events/EventArgsValueChanged.cs

(limited to 'src')

diff --git a/src/StardewModdingAPI/Events/ContentEvents.cs b/src/StardewModdingAPI/Events/ContentEvents.cs
index cc07f242..558fc070 100644
--- a/src/StardewModdingAPI/Events/ContentEvents.cs
+++ b/src/StardewModdingAPI/Events/ContentEvents.cs
@@ -24,6 +24,9 @@ namespace StardewModdingAPI.Events
         /*********
         ** Events
         *********/
+        /// <summary>Raised after the content language changes.</summary>
+        public static event EventHandler<EventArgsValueChanged<string>> AfterLocaleChanged;
+
         /// <summary>Raised when an XNB file is being read into the cache. Mods can change the data here before it's cached.</summary>
         public static event EventHandler<IContentEventHelper> AssetLoading;
 
@@ -40,6 +43,15 @@ namespace StardewModdingAPI.Events
             ContentEvents.Monitor = monitor;
         }
 
+        /// <summary>Raise an <see cref="AfterLocaleChanged"/> event.</summary>
+        /// <param name="monitor">Encapsulates monitoring and logging.</param>
+        /// <param name="oldLocale">The previous locale.</param>
+        /// <param name="newLocale">The current locale.</param>
+        internal static void InvokeAfterLocaleChanged(IMonitor monitor, string oldLocale, string newLocale)
+        {
+            monitor.SafelyRaiseGenericEvent($"{nameof(ContentEvents)}.{nameof(ContentEvents.AfterLocaleChanged)}", ContentEvents.AfterLocaleChanged?.GetInvocationList(), null, new EventArgsValueChanged<string>(oldLocale, newLocale));
+        }
+
         /// <summary>Raise an <see cref="AssetLoading"/> event.</summary>
         /// <param name="monitor">Encapsulates monitoring and logging.</param>
         /// <param name="contentHelper">Encapsulates access and changes to content being read from a data file.</param>
diff --git a/src/StardewModdingAPI/Events/EventArgsIntChanged.cs b/src/StardewModdingAPI/Events/EventArgsIntChanged.cs
index 31079730..0c742d12 100644
--- a/src/StardewModdingAPI/Events/EventArgsIntChanged.cs
+++ b/src/StardewModdingAPI/Events/EventArgsIntChanged.cs
@@ -9,11 +9,10 @@ namespace StardewModdingAPI.Events
         ** Accessors
         *********/
         /// <summary>The previous value.</summary>
-        public int NewInt { get; }
-
-        /// <summary>The current value.</summary>
         public int PriorInt { get; }
 
+        /// <summary>The current value.</summary>
+        public int NewInt { get; }
 
         /*********
         ** Public methods
diff --git a/src/StardewModdingAPI/Events/EventArgsValueChanged.cs b/src/StardewModdingAPI/Events/EventArgsValueChanged.cs
new file mode 100644
index 00000000..1d25af49
--- /dev/null
+++ b/src/StardewModdingAPI/Events/EventArgsValueChanged.cs
@@ -0,0 +1,31 @@
+using System;
+
+namespace StardewModdingAPI.Events
+{
+    /// <summary>Event arguments for a field that changed value.</summary>
+    /// <typeparam name="T">The value type.</typeparam>
+    public class EventArgsValueChanged<T> : EventArgs
+    {
+        /*********
+        ** Accessors
+        *********/
+        /// <summary>The previous value.</summary>
+        public T PriorValue { get; }
+
+        /// <summary>The current value.</summary>
+        public T NewValue { get; }
+
+
+        /*********
+        ** Public methods
+        *********/
+        /// <summary>Construct an instance.</summary>
+        /// <param name="priorValue">The previous value.</param>
+        /// <param name="newValue">The current value.</param>
+        public EventArgsValueChanged(T priorValue, T newValue)
+        {
+            this.PriorValue = priorValue;
+            this.NewValue = newValue;
+        }
+    }
+}
\ No newline at end of file
diff --git a/src/StardewModdingAPI/Framework/SGame.cs b/src/StardewModdingAPI/Framework/SGame.cs
index aa22d572..5edb103e 100644
--- a/src/StardewModdingAPI/Framework/SGame.cs
+++ b/src/StardewModdingAPI/Framework/SGame.cs
@@ -159,6 +159,9 @@ namespace StardewModdingAPI.Framework
         /// <summary>The player character at last check.</summary>
         public SFarmer PreviousFarmer { get; private set; }
 
+        /// <summary>The previous content locale.</summary>
+        public LocalizedContentManager.LanguageCode? PreviousLocale { get; private set; }
+
         /// <summary>An index incremented on every tick and reset every 60th tick (0–59).</summary>
         public int CurrentUpdateTick { get; private set; }
 
@@ -1079,6 +1082,17 @@ namespace StardewModdingAPI.Framework
         /// <summary>Detect changes since the last update ticket and trigger mod events.</summary>
         private void UpdateEventCalls()
         {
+            // content locale changed event
+            if (this.PreviousLocale != LocalizedContentManager.CurrentLanguageCode)
+            {
+                var oldValue = this.PreviousLocale;
+                var newValue = LocalizedContentManager.CurrentLanguageCode;
+
+                if (oldValue != null)
+                    ContentEvents.InvokeAfterLocaleChanged(this.Monitor, oldValue.ToString(), newValue.ToString());
+                this.PreviousLocale = newValue;
+            }
+
             // save loaded event
             if (Game1.hasLoadedGame && !SaveGame.IsProcessing/*still loading save*/ && this.AfterLoadTimer >= 0)
             {
diff --git a/src/StardewModdingAPI/StardewModdingAPI.csproj b/src/StardewModdingAPI/StardewModdingAPI.csproj
index 40f964b9..727da30f 100644
--- a/src/StardewModdingAPI/StardewModdingAPI.csproj
+++ b/src/StardewModdingAPI/StardewModdingAPI.csproj
@@ -119,6 +119,7 @@
     <Compile Include="Advanced\IConfigFile.cs" />
     <Compile Include="Command.cs" />
     <Compile Include="Events\ContentEvents.cs" />
+    <Compile Include="Events\EventArgsValueChanged.cs" />
     <Compile Include="Framework\Command.cs" />
     <Compile Include="Config.cs" />
     <Compile Include="Constants.cs" />
-- 
cgit