文档 - 转档（向后兼容）控制参数配置指导手册

PropertySettingGuide/PropertySettingGuide.md

@@ -210,6 +210,10 @@
 
 
 ##三、参数设置规则
+参数设置文件，在 Xcode 工程AdvanceSettingPropertyRules.plist 文件中，亦可直接修改位于 App 的如下配置文件中的配置：
+
+	xxx//KdanAuto.app/Contents/Resources/AdvanceSettingPropertyRules.plist
+
 ### Classs - 测试类型设置
 作用于具体文档的具体测试类型，目前有支持的测试类型有：AutoTest（全类型文档，自动转档及快照对照测试）、PDFCompareTest（PDF 文档，逐页快照对比测试）、StringAutoTest（TXT/RTF 文档，自动转档及字符对比测试）、StringAutoCompare（TXT/RTF 文档，字符对比测试)
 
@@ -314,5 +318,173 @@
 ### Params - 转档控制参数设置
 用于控制转档成各种文档过程中的转档控制参数，支持参数种类有 *BOOL*、*Bool*、*bool*、*size_t*、*int*、*uint8_t*、*int8_t*、*int16_t*、*uint16_t*、*int32_t*、*uint32_t*、*int64_t*、*uint64_t*、*NSInteger*、*NSUInteger*、*float*、*double*、*CGRect*、*NSRect*、*CGSize*、*NSSize*、*NSString*以及*枚举值*
 
-####1、各
+####【参数设置示例】BOOL
+SDK 接口头文件公开的，支持外部设置的BOOl 类型属性
+
+	 如CSV 格式转档，控制 CSV 表格是否合并的参数 isMergeCSV（如下图）
+	 - 参数类型(ValueType):BOOL
+	 - 属性(Property)：isMergeCSV
+	 - 属性别名(Name): Merge CSV (可自定)
+	 - 默认值(DefaultValue):NO(待定)
+	 
+![](bool.param.png)
+
+	//plist 中对应的设置, 效果如下图
+	<dict>
+		<key>ValueType</key>
+		<string>BOOL</string>
+		<key>Property</key>
+		<string>isMergeCSV</string>
+		<key>Name</key>
+		<string>Merge CSV</string>
+		<key>DefaultValue</key>
+		<false/>
+	</dict>
+
+![](bool.property.png)
+
+在 KdanAuto 参数设置界面呈现的效果
+
+![](bool.ui.png)
+
+
+####【参数设置示例】NSInteger(枚举)
+SDK 接口头文件公开的，支持外部设置的NSInteger （枚举类型）属性
+
+	 如Excel 格式转档，控制 Excel 转档的参数 'contentOptions' 和 'worksheetOptions'（如下图）
+	 
+	 属性contentOptions相关信息：
+	 - 参数类型(ValueType):CPDFConvertExcelContentOptions，实际是NSInteger类型
+	 - 属性(Property)：contentOptions
+	 - 属性别名(Name): Content Options (可自定)
+	 - 默认值(DefaultValue): 2(对应 CPDFConvertExcelContentAllContent，待定)
+	 - 枚举值可选项(Values)：
+		 - 	选项一：
+		 	- 名称(Name)： Only Text(可自定)
+		 	- 参数值(Value): 0
+		 - 	选项二：
+		 	- 名称(Name)： Only Table(可自定)
+		 	- 参数值(Value): 1
+		 - 	选项三：
+		 	- 名称(Name)： All Content(可自定)
+		 	- 参数值(Value): 2
+	 
+	 属性worksheetOptions相关信息：
+	 - 参数类型(ValueType):CPDFConvertExcelWorksheetOptions，实际是NSInteger类型
+	 - 属性(Property)：worksheetOptions
+	 - 属性别名(Name): Worksheet Options (可自定)
+	 - 默认值(DefaultValue): 0(对应 CPDFConvertExcelWorksheetForEachTable，待定)
+	 - 枚举值可选项(Values)：
+		 - 	选项一：
+		 	- 名称(Name)： EachTable(可自定)
+		 	- 参数值(Value): 0
+		 - 	选项二：
+		 	- 名称(Name)： EachPage(可自定)
+		 	- 参数值(Value): 1
+		 - 	选项三：
+		 	- 名称(Name)： For The Document(可自定)
+		 	- 参数值(Value): 2
+	 
+![](enum.params.png)
+
+	//plist 中contentOptions属性对应的设置, 效果如下图
+	<dict>
+		<key>ValueType</key>
+		<string>NSInteger</string>
+		<key>Property</key>
+		<string>contentOptions</string>
+		<key>Name</key>
+		<string>Content Options</string>
+		<key>DefaultValue</key>
+		<integer>2</integer>
+		<key>Values</key>
+		<array>
+			<dict>
+				<key>Value</key>
+				<integer>0</integer>
+				<key>Name</key>
+				<string>Only Text</string>
+			</dict>
+			<dict>
+				<key>Value</key>
+				<integer>1</integer>
+				<key>Name</key>
+				<string>Only Table</string>
+			</dict>
+			<dict>
+				<key>Value</key>
+				<integer>2</integer>
+				<key>Name</key>
+				<string>All Content</string>
+			</dict>
+		</array>
+	</dict>
+	
+	//plist 中worksheetOptions属性对应的设置, 效果如下图
+	<dict>
+		<key>ValueType</key>
+		<string>NSInteger</string>
+		<key>Property</key>
+		<string>worksheetOptions</string>
+		<key>Name</key>
+		<string>Worksheet Options</string>
+		<key>DefaultValue</key>
+		<real>0</real>
+		<key>Values</key>
+		<array>
+			<dict>
+				<key>Value</key>
+				<integer>0</integer>
+				<key>Name</key>
+				<string>EachTable</string>
+			</dict>
+			<dict>
+				<key>Value</key>
+				<integer>1</integer>
+				<key>Name</key>
+				<string>EachPage</string>
+			</dict>
+			<dict>
+				<key>Value</key>
+				<integer>2</integer>
+				<key>Name</key>
+				<string>For The Document</string>
+			</dict>
+		</array>
+	</dict>
+
+![](enum.property.png)
+
+在 KdanAuto 参数设置界面呈现的效果
+
+![](enum.ui.png)
+
+
+####【参数设置示例】int
+SDK 接口头文件公开的，支持外部设置的int 类型属性
+
+	 如Img 格式转档，控制 图片清晰度的 DPI 参数 'imageDpi'（如下图）
+	 - 参数类型(ValueType):int
+	 - 属性(Property)：imageDpi
+	 - 属性别名(Name): Image DPI (可自定)
+	 - 默认值(DefaultValue):216(待定)
+	 
+![](int.params.png)
+
+	//plist 中对应的设置, 效果如下图
+	<dict>
+		<key>ValueType</key>
+		<string>int</string>
+		<key>Property</key>
+		<string>imageDpi</string>
+		<key>Name</key>
+		<string>Image DPI</string>
+		<key>DefaultValue</key>
+		<integer>216</integer>
+	</dict>
+
+![](int.property.png)
+
+在 KdanAuto 参数设置界面呈现的效果
 
+![](int.ui.png)