Python 進階：解剖 Word 底層 – 手動封裝 CT_P 與 CT_Tbl 全攻略; from docx.text.paragraph import Paragraph ; from docx.table import Table; para = Paragraph(child, doc) ; table = Table(child, doc)

import os
from docx import Document
from docx.oxml.text.paragraph import CT_P
from docx.oxml.table import CT_Tbl
from docx.text.paragraph import Paragraph
from docx.table import Table

# ==========================================
# 第一步：生成測試用的 Word 文件
# ==========================================
def create_demo_docx(filename=r"D:\Temp\demo_structure.docx"):
    doc = Document()
    
    # 1. 加入標題 (Heading 1)
    doc.add_heading('這是標題一', level=1)
    
    # 2. 加入普通段落 (Normal)
    p = doc.add_paragraph('這是第一段普通文字。')
    p.style = 'Normal'
    
    # 3. 加入一個表格 (Table Grid)
    table = doc.add_table(rows=2, cols=2)
    table.style = 'Table Grid'
    table.cell(0, 0).text = "表頭A"
    table.cell(0, 1).text = "表頭B"
    table.cell(1, 0).text = "數據1"
    table.cell(1, 1).text = "數據2"
    
    # 4. 再加入一個段落 (Quote)
    p2 = doc.add_paragraph('這是結尾的引用文字。')
    p2.style = 'Quote'
    
    doc.save(filename)
    print(f"✅ 測試文件已生成: {filename}")
    return filename

# 生成文件
docx_file = create_demo_docx()

# ==========================================
# 第二步：遍歷底層並封裝物件
# ==========================================

print("\n🚀 開始遍歷文件內容 (依照出現順序)...\n")

# 1. 讀取文件
doc = Document(docx_file)

# 2. 遍歷 body 中的所有子元素
# doc.element.body 包含了文件中所有的內容元素，依照順序排列
for child in doc.element.body:
    
    # --- 情況 A: 遇到段落 (CT_P) ---
    if isinstance(child, CT_P):
        # 【關鍵操作】將 CT_P 封裝成 Paragraph 物件
        # 參數 1: child (底層 XML 元素)
        # 參數 2: doc (作為 parent，提供樣式等上下文)
        para = Paragraph(child, doc)
        
        print(f"[段落] 文字內容: {para.text}")
        print(f"       樣式名稱: {para.style.name}")
        print(f"[段落] 文字內容by CT_P: {child.text}")
        print(f"       樣式名稱by CT_P: {child.style}")
        
    # --- 情況 B: 遇到表格 (CT_Tbl) ---
    elif isinstance(child, CT_Tbl):
        # 【關鍵操作】將 CT_Tbl 封裝成 Table 物件
        # 參數 1: child (底層 XML 元素)
        # 參數 2: doc (作為 parent)
        table = Table(child, doc)
        
        # 封裝後就可以像平常一樣操作表格了
        first_cell_text = table.cell(0, 0).text
        row_count = len(table.rows)
        
        print(f"[表格] 第一格內容: {first_cell_text}")
        print(f"       總行數: {row_count}")
        print(f"       樣式名稱: {table.style.name}")

    # --- 情況 C: 其他元素 (如分節符號等) ---
    else:
        print(f"[其他] 發現未處理的元素類型: {type(child)}")

print("\n✅ 遍歷完成！")

# 清理生成的測試檔案 (可選)
# os.remove(docx_file)