Interface ITextParagraph

ITextParagraph interface

واجهة العمل مع الفقرة

public interface ITextParagraph

الخصائص

اسموصف
AutoHyphenate { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كانت [واصلة تلقائية] .
AutoLeading { get; set; }الحصول على المسافة البادئة التلقائية أو تعيينها.
Burasagari { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كان هذاITextParagraphهو بوراساجيري.
ConsecutiveHyphens { get; set; }الحصول على أو تعيين واصلات متتالية.
EndIndent { get; set; }الحصول على المسافة البادئة للنهاية أو تعيينها .
EveryLineComposer { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كان [كل سطر مؤلف] .
FirstLineIndent { get; set; }الحصول على المسافة البادئة للسطر الأول أو تعيينها .
GlyphSpacing { get; set; }الحصول على تباعد الصورة الرمزية أو تعيينه.
Hanging { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كان هذاITextParagraph معلق .
HyphenatedWordSize { get; set; }الحصول على حجم الكلمة الموصولة أو تعيينها.
Justification { get; set; }الحصول على التبرير أو تعيينه .
KinsokuOrder { get; set; }الحصول على أو تعيين ترتيب kinsoku .
LeadingType { get; set; }الحصول على أو تحديد نوع المسافة البادئة .
LetterSpacing { get; set; }الحصول على تباعد الأحرف أو تعيينه.
PostHyphen { get; set; }الحصول على واصلة المنشور أو تعيينها.
PreHyphen { get; set; }الحصول على الواصلة المسبقة أو تعيينها .
SpaceAfter { get; set; }الحصول على المسافة أو تحديدها بعد .
SpaceBefore { get; set; }الحصول على المسافة أو تحديدها من قبل .
StartIndent { get; set; }الحصول على المسافة البادئة للبداية أو تعيينها .
WordSpacing { get; set; }الحصول على تباعد الكلمات أو تحديده .
Zone { get; set; }الحصول على المنطقة أو تحديدها.

طُرق

اسموصف
Apply(ITextParagraph)تنطبق الفقرة المحددة .
IsEqual(ITextParagraph)لتحديد ما إذا كانت الفقرة المحددة متساوية.

أمثلة

يوضح المثال التالي أن محاذاة النص من خلال ITextPortion للغات التي تُكتب من اليمين إلى اليسار تعمل بشكل صحيح.

[C#]

string sourceFilePath = "bidi.psd";
string exportFilePath = "bidiOutput.psd";

using (PsdImage image = (PsdImage)Image.Load(sourceFilePath))
{
    TextLayer layer = (TextLayer)image.Layers[2];
    ITextPortion[] portions = layer.TextData.Items;

    portions[0].Paragraph.Justification = JustificationMode.Center;
    layer.TextData.UpdateLayerData();

    image.Save(exportFilePath);
}

يوضح مثال الكود التالي تحرير أجزاء النص ونمط نصها.

[C#]

const double Tolerance = 0.0001;
var filePath = "ThreeColorsParagraphs.psd";
var outputPath = "ThreeColorsParagraph_out.psd";
using (var im = (PsdImage)Image.Load(filePath))
{
    for (int i = 0; i < im.Layers.Length; i++)
    {
        var layer = im.Layers[i] as TextLayer;

        if (layer != null)
        {
            var portions = layer.TextData.Items;

            if (portions.Length != 4)
            {
                throw new Exception();
            }

            // فحص النص من كل جزء
            if (portions[0].Text != "Old " ||
                portions[1].Text != "color" ||
                portions[2].Text != " text\r" ||
                portions[3].Text != "Second paragraph\r")
            {
                throw new Exception();
            }

            // التحقق من بيانات الفقرات
            // الفقرات لها مبررات مختلفة
            if (
                (int)portions[0].Paragraph.Justification != 0 ||
                (int)portions[1].Paragraph.Justification != 0 ||
                (int)portions[2].Paragraph.Justification != 0 ||
                (int)portions[3].Paragraph.Justification != 2)
            {
                throw new Exception();
            }

            // جميع الخصائص الأخرى للفقرة الأولى والثانية متساوية
            for (int j = 0; j < portions.Length; j++)
            {
                var paragraph = portions[j].Paragraph;

                if (Math.Abs(paragraph.AutoLeading - 1.2) > Tolerance ||
                    paragraph.AutoHyphenate != false ||
                    paragraph.Burasagari != false ||
                    paragraph.ConsecutiveHyphens != 8 ||
                    Math.Abs(paragraph.StartIndent) > Tolerance ||
                    Math.Abs(paragraph.EndIndent) > Tolerance ||
                    paragraph.EveryLineComposer != false ||
                    Math.Abs(paragraph.FirstLineIndent) > Tolerance ||
                    paragraph.GlyphSpacing.Length != 3 ||
                    Math.Abs(paragraph.GlyphSpacing[0] - 1) > Tolerance ||
                    Math.Abs(paragraph.GlyphSpacing[1] - 1) > Tolerance ||
                    Math.Abs(paragraph.GlyphSpacing[2] - 1) > Tolerance ||
                    paragraph.Hanging != false ||
                    paragraph.HyphenatedWordSize != 6 ||
                    paragraph.KinsokuOrder != 0 ||
                    paragraph.LetterSpacing.Length != 3 ||
                    Math.Abs(paragraph.LetterSpacing[0]) > Tolerance ||
                    Math.Abs(paragraph.LetterSpacing[1]) > Tolerance ||
                    Math.Abs(paragraph.LetterSpacing[2]) > Tolerance ||
                    paragraph.LeadingType != LeadingMode.Auto ||
                    paragraph.PreHyphen != 2 ||
                    paragraph.PostHyphen != 2 ||
                    Math.Abs(paragraph.SpaceBefore) > Tolerance ||
                    Math.Abs(paragraph.SpaceAfter) > Tolerance ||
                    paragraph.WordSpacing.Length != 3 ||
                    Math.Abs(paragraph.WordSpacing[0] - 0.8) > Tolerance ||
                    Math.Abs(paragraph.WordSpacing[1] - 1.0) > Tolerance ||
                    Math.Abs(paragraph.WordSpacing[2] - 1.33) > Tolerance ||
                    Math.Abs(paragraph.Zone - 36.0) > Tolerance)
                {
                    throw new Exception();
                }
            }

            // التحقق من بيانات النمط
            // الأنماط لها ألوان مختلفة وحجم الخط
            if (Math.Abs(portions[0].Style.FontSize - 12) > Tolerance ||
                Math.Abs(portions[1].Style.FontSize - 12) > Tolerance ||
                Math.Abs(portions[2].Style.FontSize - 12) > Tolerance ||
                Math.Abs(portions[3].Style.FontSize - 10) > Tolerance)
            {
                throw new Exception();
            }

            if (portions[0].Style.FillColor != Color.FromArgb(255, 145, 0, 0) ||
                portions[1].Style.FillColor != Color.FromArgb(255, 201, 128, 2) ||
                portions[2].Style.FillColor != Color.FromArgb(255, 18, 143, 4) ||
                portions[3].Style.FillColor != Color.FromArgb(255, 145, 42, 100))
            {
                throw new Exception();
            }

            for (int j = 0; j < portions.Length; j++)
            {
                var style = portions[j].Style;

                if (style.AutoLeading != true ||
                    style.HindiNumbers != false ||
                    style.Kerning != 0 ||
                    style.Leading != 0 ||
                    style.StrokeColor != Color.FromArgb(255, 175, 90, 163) ||
                    style.Tracking != 50)
                {
                    throw new Exception();
                }
            }

            // مثال على تحرير النص
            portions[0].Text = "Hello ";
            portions[1].Text = "World";

            // مثال على إزالة أجزاء النص
            layer.TextData.RemovePortion(3);
            layer.TextData.RemovePortion(2);

            // مثال على إضافة جزء نصي جديد
            var createdPortion = layer.TextData.ProducePortion();
            createdPortion.Text = "!!!\r";
            layer.TextData.AddPortion(createdPortion);

            portions = layer.TextData.Items;

            // مثال على تحرير الفقرة والنمط للأجزاء
            // ضبط التبرير الصحيح
            portions[0].Paragraph.Justification = JustificationMode.Right;
            portions[1].Paragraph.Justification = JustificationMode.Right;
            portions[2].Paragraph.Justification = JustificationMode.Right;

            // ألوان مختلفة لكل نمط. سيتم تغيير ، ولكن التقديم غير مدعوم بشكل كامل
            portions[0].Style.FillColor = Color.Aquamarine;
            portions[1].Style.FillColor = Color.Violet;
            portions[2].Style.FillColor = Color.LightBlue;

            // خط مختلف. سيتم تغيير ، ولكن التقديم غير مدعوم بشكل كامل
            portions[0].Style.FontSize = 6;
            portions[1].Style.FontSize = 8;
            portions[2].Style.FontSize = 10;

            layer.TextData.UpdateLayerData();

            im.Save(outputPath, new PsdOptions(im));

            break;
        }
    }
}

أنظر أيضا