//
// 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 shows how to hyphenate text that contains soft hyphen characters (0x00AD).
// Breaks will be inserted at soft hyphen positions (if they are present in the text)
// if TextLayout.WrapMode is set to WordWrap. Two properties are provided to control
// hyphenation:
// - TextLayout.SoftHyphenReplacementCharCode: specifies the character used as replacement
// for soft hyphen when breaking words across lines. By default this property is 0x002D
// (the Unicode hyphen-minus character). Setting this property to 0 breaks words without
// showing any visible hyphen character. Setting it to -1 prevents breaking words at soft
// hyphens).
// - TextLayout.LinesBetweenConsecutiveHyphens: specifies the minimum number of non-
// hyphenated lines between lines ending in a hyphen. By default this property is zero.
public class Hyphenation
{
public int CreatePDF(Stream stream)
{
// The online hypho-o tool
// was used to insert soft hyphens in the sample text from WordCharWrap:
var str =
"Lose noth­ing in your doc­u­ments! Grape­City Doc­u­ments for PDF " +
"in­cludes text and para­graph format­ting, spe­cial char­ac­ters, " +
"mul­tiple lan­guages, RTL sup­port, ver­tic­al and ro­tated text " +
"on all sup­por­ted plat­forms.";
// Replace HTML soft hyphens with Unicode ones:
str = str.Replace("­", "\u00AD");
var doc = new GcPdfDocument();
var page = doc.NewPage();
var g = page.Graphics;
var tl = g.CreateTextLayout();
tl.Append(str);
tl.DefaultFormat.Font = StandardFonts.Times;
tl.DefaultFormat.FontSize = 12;
tl.MaxWidth = 72 * 3;
// By default 0x002D (hyphen-minus) will be used as the hyphenation character
// when breaking a line at a soft hyphen (0x00AD):
tl.PerformLayout(true);
var dy = tl.Lines[0].Height + 72 / 16;
var rc = new RectangleF(72, 72 + dy, tl.MaxWidth.Value, 72 * 1.4F);
g.DrawString("Default hyphenation:", tl.DefaultFormat, new PointF(rc.Left, rc.Top - dy));
g.DrawTextLayout(tl, rc.Location);
g.DrawRectangle(rc, Color.CornflowerBlue);
rc.Offset(0, 72 * 2);
// This will avoid hyphenating two consecutive lines:
tl.LinesBetweenConsecutiveHyphens = 1;
// Changing hyphenation options requires RecalculateGlyphs():
tl.PerformLayout(true);
g.DrawString("LinesBetweenConsecutiveHyphens: 1", tl.DefaultFormat, new PointF(rc.Left, rc.Top - dy));
g.DrawTextLayout(tl, rc.Location);
g.DrawRectangle(rc, Color.CornflowerBlue);
rc.Offset(0, 72 * 2);
// Reset previous setting:
tl.LinesBetweenConsecutiveHyphens = 0;
// Prevent hyphenating words at all:
tl.SoftHyphenReplacementCharCode = -1;
// Changing hyphenation options requires RecalculateGlyphs():
tl.PerformLayout(true);
g.DrawString("SoftHyphenReplacementCharCode: -1", tl.DefaultFormat, new PointF(rc.Left, rc.Top - dy));
g.DrawTextLayout(tl, rc.Location);
g.DrawRectangle(rc, Color.CornflowerBlue);
// Done:
doc.Save(stream);
return doc.Pages.Count;
}
}
}