/* Copyright (c) Cloud Software Group, Inc. * * Redistribution and use in source and binary forms, * with or without modification, are permitted provided * that the following conditions are met: * * * Redistributions of source code must retain the above * copyright notice, this list of conditions and the * following disclaimer. * * Redistributions in binary form must reproduce the above * copyright notice, this list of conditions and the * following disclaimer in the documentation and/or other * materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. */ using System; using System.Drawing; using System.Linq; using System.Text; using System.Windows.Forms; namespace XenAdmin.Core { internal static class ExtensionMethods { private const int DEFAULT_STRING_INDENTATION = 2; /// /// Internationalization of True/False /// public static string ToStringI18n(this bool value) { return value ? Messages.TRUE : Messages.FALSE; } /// /// Turns a bool to internationalized Yes/No (on occasion it's user friendlier than True/False) /// public static string ToYesNoStringI18n(this bool value) { return value ? Messages.YES : Messages.NO; } /// /// This has the same bahvoiur as the standard ellipsise extension but this uses graphics /// objects to scale the text. This performs a binary chop on the string to get the correct length /// /// /// /// /// public static string Ellipsise(this string text, Rectangle rectangle, Font font) { int width = TextRenderer.MeasureText(text, font).Width; if (width <= rectangle.Width) return text; int widthel = TextRenderer.MeasureText(Messages.ELLIPSIS, font).Width; if (widthel > rectangle.Width) return "."; // Binary chop to set the string to the right size int a = 0; int b = text.Length; int c; for (c = (a + b) / 2; c > a; c = (a + b) / 2) { string sr = text.Ellipsise(c); int srWidth = TextRenderer.MeasureText(sr, font).Width; if (srWidth > rectangle.Width) b = c; else a = c; } return text.Ellipsise(c); } /// /// Append the input value after it's been prepended with the specified amount of spaces. /// If the value spans multiple lines, each line will be indented. /// /// The to which the modified value will be appended. /// The value to prepend with spaces and then append. /// The amount of spaces to prepend to each line in the input value. /// The input after the operation has been completed. public static StringBuilder AppendIndented(this StringBuilder builder, string value, int indent = DEFAULT_STRING_INDENTATION) { return builder.Append(PrependIndentation(value, indent)); } /// /// Add a new line to the input , with options to format the input value before it's appended. /// timestamps and indentation will be ignored if the input value is an null or whitespace /// /// The to which the modified value will be appended. /// The value to format before appending. /// The timestamp to prepend to each line. If null, no timestamp will be added. /// Override for the timestamp. If set to false, no timestamp will be shown even if the value is null. /// true if each line should be prepended with indentation. Uses the default indentation defined in : /// true to append an extra line. /// The input after the operation has been completed. public static StringBuilder AppendFormattedLine(this StringBuilder builder, string value, DateTime? timestamp, bool showTimestamp = true, bool indent = false, bool addExtraLine = false) { var formattedValue = value; if (!string.IsNullOrWhiteSpace(value)) { if (indent) { formattedValue = PrependIndentation(formattedValue); } if (timestamp != null && showTimestamp) { formattedValue = PrependTimestamps(formattedValue, (DateTime) timestamp); } } builder.AppendLine(formattedValue); if (addExtraLine) { builder.AppendLine(); } return builder; } /// /// Prepend every line in the input value with the specified indentation level. /// /// The value to which indentation will be applied /// The level of indentation, i.e. the number of spaces to prepend to every line in the value. /// The input value with prepended indentation./ private static string PrependIndentation(string value, int indent = DEFAULT_STRING_INDENTATION) { var indentString = new string(' ', indent); var newValue = value.Replace(Environment.NewLine, $"{Environment.NewLine}{indentString}"); return $"{indentString}{newValue}"; } /// /// Prepend every line in the input value with a formatted string of . /// /// The input value /// The timestamp to show /// true to format the string with the user's locale /// The input value with prepended timestamps/ public static string PrependTimestamps(string value, DateTime timestamp, bool localize = true) { var timestampString = HelpersGUI.DateTimeToString(timestamp, Messages.DATEFORMAT_DM_HMS, localize); // normalise all line endings before splitting var lines = value.Replace(Environment.NewLine, "\n").Split('\n'); return string.Join(Environment.NewLine, lines.Select(line => { if (string.IsNullOrWhiteSpace(line)) { return line; } return $"{timestampString} | {line}"; })); } } }