enum: add WD_TABLE_DIRECTION enumeration

Steve Canny · Steve Canny · commit 221e28c0e47e · 2015-02-21T14:59:33.000-08:00
diff --git a/docs/api/enum/WdTableDirection.rst b/docs/api/enum/WdTableDirection.rst
@@ -0,0 +1,24 @@
+.. _WdTableDirection:
+
+``WD_TABLE_DIRECTION``
+======================
+
+Specifies the direction in which an application orders cells in the
+specified table or row.
+
+Example::
+
+    from docx.enum.table import WD_TABLE_DIRECTION
+
+    table = document.add_table(3, 3)
+    table.direction = WD_TABLE_DIRECTION.RTL
+
+----
+
+LTR
+    The table or row is arranged with the first column in the leftmost
+    position.
+
+RTL
+    The table or row is arranged with the first column in the rightmost
+    position.
diff --git a/docs/api/enum/index.rst b/docs/api/enum/index.rst
@@ -17,4 +17,5 @@ can be found here:
    WdSectionStart
    WdStyleType
    WdRowAlignment
+   WdTableDirection
    WdUnderline
diff --git a/docx/enum/table.py b/docx/enum/table.py
@@ -4,9 +4,13 @@
 Enumerations related to tables in WordprocessingML files
 """
 
-from __future__ import absolute_import, print_function, unicode_literals
+from __future__ import (
+    absolute_import, division, print_function, unicode_literals
+)
 
-from .base import XmlEnumeration, XmlMappedEnumMember
+from .base import (
+    Enumeration, EnumMember, XmlEnumeration, XmlMappedEnumMember
+)
 
 
 class WD_TABLE_ALIGNMENT(XmlEnumeration):
@@ -36,3 +40,32 @@ class WD_TABLE_ALIGNMENT(XmlEnumeration):
             'RIGHT', 2, 'right', 'Right-aligned.'
         ),
     )
+
+
+class WD_TABLE_DIRECTION(Enumeration):
+    """
+    Specifies the direction in which an application orders cells in the
+    specified table or row.
+
+    Example::
+
+        from docx.enum.table import WD_TABLE_DIRECTION
+
+        table = document.add_table(3, 3)
+        table.direction = WD_TABLE_DIRECTION.RTL
+    """
+
+    __ms_name__ = 'WdTableDirection'
+
+    __url__ = ' http://msdn.microsoft.com/en-us/library/ff835141.aspx'
+
+    __members__ = (
+        EnumMember(
+            'LTR', 0, 'The table or row is arranged with the first column '
+            'in the leftmost position.'
+        ),
+        EnumMember(
+            'RTL', 1, 'The table or row is arranged with the first column '
+            'in the rightmost position.'
+        ),
+    )
