2019-11-08 02:15:03 +00:00
|
|
|
// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
|
|
|
|
// See the LICENCE file in the repository root for full licence text.
|
|
|
|
|
|
|
|
using System;
|
|
|
|
using osu.Framework.Bindables;
|
|
|
|
using osu.Framework.Graphics.Sprites;
|
|
|
|
|
|
|
|
namespace osu.Game.Graphics.UserInterface
|
|
|
|
{
|
2019-11-08 04:14:23 +00:00
|
|
|
/// <summary>
|
|
|
|
/// An <see cref="OsuMenuItem"/> which contains and displays a state.
|
|
|
|
/// </summary>
|
2019-11-08 02:15:03 +00:00
|
|
|
public abstract class StatefulMenuItem : OsuMenuItem
|
|
|
|
{
|
2019-11-08 04:14:23 +00:00
|
|
|
/// <summary>
|
|
|
|
/// The current state that should be displayed.
|
|
|
|
/// </summary>
|
2019-11-08 02:15:03 +00:00
|
|
|
public readonly Bindable<object> State = new Bindable<object>();
|
|
|
|
|
2019-11-08 04:14:23 +00:00
|
|
|
/// <summary>
|
|
|
|
/// Creates a new <see cref="StatefulMenuItem"/>.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="text">The text to display.</param>
|
|
|
|
/// <param name="changeStateFunc">A function that mutates a state to another state after this <see cref="StatefulMenuItem"/> is pressed.</param>
|
|
|
|
/// <param name="type">The type of action which this <see cref="StatefulMenuItem"/> performs.</param>
|
2019-11-08 03:55:22 +00:00
|
|
|
protected StatefulMenuItem(string text, Func<object, object> changeStateFunc, MenuItemType type = MenuItemType.Standard)
|
|
|
|
: this(text, changeStateFunc, type, null)
|
2019-11-08 02:15:03 +00:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2019-11-08 04:14:23 +00:00
|
|
|
/// <summary>
|
|
|
|
/// Creates a new <see cref="StatefulMenuItem"/>.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="text">The text to display.</param>
|
|
|
|
/// <param name="changeStateFunc">A function that mutates a state to another state after this <see cref="StatefulMenuItem"/> is pressed.</param>
|
|
|
|
/// <param name="type">The type of action which this <see cref="StatefulMenuItem"/> performs.</param>
|
|
|
|
/// <param name="action">A delegate to be invoked when this <see cref="StatefulMenuItem"/> is pressed.</param>
|
2019-11-08 03:55:22 +00:00
|
|
|
protected StatefulMenuItem(string text, Func<object, object> changeStateFunc, MenuItemType type, Action<object> action)
|
2019-11-08 02:15:03 +00:00
|
|
|
: base(text, type)
|
|
|
|
{
|
2019-11-08 03:55:22 +00:00
|
|
|
Action.Value = () =>
|
|
|
|
{
|
|
|
|
State.Value = changeStateFunc?.Invoke(State.Value) ?? State.Value;
|
|
|
|
action?.Invoke(State.Value);
|
|
|
|
};
|
2019-11-08 02:15:03 +00:00
|
|
|
}
|
|
|
|
|
2019-11-08 04:14:23 +00:00
|
|
|
/// <summary>
|
|
|
|
/// Retrieves the icon to be displayed for a state.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="state">The state to retrieve the relevant icon for.</param>
|
|
|
|
/// <returns>The icon to be displayed for <paramref name="state"/>.</returns>
|
2019-11-08 02:15:03 +00:00
|
|
|
public abstract IconUsage? GetIconForState(object state);
|
|
|
|
}
|
|
|
|
|
|
|
|
public abstract class StatefulMenuItem<T> : StatefulMenuItem
|
|
|
|
where T : struct
|
|
|
|
{
|
2019-11-08 04:14:23 +00:00
|
|
|
/// <summary>
|
|
|
|
/// The current state that should be displayed.
|
|
|
|
/// </summary>
|
2019-11-08 02:15:03 +00:00
|
|
|
public new readonly Bindable<T> State = new Bindable<T>();
|
|
|
|
|
2019-11-08 04:14:23 +00:00
|
|
|
/// <summary>
|
|
|
|
/// Creates a new <see cref="StatefulMenuItem"/>.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="text">The text to display.</param>
|
|
|
|
/// <param name="changeStateFunc">A function that mutates a state to another state after this <see cref="StatefulMenuItem"/> is pressed.</param>
|
|
|
|
/// <param name="type">The type of action which this <see cref="StatefulMenuItem"/> performs.</param>
|
2019-11-08 03:55:22 +00:00
|
|
|
protected StatefulMenuItem(string text, Func<T, T> changeStateFunc, MenuItemType type = MenuItemType.Standard)
|
|
|
|
: this(text, changeStateFunc, type, null)
|
2019-11-08 02:15:03 +00:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
2019-11-08 04:14:23 +00:00
|
|
|
/// <summary>
|
|
|
|
/// Creates a new <see cref="StatefulMenuItem"/>.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="text">The text to display.</param>
|
|
|
|
/// <param name="changeStateFunc">A function that mutates a state to another state after this <see cref="StatefulMenuItem"/> is pressed.</param>
|
|
|
|
/// <param name="type">The type of action which this <see cref="StatefulMenuItem"/> performs.</param>
|
|
|
|
/// <param name="action">A delegate to be invoked when this <see cref="StatefulMenuItem"/> is pressed.</param>
|
2019-11-08 03:55:22 +00:00
|
|
|
protected StatefulMenuItem(string text, Func<T, T> changeStateFunc, MenuItemType type, Action<T> action)
|
|
|
|
: base(text, o => changeStateFunc?.Invoke((T)o) ?? o, type, o => action?.Invoke((T)o))
|
2019-11-08 02:15:03 +00:00
|
|
|
{
|
|
|
|
base.State.BindValueChanged(state =>
|
|
|
|
{
|
|
|
|
if (state.NewValue == null)
|
|
|
|
base.State.Value = default(T);
|
|
|
|
|
|
|
|
State.Value = (T)base.State.Value;
|
|
|
|
}, true);
|
|
|
|
|
|
|
|
State.BindValueChanged(state => base.State.Value = state.NewValue);
|
|
|
|
}
|
|
|
|
|
|
|
|
public sealed override IconUsage? GetIconForState(object state) => GetIconForState((T)state);
|
|
|
|
|
2019-11-08 04:14:23 +00:00
|
|
|
/// <summary>
|
|
|
|
/// Retrieves the icon to be displayed for a state.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="state">The state to retrieve the relevant icon for.</param>
|
|
|
|
/// <returns>The icon to be displayed for <paramref name="state"/>.</returns>
|
2019-11-08 02:15:03 +00:00
|
|
|
public abstract IconUsage? GetIconForState(T state);
|
|
|
|
}
|
|
|
|
}
|