using System.Collections.Generic;
using System.Runtime.InteropServices.ComTypes;
using System.Windows.Forms;
using static Vanara.PInvoke.Shell32;
using static Vanara.PInvoke.User32;

namespace Vanara.Extensions;

/// <summary>Extension methods for <see cref="TextBox"/>.</summary>
public static partial class TextBoxExtension
{
	/// <summary>Sets the textual cue, or tip, that is displayed by the edit control to prompt the user for information.</summary>
	/// <param name="textBox">The text box.</param>
	/// <param name="cueBannerText">A string that contains the text to display as the textual cue.</param>
	/// <param name="retainOnFocus">if set to <c>true</c> the cue banner should show even when the edit control has focus.</param>
	/// <exception cref="PlatformNotSupportedException">Must be Windows Vista or later.</exception>
	public static void SetCueBanner(this TextBox textBox, string? cueBannerText, bool retainOnFocus = false)
	{
		if (Environment.OSVersion.Version.Major >= 6)
		{
			SendMessage(textBox.Handle, (uint)EditMessage.EM_SETCUEBANNER, new IntPtr(retainOnFocus ? 1 : 0), cueBannerText);
			textBox.Invalidate();
		}
		else
			throw new PlatformNotSupportedException();
	}

	/// <summary>Sets a custom automatic complete list.</summary>
	/// <param name="textBox">The text box.</param>
	/// <param name="items">The autocomplete strings.</param>
	/// <param name="options">The autocomplete options.</param>
	public static void SetCustomAutoCompleteList(this TextBox textBox, IReadOnlyList<string> items, AUTOCOMPLETEOPTIONS options = AUTOCOMPLETEOPTIONS.ACO_AUTOSUGGEST)
	{
		var ac = new IAutoComplete2();
		ac.Init(textBox.Handle, new Vanara.PInvoke.InteropServices.ComEnumString(items), null, null);
		ac.SetOptions(options);
	}

	/// <summary>Sets the tab stops in a multiline edit control. When text is copied to the control, any tab character in the text causes space to be generated up to the next tab stop.</summary>
	/// <param name="textBox">The text box.</param>
	/// <param name="tabs">An array of unsigned integers specifying the tab stops, in dialog template units. If this parameter is not supplied, default tab stops are set at every 32 dialog template units. If a single value is provided, this value is the distance between all tab stops, in dialog template units. If two or more values are provided, each value represents a tab stop in dialog template units.</param>
	public static void SetTabStops(this TextBox textBox, params uint[] tabs)
	{
		tabs ??= new uint[0];
		using (var ptr = SafeCoTaskMemHandle.CreateFromList(tabs))
			SendMessage(textBox.Handle, (uint)EditMessage.EM_SETTABSTOPS, (IntPtr)tabs.Length, (IntPtr)ptr);
		textBox.Invalidate();
	}
}