set_table_cell_alignment
Adjust text alignment within specific table cells in Microsoft Word documents to control horizontal and vertical positioning for improved document formatting.
Instructions
Set text alignment for a specific table cell.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filename | Yes | ||
| table_index | Yes | ||
| row_index | Yes | ||
| col_index | Yes | ||
| horizontal | No | left | |
| vertical | No | top |
Implementation Reference
- Primary asynchronous handler implementing the tool logic: validates parameters, loads and saves the document, verifies table and cell indices, calls core helper, and returns formatted success/error message.async def set_table_cell_alignment(filename: str, table_index: int, row_index: int, col_index: int, horizontal: str = "left", vertical: str = "top") -> str: """Set text alignment for a specific table cell. Args: filename: Path to the Word document table_index: Index of the table (0-based) row_index: Row index (0-based) col_index: Column index (0-based) horizontal: Horizontal alignment ("left", "center", "right", "justify") vertical: Vertical alignment ("top", "center", "bottom") """ filename = ensure_docx_extension(filename) # Ensure numeric parameters are the correct type try: table_index = int(table_index) row_index = int(row_index) col_index = int(col_index) except (ValueError, TypeError): return "Invalid parameter: table_index, row_index, and col_index must be integers" # Validate alignment parameters valid_horizontal = ["left", "center", "right", "justify"] valid_vertical = ["top", "center", "bottom"] if horizontal.lower() not in valid_horizontal: return f"Invalid horizontal alignment. Valid options: {', '.join(valid_horizontal)}" if vertical.lower() not in valid_vertical: return f"Invalid vertical alignment. Valid options: {', '.join(valid_vertical)}" if not os.path.exists(filename): return f"Document {filename} does not exist" # Check if file is writeable is_writeable, error_message = check_file_writeable(filename) if not is_writeable: return f"Cannot modify document: {error_message}. Consider creating a copy first." try: doc = Document(filename) # Validate table index if table_index < 0 or table_index >= len(doc.tables): return f"Invalid table index. Document has {len(doc.tables)} tables (0-{len(doc.tables)-1})." table = doc.tables[table_index] # Apply cell alignment success = set_cell_alignment_by_position(table, row_index, col_index, horizontal, vertical) if success: doc.save(filename) return f"Cell alignment set successfully for table {table_index}, cell ({row_index},{col_index}) to {horizontal}/{vertical}." else: return f"Failed to set cell alignment. Check that indices are valid." except Exception as e: return f"Failed to set cell alignment: {str(e)}"
- word_document_server/main.py:273-277 (registration)MCP tool registration using FastMCP @mcp.tool() decorator. Provides synchronous wrapper with argument types and docstring schema, delegating to the async handler in format_tools.@mcp.tool() def set_table_cell_alignment(filename: str, table_index: int, row_index: int, col_index: int, horizontal: str = "left", vertical: str = "top"): """Set text alignment for a specific table cell.""" return format_tools.set_table_cell_alignment(filename, table_index, row_index, col_index, horizontal, vertical)
- Core helper function that validates row/col indices, retrieves the target table cell, and applies alignment via low-level set_cell_alignment function.def set_cell_alignment_by_position(table, row_index, col_index, horizontal="left", vertical="top"): """ Set text alignment for a specific cell by position. Args: table: The table containing the cell row_index: Row index (0-based) col_index: Column index (0-based) horizontal: Horizontal alignment ("left", "center", "right", "justify") vertical: Vertical alignment ("top", "center", "bottom") Returns: True if successful, False otherwise """ try: if (0 <= row_index < len(table.rows) and 0 <= col_index < len(table.rows[row_index].cells)): cell = table.rows[row_index].cells[col_index] return set_cell_alignment(cell, horizontal, vertical) else: return False except Exception as e: print(f"Error setting cell alignment by position: {e}") return False