# GrapeCity.Documents.Common.Unit

## Content

<div class="doc-site-dotnet-api-container">



  <h1 id="GrapeCity_Documents_Common_Unit" data-uid="GrapeCity.Documents.Common.Unit" class="text-break">Unit Struct
</h1>
  <div class="markdown level0 summary"><p>A utility structure specifying some values related to units of measurement.</p>
</div>
  <div class="markdown level0 conceptual"></div>
  <h6><strong>Namespace</strong>: <a class="xref" href="GrapeCity.Documents.Common.html">GrapeCity.Documents.Common</a></h6>
  <h6><strong>Assembly</strong>: DS.Documents.Imaging.dll</h6>
  <h5 id="GrapeCity_Documents_Common_Unit_syntax">Syntax</h5>
  <div class="codewrapper">
    <pre><code class="lang-csharp hljs">public struct Unit</code></pre>
  </div>
  <div class="codewrapper">
    <pre><code class="lang-vbnet hljs">Public Structure Unit</code></pre>
  </div>
  <h3 id="constructors">Constructors
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit__ctor_System_Single_GrapeCity_Documents_Common_UnitTypeEnum_" data-uid="GrapeCity.Documents.Common.Unit.#ctor(System.Single,GrapeCity.Documents.Common.UnitTypeEnum)">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.-ctor.html#GrapeCity_Documents_Common_Unit__ctor_System_Single_GrapeCity_Documents_Common_UnitTypeEnum_">Unit(float, UnitTypeEnum)</a>
        </td>
        <td class="markdown level1 summary"><p>Initializes a new instance of the <a class="xref" href="GrapeCity.Documents.Common.Unit.html">Unit</a> structure.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit__ctor_System_String_" data-uid="GrapeCity.Documents.Common.Unit.#ctor(System.String)">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.-ctor.html#GrapeCity_Documents_Common_Unit__ctor_System_String_">Unit(string)</a>
        </td>
        <td class="markdown level1 summary"><p>Initializes a new instance of the <a class="xref" href="GrapeCity.Documents.Common.Unit.html">Unit</a> structure
from a string.
String should contain A numeric value qualified with unit of measurement, e.g. <b>&quot;28mm&quot;</b> or <b>&quot;7in&quot;</b>.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="fields">Fields
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_CmPerInch" data-uid="GrapeCity.Documents.Common.Unit.CmPerInch">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.CmPerInch.html">CmPerInch</a>
        </td>
        <td class="markdown level1 summary"><p>Centimeters per inch as double.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_DipPerInch" data-uid="GrapeCity.Documents.Common.Unit.DipPerInch">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.DipPerInch.html">DipPerInch</a>
        </td>
        <td class="markdown level1 summary"><p>DIP units per inch as double.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_DisplayPerInch" data-uid="GrapeCity.Documents.Common.Unit.DisplayPerInch">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.DisplayPerInch.html">DisplayPerInch</a>
        </td>
        <td class="markdown level1 summary"><p>Display units per inch as double.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_DocumentUnitsPerInch" data-uid="GrapeCity.Documents.Common.Unit.DocumentUnitsPerInch">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.DocumentUnitsPerInch.html">DocumentUnitsPerInch</a>
        </td>
        <td class="markdown level1 summary"><p>Document units per inch as double.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_MmPerInch" data-uid="GrapeCity.Documents.Common.Unit.MmPerInch">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.MmPerInch.html">MmPerInch</a>
        </td>
        <td class="markdown level1 summary"><p>Millimeters per inch as double.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_PicaPerInch" data-uid="GrapeCity.Documents.Common.Unit.PicaPerInch">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.PicaPerInch.html">PicaPerInch</a>
        </td>
        <td class="markdown level1 summary"><p>Picas per inch as double.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_PointsPerInch" data-uid="GrapeCity.Documents.Common.Unit.PointsPerInch">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.PointsPerInch.html">PointsPerInch</a>
        </td>
        <td class="markdown level1 summary"><p>Points per inch as double.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_TwipsPerInch" data-uid="GrapeCity.Documents.Common.Unit.TwipsPerInch">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.TwipsPerInch.html">TwipsPerInch</a>
        </td>
        <td class="markdown level1 summary"><p>Twips per inch as double.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_Zero" data-uid="GrapeCity.Documents.Common.Unit.Zero">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.Zero.html">Zero</a>
        </td>
        <td class="markdown level1 summary"><p>Represents &quot;0mm&quot; value.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="properties">Properties
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_Units" data-uid="GrapeCity.Documents.Common.Unit.Units">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.Units.html#GrapeCity_Documents_Common_Unit_Units">Units</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the unit of measurement of the current unit.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_Value" data-uid="GrapeCity.Documents.Common.Unit.Value">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.Value.html#GrapeCity_Documents_Common_Unit_Value">Value</a>
        </td>
        <td class="markdown level1 summary"><p>Gets the value of the current unit (in <a class="xref" href="GrapeCity.Documents.Common.Unit.Units.html#GrapeCity_Documents_Common_Unit_Units">Units</a>).</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="methods">Methods
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_Convert_GrapeCity_Documents_Common_UnitTypeEnum_" data-uid="GrapeCity.Documents.Common.Unit.Convert(GrapeCity.Documents.Common.UnitTypeEnum)">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.Convert.html#GrapeCity_Documents_Common_Unit_Convert_GrapeCity_Documents_Common_UnitTypeEnum_">Convert(UnitTypeEnum)</a>
        </td>
        <td class="markdown level1 summary"><p>Converts value of this <a class="xref" href="GrapeCity.Documents.Common.Unit.html">Unit</a> structure to value in specified units of measurement.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_Convert_System_Single_GrapeCity_Documents_Common_UnitTypeEnum_GrapeCity_Documents_Common_UnitTypeEnum_" data-uid="GrapeCity.Documents.Common.Unit.Convert(System.Single,GrapeCity.Documents.Common.UnitTypeEnum,GrapeCity.Documents.Common.UnitTypeEnum)">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.Convert.html#GrapeCity_Documents_Common_Unit_Convert_System_Single_GrapeCity_Documents_Common_UnitTypeEnum_GrapeCity_Documents_Common_UnitTypeEnum_">Convert(float, UnitTypeEnum, UnitTypeEnum)</a>
        </td>
        <td class="markdown level1 summary"><p>Converts a value from one unit of measurement to another.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_Convert_System_Single_GrapeCity_Documents_Common_UnitTypeEnum_System_Single_" data-uid="GrapeCity.Documents.Common.Unit.Convert(System.Single,GrapeCity.Documents.Common.UnitTypeEnum,System.Single)">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.Convert.html#GrapeCity_Documents_Common_Unit_Convert_System_Single_GrapeCity_Documents_Common_UnitTypeEnum_System_Single_">Convert(float, UnitTypeEnum, float)</a>
        </td>
        <td class="markdown level1 summary"><p>Converts a value from one unit of measurement to pixel.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_Convert_System_Single_System_Single_GrapeCity_Documents_Common_UnitTypeEnum_" data-uid="GrapeCity.Documents.Common.Unit.Convert(System.Single,System.Single,GrapeCity.Documents.Common.UnitTypeEnum)">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.Convert.html#GrapeCity_Documents_Common_Unit_Convert_System_Single_System_Single_GrapeCity_Documents_Common_UnitTypeEnum_">Convert(float, float, UnitTypeEnum)</a>
        </td>
        <td class="markdown level1 summary"><p>Converts a value from pixel unit of measurement to another.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_Parse_System_String_" data-uid="GrapeCity.Documents.Common.Unit.Parse(System.String)">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.Parse.html#GrapeCity_Documents_Common_Unit_Parse_System_String_">Parse(string)</a>
        </td>
        <td class="markdown level1 summary"><p>Parses a string and creates a <a class="xref" href="GrapeCity.Documents.Common.Unit.html">Unit</a> instance from that string,
throws an exception if string is invalid.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_StringToUnitType_System_String_GrapeCity_Documents_Common_UnitTypeEnum__" data-uid="GrapeCity.Documents.Common.Unit.StringToUnitType(System.String,GrapeCity.Documents.Common.UnitTypeEnum@)">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.StringToUnitType.html#GrapeCity_Documents_Common_Unit_StringToUnitType_System_String_GrapeCity_Documents_Common_UnitTypeEnum__">StringToUnitType(string, ref UnitTypeEnum)</a>
        </td>
        <td class="markdown level1 summary"><p>Converts a string to a <a class="xref" href="GrapeCity.Documents.Common.UnitTypeEnum.html">UnitTypeEnum</a> value. The string can be one of the following:
&quot;doc&quot;, &quot;in&quot;, &quot;mm&quot;, &quot;pc&quot;, &quot;dsp&quot;, &quot;pt&quot;, &quot;tw&quot;, &quot;inhs&quot;, &quot;cm&quot;, &quot;dip&quot;.
This method is case-insensitive.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_ToString" data-uid="GrapeCity.Documents.Common.Unit.ToString">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.ToString.html#GrapeCity_Documents_Common_Unit_ToString">ToString()</a>
        </td>
        <td class="markdown level1 summary"><p>Converts the current object to a string.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_TryParse_System_String_GrapeCity_Documents_Common_Unit__" data-uid="GrapeCity.Documents.Common.Unit.TryParse(System.String,GrapeCity.Documents.Common.Unit@)">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.TryParse.html#GrapeCity_Documents_Common_Unit_TryParse_System_String_GrapeCity_Documents_Common_Unit__">TryParse(string, out Unit)</a>
        </td>
        <td class="markdown level1 summary"><p>Parses a string and creates <a class="xref" href="GrapeCity.Documents.Common.Unit.html">Unit</a> structure.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_TryParse_System_String_System_Single__GrapeCity_Documents_Common_UnitTypeEnum__" data-uid="GrapeCity.Documents.Common.Unit.TryParse(System.String,System.Single@,GrapeCity.Documents.Common.UnitTypeEnum@)">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.TryParse.html#GrapeCity_Documents_Common_Unit_TryParse_System_String_System_Single__GrapeCity_Documents_Common_UnitTypeEnum__">TryParse(string, out float, out UnitTypeEnum)</a>
        </td>
        <td class="markdown level1 summary"><p>Parses a string and gets <a class="xref" href="GrapeCity.Documents.Common.Unit.Value.html#GrapeCity_Documents_Common_Unit_Value">Value</a> and <a class="xref" href="GrapeCity.Documents.Common.Unit.Units.html#GrapeCity_Documents_Common_Unit_Units">Units</a> from that string.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_UnitTypeToString_GrapeCity_Documents_Common_UnitTypeEnum_" data-uid="GrapeCity.Documents.Common.Unit.UnitTypeToString(GrapeCity.Documents.Common.UnitTypeEnum)">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.UnitTypeToString.html#GrapeCity_Documents_Common_Unit_UnitTypeToString_GrapeCity_Documents_Common_UnitTypeEnum_">UnitTypeToString(UnitTypeEnum)</a>
        </td>
        <td class="markdown level1 summary"><p>Converts a <a class="xref" href="GrapeCity.Documents.Common.UnitTypeEnum.html">UnitTypeEnum</a> value to a string representation as in
the following table:</p>
<ul><li><span class="term">Document</span>"doc"</li><li><span class="term">Inch</span>"in"</li><li><span class="term">Millimeter</span>"mm"</li><li><span class="term">Pica</span>"pc"</li><li><span class="term">Point</span>"pt"</li><li><span class="term">Twip</span>"tw"</li><li><span class="term">InHs</span>"inhs"</li><li><span class="term">Centimeters</span>"cm"</li><li><span class="term">Dip</span>"dip"</li></ul>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="operators">Operators
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_op_Implicit_GrapeCity_Documents_Common_Unit__System_String" data-uid="GrapeCity.Documents.Common.Unit.op_Implicit(GrapeCity.Documents.Common.Unit)~System.String">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.op_Implicit.html#GrapeCity_Documents_Common_Unit_op_Implicit_GrapeCity_Documents_Common_Unit__System_String">implicit operator string(Unit)</a>
        </td>
        <td class="markdown level1 summary"><p>Converts a unit value to a string.</p>
</td>
      </tr>
      <tr>
        <td id="GrapeCity_Documents_Common_Unit_op_Implicit_System_String__GrapeCity_Documents_Common_Unit" data-uid="GrapeCity.Documents.Common.Unit.op_Implicit(System.String)~GrapeCity.Documents.Common.Unit">
          <a class="xref" href="GrapeCity.Documents.Common.Unit.op_Implicit.html#GrapeCity_Documents_Common_Unit_op_Implicit_System_String__GrapeCity_Documents_Common_Unit">implicit operator Unit(string)</a>
        </td>
        <td class="markdown level1 summary"><p>Converts a string to a <a class="xref" href="GrapeCity.Documents.Common.Unit.html">Unit</a> value (see <a class="xref" href="GrapeCity.Documents.Common.Unit.-ctor.html#GrapeCity_Documents_Common_Unit__ctor_System_String_">Unit(string)</a>.</p>
</td>
      </tr>
    </tbody>
  </table>

</div>
