mirror of https://github.com/dahall/Vanara.git
49 lines
2.6 KiB
C#
49 lines
2.6 KiB
C#
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();
|
|
}
|
|
} |