您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

CoreText 實戰(二):段落樣式 CTParagraphStyle 全解

編輯:iOS 開發綜合

文字排版裡最瑣碎的部分往往不是畫上去,而是「怎麼排」。CoreText 把這部分交給了 CTParagraphStyle,透過 CTParagraphStyleSpecifier 一枚一枚設定。

一、段落樣式 specifier

typedef CF_ENUM(uint32_t, CTParagraphStyleSpecifier) {
    kCTParagraphStyleSpecifierAlignment = 0,          //對齊屬性
    kCTParagraphStyleSpecifierFirstLineHeadIndent = 1,//首行縮進
    kCTParagraphStyleSpecifierHeadIndent = 2,         //段頭縮進
    kCTParagraphStyleSpecifierTailIndent = 3,         //段尾縮進
    kCTParagraphStyleSpecifierTabStops = 4,           //制表符模式
    kCTParagraphStyleSpecifierDefaultTabInterval = 5, //默認tab間隔
    kCTParagraphStyleSpecifierLineBreakMode = 6,      //換行模式
    kCTParagraphStyleSpecifierLineHeightMultiple = 7, //多行高
    kCTParagraphStyleSpecifierMaximumLineHeight = 8,  //最大行高
    kCTParagraphStyleSpecifierMinimumLineHeight = 9,  //最小行高
    kCTParagraphStyleSpecifierLineSpacing = 10,       //行距
    kCTParagraphStyleSpecifierParagraphSpacing = 11,  //段落間距(段尾加上間隔)
    kCTParagraphStyleSpecifierParagraphSpacingBefore = 12, //段落前間距
    kCTParagraphStyleSpecifierBaseWritingDirection = 13,   //基本書寫方向
    kCTParagraphStyleSpecifierMaximumLineSpacing = 14,     //最大行距
    kCTParagraphStyleSpecifierMinimumLineSpacing = 15,     //最小行距
    kCTParagraphStyleSpecifierLineSpacingAdjustment = 16,  //行距調整
    kCTParagraphStyleSpecifierLineBoundsOptions = 17,
    kCTParagraphStyleSpecifierCount
};

二、對齊方式

typedef CF_ENUM(uint8_t, CTTextAlignment) {
    kCTTextAlignmentLeft = 0,      //左對齊
    kCTTextAlignmentRight = 1,     //右對齊
    kCTTextAlignmentCenter = 2,    //居中對齊
    kCTTextAlignmentJustified = 3, //兩端對齊
    kCTTextAlignmentNatural = 4,   //自然對齊
    kCTLeftTextAlignment      CT_ENUM_DEPRECATED(10_5, 10_11, 3_2, 9_0) = kCTTextAlignmentLeft,
    kCTRightTextAlignment     CT_ENUM_DEPRECATED(10_5, 10_11, 3_2, 9_0) = kCTTextAlignmentRight,
    kCTCenterTextAlignment    CT_ENUM_DEPRECATED(10_5, 10_11, 3_2, 9_0) = kCTTextAlignmentCenter,
    kCTJustifiedTextAlignment CT_ENUM_DEPRECATED(10_5, 10_11, 3_2, 9_0) = kCTTextAlignmentJustified,
    kCTNaturalTextAlignment   CT_ENUM_DEPRECATED(10_5, 10_11, 3_2, 9_0) = kCTTextAlignmentNatural
};

三、換行與截斷模式

typedef CF_ENUM(uint8_t, CTLineBreakMode) {
    kCTLineBreakByWordWrapping = 0,   //在單詞邊界換行,整詞放不下時整體換行,段落默認值
    kCTLineBreakByCharWrapping = 1,   //按字符換行,一個字符放不下時才換
    kCTLineBreakByClipping = 2,       //超出畫布邊緣的部分直接截除
    kCTLineBreakByTruncatingHead = 3, //截除前面,保留後面,前面以 ... 代替
    kCTLineBreakByTruncatingTail = 4, //截除後面,保留前面,後面以 ... 代替
    kCTLineBreakByTruncatingMiddle = 5//保留首尾,中間以 ... 代替
};

四、逐項程式碼

所有設定都透過 CTParagraphStyleSetting 結構體描述,最後交給 CTParagraphStyleCreate 一次生成。

1. 對齊方式

CTTextAlignment textAlignment = kCTTextAlignmentLeft;
CTParagraphStyleSetting alignmentStyleSetting;
alignmentStyleSetting.spec = kCTParagraphStyleSpecifierAlignment;
alignmentStyleSetting.valueSize = sizeof(textAlignment);
alignmentStyleSetting.value = &textAlignment;

2. 首行縮進

CGFloat firstLineIndentSize = 25.0f;
CTParagraphStyleSetting firstLineIndent;
firstLineIndent.spec = kCTParagraphStyleSpecifierFirstLineHeadIndent;
firstLineIndent.value = &firstLineIndentSize;
firstLineIndent.valueSize = sizeof(CGFloat);

3. 段頭縮進(不含第一行)

//文字左側距 context 最左側的距離
CGFloat headIndentSize = 25.0f;
CTParagraphStyleSetting headIndent;
headIndent.spec = kCTParagraphStyleSpecifierHeadIndent;
headIndent.valueSize = sizeof(CGFloat);
headIndent.value = &headIndentSize;

4. 段尾縮進

//文字最左側到文字最右側的距離
CGFloat tailIndentSize = 251.0f;
CTParagraphStyleSetting tailIndent;
tailIndent.spec = kCTParagraphStyleSpecifierTailIndent;
tailIndent.value = &tailIndentSize;
tailIndent.valueSize = sizeof(float);

5. 換行模式

(其他模式可自行對照前面的枚舉嘗試)

CTLineBreakMode lineBreak = kCTLineBreakByCharWrapping;
CTParagraphStyleSetting lineBreakMode;
lineBreakMode.spec = kCTParagraphStyleSpecifierLineBreakMode;
lineBreakMode.value = &lineBreak;
lineBreakMode.valueSize = sizeof(CTLineBreakMode);

6. 最大行高與最小行高

//超過 50 像素按 50 計算
CGFloat maxHeightSize = 50.0f;
CTParagraphStyleSetting maxHeightSetting;
maxHeightSetting.spec = kCTParagraphStyleSpecifierMaximumLineHeight;
maxHeightSetting.value = &maxHeightSize;
maxHeightSetting.valueSize = sizeof(CGFloat);

//不足 50 像素按 50 計算
CGFloat minHeightSize = 50.0f;
CTParagraphStyleSetting minHeightSetting;
minHeightSetting.spec = kCTParagraphStyleSpecifierMinimumLineHeight;
minHeightSetting.value = &minHeightSize;
minHeightSetting.valueSize = sizeof(CGFloat);

7. 多倍行高

//1.2 倍原始高度
CGFloat multipleHeight = 1.2f;
CTParagraphStyleSetting multipleHeightSetting;
multipleHeightSetting.spec = kCTParagraphStyleSpecifierLineHeightMultiple;
multipleHeightSetting.value = &multipleHeight;
multipleHeightSetting.valueSize = sizeof(CGFloat);

8. 最大行距與最小行距

//超過 5 像素按最大行距繪製
CGFloat maxLineSpace = 5.0f;
CTParagraphStyleSetting maxLineSpaceSetting;
maxLineSpaceSetting.spec = kCTParagraphStyleSpecifierMaximumLineSpacing;
maxLineSpaceSetting.valueSize = sizeof(CGFloat);
maxLineSpaceSetting.value = &maxLineSpace;

//不足 5 像素按最小行距繪製
CGFloat minLineSpace = 5.0f;
CTParagraphStyleSetting minLineSpaceSetting;
minLineSpaceSetting.spec = kCTParagraphStyleSpecifierMinimumLineSpacing;
minLineSpaceSetting.valueSize = sizeof(CGFloat);
minLineSpaceSetting.value = &minLineSpace;

9. 行距

CGFloat lineSpace = 25.0f;
CTParagraphStyleSetting lineSpaceSetting;
lineSpaceSetting.spec = kCTParagraphStyleSpecifierLineSpacing;
lineSpaceSetting.value = &lineSpace;
lineSpaceSetting.valueSize = sizeof(float);

10. 段前間隔

段落之間的距離。

CGFloat paragraghSpace = 15.0f;
CTParagraphStyleSetting paragraghInterval;
paragraghInterval.spec = kCTParagraphStyleSpecifierParagraphSpacing;
paragraghInterval.valueSize = sizeof(CGFloat);
paragraghInterval.value = &paragraghSpace;

使用時把需要的設定放進一個 CTParagraphStyleSetting 陣列,一次傳給 CTParagraphStyleCreate,最後記得 CFRelease。多個 spec 同時生效時若互相衝突(例如行高與行距同時設定),以約束力更強的那一個為準,實測最可靠。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved