Конвертирование единиц измерения
Разные пользователи используют разные системы измерений. Для удобства, DocumentCore имеет класс для преобразования значений в разных единицах измерения.
LengthUnitConverter может конвертировать между:
- Точка - 1 точка равна 1/72 дюйма.
- Пиксель - 1 пиксель равен 1/96 пикселя.
- Дюйм - 1 дюйм равен 72 точкам или 25,4 мм.
- Миллиметр - 1 миллиметр равен 1/10 сантиметра.
- Сантиметр - 1 сантиметр равен 10 миллиметрам или ≈ 0,3937008 дюйма.
- Пика - 1 пика равна 12 точкам.
- Твипы - 1 твип равен 1/20 балла.
- Английская метрическая единица измерения - 1 балл равен 12700 EMUs.
Давайте посмотрим на пример использования LengthUnitConverter. Скажем, нам нужно указать поля страницы. Эти значения должны быть в пунктах, но для нас удобнее использовать сантиметры и миллиметры:
Полный код
GitHubusing System;
using SautinSoft.Document;
namespace Sample
{
class Sample
{
static void Main(string[] args)
{
// Get your free 100-day key here:
// https://sautinsoft.com/start-for-free/
ConvertPointsTo();
UsingUnitConversion();
}
/// <summary>
/// Shows what is the one point is equal in different units.
/// </summary>
/// <remarks>
/// Details: https://sautinsoft.com/products/document/help/net/developer-guide/unit-conversion.php
public static void ConvertPointsTo()
{
foreach (LengthUnit unit in Enum.GetValues(typeof(LengthUnit)))
{
string s = string.Format("1 point = {0} {1}",
LengthUnitConverter.Convert(1, LengthUnit.Point, unit),
unit.ToString().ToLowerInvariant());
Console.WriteLine(s);
}
Console.WriteLine("Press any key...");
Console.ReadKey();
}
/// <summary>
/// How to convert between different units.
/// </summary>
/// <remarks>
/// Details: https://sautinsoft.com/products/document/help/net/developer-guide/unit-conversion.php
public static void UsingUnitConversion()
{
DocumentCore dc = new DocumentCore();
// Add new section.
Section s1 = new Section(dc);
s1.PageSetup.PageWidth = LengthUnitConverter.Convert(100, LengthUnit.Millimeter, LengthUnit.Point);
s1.PageSetup.PageHeight = LengthUnitConverter.Convert(1, LengthUnit.Inch, LengthUnit.Point);
s1.PageSetup.PageMargins.Left = LengthUnitConverter.Convert(0.3, LengthUnit.Centimeter, LengthUnit.Point);
s1.PageSetup.PageMargins.Top = LengthUnitConverter.Convert(7, LengthUnit.Pixel, LengthUnit.Point);
s1.PageSetup.PageMargins.Right = LengthUnitConverter.Convert(100, LengthUnit.Twip, LengthUnit.Point);
s1.PageSetup.PageMargins.Bottom = LengthUnitConverter.Convert(5, LengthUnit.Millimeter, LengthUnit.Point);
dc.Sections.Add(s1);
s1.Content.Start.Insert("You are welcome!", new CharacterFormat() { FontColor = Color.Orange, Size = 36 });
dc.Save("Result.docx");
// Open the result for demonstration purposes.
System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo("Result.docx") { UseShellExecute = true });
}
}
}Imports System
Imports System.IO
Imports SautinSoft.Document
Module Sample
Sub Main()
ConvertPointsTo()
UsingUnitConversion()
End Sub
''' Get your free 100-day key here:
''' https://sautinsoft.com/start-for-free/
''' <summary>
''' Shows what is the one point is equal in different units.
''' </summary>
''' <remarks>
''' Details: https://sautinsoft.com/products/document/help/net/developer-guide/unit-conversion.php
''' </remarks>
Sub ConvertPointsTo()
For Each unit As LengthUnit In System.Enum.GetValues(GetType(LengthUnit))
Dim s As String = String.Format("1 point = {0} {1}", LengthUnitConverter.Convert(1, LengthUnit.Point, unit), unit.ToString().ToLowerInvariant())
Console.WriteLine(s)
Next unit
Console.WriteLine("Press any key...")
Console.ReadKey()
End Sub
''' <summary>
''' How to convert between different units.
''' </summary>
''' <remarks>
''' Details: https://sautinsoft.com/products/document/help/net/developer-guide/unit-conversion.php
''' </remarks>
Sub UsingUnitConversion()
Dim dc As New DocumentCore()
' Add new section.
Dim s1 As New Section(dc)
s1.PageSetup.PageWidth = LengthUnitConverter.Convert(100, LengthUnit.Millimeter, LengthUnit.Point)
s1.PageSetup.PageHeight = LengthUnitConverter.Convert(1, LengthUnit.Inch, LengthUnit.Point)
s1.PageSetup.PageMargins.Left = LengthUnitConverter.Convert(0.3, LengthUnit.Centimeter, LengthUnit.Point)
s1.PageSetup.PageMargins.Top = LengthUnitConverter.Convert(7, LengthUnit.Pixel, LengthUnit.Point)
s1.PageSetup.PageMargins.Right = LengthUnitConverter.Convert(100, LengthUnit.Twip, LengthUnit.Point)
s1.PageSetup.PageMargins.Bottom = LengthUnitConverter.Convert(5, LengthUnit.Millimeter, LengthUnit.Point)
dc.Sections.Add(s1)
s1.Content.Start.Insert("You are welcome!", New CharacterFormat() With {
.FontColor = Color.Orange,
.Size = 36
})
dc.Save("Result.docx")
' Open the result for demonstration purposes.
System.Diagnostics.Process.Start(New System.Diagnostics.ProcessStartInfo("Result.docx") With {.UseShellExecute = True})
End Sub
End ModuleЕсли вам нужен пример кода или у вас есть вопрос: напишите нам по адресу support@sautinsoft.ru или спросите в онлайн-чате (правый нижний угол этой страницы) или используйте форму ниже: