enum: add WD_PARAGRAPH_ALIGNMENT enumeration

onlyjus · Steve Canny · commit 38aeb63e7a09 · 2014-06-27T01:36:19.000-07:00
diff --git a/docs/api/enum/WdAlignParagraph.rst b/docs/api/enum/WdAlignParagraph.rst
@@ -0,0 +1,45 @@
+.. _WdParagraphAlignment:
+
+``WD_PARAGRAPH_ALIGNMENT``
+==========================
+
+alias: **WD_ALIGN_PARAGRAPH**
+
+Specifies paragraph justification type.
+
+Example::
+
+    from docx.enum.text import WD_ALIGN_PARAGRAPH
+
+    paragraph = document.add_paragraph()
+    paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER
+
+----
+
+LEFT
+    Left-aligned
+
+CENTER
+    Center-aligned.
+
+RIGHT
+    Right-aligned.
+
+JUSTIFY
+    Fully justified.
+
+DISTRIBUTE
+    Paragraph characters are distributed to fill the entire width of the
+    paragraph.
+
+JUSTIFY_MED
+    Justified with a medium character compression ratio.
+
+JUSTIFY_HI
+    Justified with a high character compression ratio.
+
+JUSTIFY_LOW
+    Justified with a low character compression ratio.
+
+THAI_JUSTIFY
+    Justified according to Thai formatting layout.
diff --git a/docs/api/enum/index.rst b/docs/api/enum/index.rst
@@ -8,6 +8,7 @@ can be found here:
 .. toctree::
    :titlesonly:
 
+   WdAlignParagraph
    WdOrientation
    WdSectionStart
    WdUnderline
diff --git a/docx/enum/text.py b/docx/enum/text.py
@@ -6,7 +6,62 @@
 
 from __future__ import absolute_import, print_function, unicode_literals
 
-from .base import XmlEnumeration, XmlMappedEnumMember
+from .base import alias, XmlEnumeration, XmlMappedEnumMember
+
+
+@alias('WD_ALIGN_PARAGRAPH')
+class WD_PARAGRAPH_ALIGNMENT(XmlEnumeration):
+    """
+    alias: **WD_ALIGN_PARAGRAPH**
+
+    Specifies paragraph justification type.
+
+    Example::
+
+        from docx.enum.text import WD_ALIGN_PARAGRAPH
+
+        paragraph = document.add_paragraph()
+        paragraph.alignment = WD_ALIGN_PARAGRAPH.CENTER
+    """
+
+    __ms_name__ = 'WdParagraphAlignment'
+
+    __url__ = 'http://msdn.microsoft.com/en-us/library/office/ff835817.aspx'
+
+    __members__ = (
+        XmlMappedEnumMember(
+            'LEFT', 0, 'left', 'Left-aligned'
+        ),
+        XmlMappedEnumMember(
+            'CENTER', 1, 'center', 'Center-aligned.'
+        ),
+        XmlMappedEnumMember(
+            'RIGHT', 2, 'right', 'Right-aligned.'
+        ),
+        XmlMappedEnumMember(
+            'JUSTIFY', 3, 'both', 'Fully justified.'
+        ),
+        XmlMappedEnumMember(
+            'DISTRIBUTE', 4, 'distribute', 'Paragraph characters are distrib'
+            'uted to fill the entire width of the paragraph.'
+        ),
+        XmlMappedEnumMember(
+            'JUSTIFY_MED', 5, 'mediumKashida', 'Justified with a medium char'
+            'acter compression ratio.'
+        ),
+        XmlMappedEnumMember(
+            'JUSTIFY_HI', 7, 'highKashida', 'Justified with a high character'
+            ' compression ratio.'
+        ),
+        XmlMappedEnumMember(
+            'JUSTIFY_LOW', 8, 'lowKashida', 'Justified with a low character '
+            'compression ratio.'
+        ),
+        XmlMappedEnumMember(
+            'THAI_JUSTIFY', 9, 'thaiDistribute', 'Justified according to Tha'
+            'i formatting layout.'
+        ),
+    )
 
 
 class WD_BREAK_TYPE(object):
