//
// This code is part of Document Solutions for PDF demos.
// Copyright (c) MESCIUS inc. All rights reserved.
//
using System;
using System.IO;
using System.Drawing;
using GrapeCity.Documents.Pdf;
using GrapeCity.Documents.Text;
using GrapeCity.Documents.Drawing;
namespace DsPdfWeb.Demos.Basics
{
// This sample demonstrates how to display ellipsis
// if a string does not fit in the allocated space.
public class TextTrimming
{
public int CreatePDF(Stream stream)
{
var doc = new GcPdfDocument();
var page = doc.NewPage();
var g = page.Graphics;
const float In = 72;
var str = "This is a long line of text which does not fit in the allocated space.";
var wid = In * 4;
var dy = 0.3f;
var rc = Common.Util.AddNote(
"TextLayout allows you to display ellipsis (or other character) " +
"at the end of a text line that did not fit in the allocated space.\n" +
"To use trimming, set TrimmingGranularity to Character or Word " +
"(the default is None). Trimming will kick in if WrapMode is NoWrap, " +
"and the text is too long. Wrapped text may also display trimming if " +
"the layout width is too narrow to fit a single word.\n" +
"Below are examples of text untrimmed, trimmed to character and to word. " +
"The next line demonstrates a different trimming character (tilde in this case). " +
"The line before last shows how to trim text (respecting TrimmingGranularity) " +
"without adding any trimming character. " +
"Finally the last line shows the use of DelimiterCharCode and DelimiterCharCount " +
"properties to shorten file paths.",
page);
var top = rc.Bottom + 36;
var ip = new PointF(rc.Left, top);
var tl = g.CreateTextLayout();
tl.DefaultFormat.Font = StandardFonts.Times;
tl.DefaultFormat.FontSize = 12;
tl.MaxWidth = wid;
tl.WrapMode = WrapMode.NoWrap;
// TrimmingGranularity is None by default:
tl.Append(str);
tl.PerformLayout(true);
g.DrawTextLayout(tl, ip);
ip.Y += tl.ContentHeight + dy;
// Character trimming:
tl.TrimmingGranularity = TrimmingGranularity.Character;
// NOTE that the recalculateGlyphsBeforeLayout parameter to PerformLayout
// may be false after the first call, as the text/font has not changed:
tl.PerformLayout(false);
g.DrawTextLayout(tl, ip);
ip.Y += tl.ContentHeight + dy;
// Word trimming:
tl.TrimmingGranularity = TrimmingGranularity.Word;
tl.PerformLayout(false);
g.DrawTextLayout(tl, ip);
ip.Y += tl.ContentHeight + dy;
// tl.EllipsisCharCode is HorizontalEllipsis (0x2026) by default.
// Change it to a tilde:
tl.EllipsisCharCode = 0x007E;
tl.PerformLayout(false);
g.DrawTextLayout(tl, ip);
ip.Y += tl.ContentHeight + dy;
// We can also set tl.EllipsisCharCode to 0 to trim text
// without rendering any trimming character:
tl.EllipsisCharCode = 0;
tl.PerformLayout(false);
g.DrawTextLayout(tl, ip);
ip.Y += tl.ContentHeight + dy;
// Another interesting feature is provided by the pair of
// DelimiterCharCode and DelimiterCharCount properties.
// These would typically be used to shorten long paths
// preserving a specified number of parts at the string's tail:
tl.Clear();
tl.EllipsisCharCode = 0x2026;
tl.Append(@"c:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe");
tl.DelimiterCharCode = '\\';
tl.DelimiterCharCount = 2;
tl.PerformLayout(true);
g.DrawTextLayout(tl, ip);
ip.Y += tl.ContentHeight + dy;
g.DrawRectangle(new RectangleF(rc.Left, top, wid, ip.Y - top), Color.OrangeRed);
// Done:
doc.Save(stream);
return doc.Pages.Count;
}
}
}