ConvertUtil

ConvertUtil class

يوفر وظائف مساعدة للتحويل بين وحدات القياس المختلفة.

لمعرفة المزيد، قم بزيارةالتحويل بين وحدات القياس مقالة توثيقية.

public static class ConvertUtil

طُرق

اسموصف
static InchToPoint(double)يحول البوصات إلى نقاط.
static MillimeterToPoint(double)يحول الملليمترات إلى نقاط.
static PixelToNewDpi(double, double, double)يحول وحدات البكسل من دقة إلى أخرى.
static PixelToPoint(double)يحول وحدات البكسل إلى نقاط بدقة 96 نقطة في البوصة.
static PixelToPoint(double, double)يحول وحدات البكسل إلى نقاط بدقة البكسل المحددة.
static PointToInch(double)يحول النقاط إلى بوصات.
static PointToPixel(double)يحول النقاط إلى بكسلات بدقة 96 نقطة في البوصة.
static PointToPixel(double, double)يحول النقاط إلى بكسلات بدقة البكسل المحددة.

أمثلة

يوضح كيفية ضبط حجم الورق والاتجاه والهوامش، إلى جانب الإعدادات الأخرى لقسم ما.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.PageSetup.PaperSize = PaperSize.Legal;
builder.PageSetup.Orientation = Orientation.Landscape;
builder.PageSetup.TopMargin = ConvertUtil.InchToPoint(1.0);
builder.PageSetup.BottomMargin = ConvertUtil.InchToPoint(1.0);
builder.PageSetup.LeftMargin = ConvertUtil.InchToPoint(1.5);
builder.PageSetup.RightMargin = ConvertUtil.InchToPoint(1.5);
builder.PageSetup.HeaderDistance = ConvertUtil.InchToPoint(0.2);
builder.PageSetup.FooterDistance = ConvertUtil.InchToPoint(0.2);

builder.Writeln("Hello world!");

doc.Save(ArtifactsDir + "PageSetup.PageMargins.docx");

يوضح كيفية تحديد خصائص الصفحة بالبوصات.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// يحدد "إعداد الصفحة" الخاص بالقسم حجم هوامش الصفحة بالنقاط.
// يمكننا أيضًا استخدام فئة "ConvertUtil" لاستخدام وحدة قياس أكثر شيوعًا،
// مثل البوصات عند تحديد الحدود.
PageSetup pageSetup = builder.PageSetup;
pageSetup.TopMargin = ConvertUtil.InchToPoint(1.0);
pageSetup.BottomMargin = ConvertUtil.InchToPoint(2.0);
pageSetup.LeftMargin = ConvertUtil.InchToPoint(2.5);
pageSetup.RightMargin = ConvertUtil.InchToPoint(1.5);

//البوصة تساوي 72 نقطة.
Assert.AreEqual(72.0d, ConvertUtil.InchToPoint(1));
Assert.AreEqual(1.0d, ConvertUtil.PointToInch(72));

//أضف محتوى لإظهار الهوامش الجديدة.
builder.Writeln($"This Text is {pageSetup.LeftMargin} points/{ConvertUtil.PointToInch(pageSetup.LeftMargin)} inches from the left, " +
                $"{pageSetup.RightMargin} points/{ConvertUtil.PointToInch(pageSetup.RightMargin)} inches from the right, " +
                $"{pageSetup.TopMargin} points/{ConvertUtil.PointToInch(pageSetup.TopMargin)} inches from the top, " +
                $"and {pageSetup.BottomMargin} points/{ConvertUtil.PointToInch(pageSetup.BottomMargin)} inches from the bottom of the page.");

doc.Save(ArtifactsDir + "UtilityClasses.PointsAndInches.docx");

أنظر أيضا

ControlChar Class Document Class