文字列を必要な文字数に切り詰める方法を尋ねる質問がたくさんあります (例: 1、2、3、4、5 )。しかし、コンテナに収まるように切り捨てられたテキストが必要です。(IE: 文字列ではなく、ピクセル単位の幅で文字列をトリミングします)。
これは、WPF を使用すると簡単ですが、WinForms ではそれほどではありません...
では、コンテナに収まるように文字列を切り詰めるにはどうすればよいでしょうか?
コーディングを 1 日行った後、解決策を見つけたので、それをコミュニティと共有したいと思いました。
まず第一に、文字列または winforms TextBox に対するネイティブの切り捨て関数はありません。ラベルを使用する場合は、AutoEllipsis プロパティを使用できます。
参考:省略記号は、3 つのドットで構成される句読点です。IE: …</p>
それが私がこれを作った理由です:
public static class Extensions
{
/// <summary>
/// Truncates the TextBox.Text property so it will fit in the TextBox.
/// </summary>
static public void Truncate(this TextBox textBox)
{
//Determine direction of truncation
bool direction = false;
if (textBox.TextAlign == HorizontalAlignment.Right) direction = true;
//Get text
string truncatedText = textBox.Text;
//Truncate text
truncatedText = truncatedText.Truncate(textBox.Font, textBox.Width, direction);
//If text truncated
if (truncatedText != textBox.Text)
{
//Set textBox text
textBox.Text = truncatedText;
//After setting the text, the cursor position changes. Here we set the location of the cursor manually.
//First we determine the position, the default value applies to direction = left.
//This position is when the cursor needs to be behind the last char. (Example:"…My Text|");
int position = 0;
//If the truncation direction is to the right the position should be before the ellipsis
if (!direction)
{
//This position is when the cursor needs to be before the last char (which would be the ellipsis). (Example:"My Text|…");
position = 1;
}
//Set the cursor position
textBox.Select(textBox.Text.Length - position, 0);
}
}
/// <summary>
/// Truncates the string to be smaller than the desired width.
/// </summary>
/// <param name="font">The font used to determine the size of the string.</param>
/// <param name="width">The maximum size the string should be after truncating.</param>
/// <param name="direction">The direction of the truncation. True for left (…ext), False for right(Tex…).</param>
static public string Truncate(this string text, Font font, int width, bool direction)
{
string truncatedText, returnText;
int charIndex = 0;
bool truncated = false;
//When the user is typing and the truncation happens in a TextChanged event, already typed text could get lost.
//Example: Imagine that the string "Hello Worl" would truncate if we add 'd'. Depending on the font the output
//could be: "Hello Wor…" (notice the 'l' is missing). This is an undesired effect.
//To prevent this from happening the ellipsis is included in the initial sizecheck.
//At this point, the direction is not important so we place ellipsis behind the text.
truncatedText = text + "…";
//Get the size of the string in pixels.
SizeF size = MeasureString(truncatedText, font);
//Do while the string is bigger than the desired width.
while (size.Width > width)
{
//Go to next char
charIndex++;
//If the character index is larger than or equal to the length of the text, the truncation is unachievable.
if (charIndex >= text.Length)
{
//Truncation is unachievable!
//Throw exception so the user knows what's going on.
throw new IndexOutOfRangeException("The desired width of the string is too small to truncate to.");
}
else
{
//Truncation is still applicable!
//Raise the flag, indicating that text is truncated.
truncated = true;
//Check which way to text should be truncated to, then remove one char and add an ellipsis.
if (direction)
{
//Truncate to the left. Add ellipsis and remove from the left.
truncatedText = "…" + text.Substring(charIndex);
}
else
{
//Truncate to the right. Remove from the right and add the ellipsis.
truncatedText = text.Substring(0, text.Length - charIndex) + "…";
}
//Measure the string again.
size = MeasureString(truncatedText, font);
}
}
//If the text got truncated, change the return value to the truncated text.
if (truncated) returnText = truncatedText;
else returnText = text;
//Return the desired text.
return returnText;
}
/// <summary>
/// Measures the size of this string object.
/// </summary>
/// <param name="text">The string that will be measured.</param>
/// <param name="font">The font that will be used to measure to size of the string.</param>
/// <returns>A SizeF object containing the height and size of the string.</returns>
static private SizeF MeasureString(String text, Font font)
{
//To measure the string we use the Graphics.MeasureString function, which is a method that can be called from a PaintEventArgs instance.
//To call the constructor of the PaintEventArgs class, we must pass a Graphics object. We'll use a PictureBox object to achieve this.
PictureBox pb = new PictureBox();
//Create the PaintEventArgs with the correct parameters.
PaintEventArgs pea = new PaintEventArgs(pb.CreateGraphics(), new System.Drawing.Rectangle());
pea.Graphics.PageUnit = GraphicsUnit.Pixel;
pea.Graphics.PageScale = 1;
//Call the MeasureString method. This methods calculates what the height and width of a string would be, given the specified font.
SizeF size = pea.Graphics.MeasureString(text, font);
//Return the SizeF object.
return size;
}
}
使用法: これは、winforms フォームを含む名前空間にコピーして貼り付けることができるクラスです。「 using System.Drawing;」が含まれていることを確認してください。
このクラスには 2 つの拡張メソッドがあり、どちらも Truncate と呼ばれます。基本的に、これを行うことができます:
public void textBox1_TextChanged(object sender, EventArgs e)
{
textBox1.Truncate();
}
これで、textBox1 に何かを入力できます。必要に応じて、textBox に収まるように文字列が自動的に切り捨てられ、省略記号が追加されます。
概要: このクラスには現在 3 つのメソッドが含まれています。
Truncate (TextBox の拡張機能)
このメソッドは、TextBox.Text プロパティを自動的に切り捨てます。切り捨ての方向は、TextAlign プロパティによって抑止されます。(例: 「左揃えの切り捨て」、「右揃えの省略」。)注: この方法は、ヘブライ語やアラビア語などの他の書記体系で動作するように変更する必要がある場合があります。
Truncate (文字列の拡張子)
このメソッドを使用するには、フォントと目的の幅の 2 つのパラメーターを渡す必要があります。フォントは文字列の幅を計算するために使用され、目的の幅は切り捨て後に許容される最大幅として使用されます。
MeasureString
このメソッドは、コード スニペットではプライベートです。したがって、使用する場合は、最初にパブリックに変更する必要があります。このメソッドは、文字列の高さと幅をピクセル単位で測定するために使用されます。測定するテキストとテキストのフォントの 2 つのパラメーターが必要です。
私はこれで誰かを助けたことを願っています. おそらく、これを行う別の方法があります。Hans Passant がこの回答を見つけました。これは、ToolTipStatusLabel を切り捨てます。これは非常に印象的です。私の .NET スキルは Hans Passant には及ばないので、そのコードを TextBox のようなもので動作するように変換することはできませんでした。:)