textsplittingproperties.html

永中OFFICE二次开发帮助文档

 Range range = sheet.getRange("G3:G4");
 TextSplittingProperties textSplitting = new TextSplittingProperties();
 textSplitting.setSplittingType(TextSplittingConstants.DELIMITED);
 textSplitting.setTab(true);
 textSplitting.setSpace(true);
 textSplitting.setSemicolon(false);
 textSplitting.setComma(false);
 textSplitting.setOther(false);
 textSplitting.setOtherDelimiters(' ');
 textSplitting.setDimilitersAsOne(false);
 textSplitting.setTextQualifier(TextSplittingConstants.QUALIFIER_DOUBLE_QUOTES);
 textSplitting.setDecimalSeparator(TextSplittingConstants.SEPARATOR_POINT);
 textSplitting.setThousandsSeparator(TextSplittingConstants.SEPARATOR_COMMA);
 textSplitting.setDataFormat(new int[]{0,0,0});
 textSplitting.setCell(7,3);
 range.textSplitting(textSplitting);
 System.out.println(textSplitting.isDelimitersAsOne());</DL>
</DD>
</DL>
<HR>

<A NAME="isOther()"><!-- --></A><H3>
isOther</H3>
<PRE>
public boolean <B>isOther</B>()</PRE>
<DL>
<DD>判断有无其它分隔符号。
<P>
<DD><DL>

<DT><B>返回：</B><DD>布尔型值，如果使用其它符号分隔，则返回true；否则，返回false
 <p>
 <b>例子：</b>
 <pre>
 //此例在控制台输出有无其它分隔符号，true为有，false为无。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 sheet.setCellValue(3,7,"a b c");
 sheet.setCellValue(4,7,"x y z");
 Range range = sheet.getRange("G3:G4");
 TextSplittingProperties textSplitting = new TextSplittingProperties();
 textSplitting.setSplittingType(TextSplittingConstants.DELIMITED);
 textSplitting.setTab(true);
 textSplitting.setSpace(true);
 textSplitting.setSemicolon(false);
 textSplitting.setComma(false);
 textSplitting.setOther(false);
 textSplitting.setOtherDelimiters(' ');
 textSplitting.setDimilitersAsOne(false);
 textSplitting.setTextQualifier(TextSplittingConstants.QUALIFIER_DOUBLE_QUOTES);
 textSplitting.setDecimalSeparator(TextSplittingConstants.SEPARATOR_POINT);
 textSplitting.setThousandsSeparator(TextSplittingConstants.SEPARATOR_COMMA);
 textSplitting.setDataFormat(new int[]{0,0,0});
 textSplitting.setCell(7,3);
 range.textSplitting(textSplitting);
 System.out.println(textSplitting.isOther());</DL>
</DD>
</DL>
<HR>

<A NAME="isSemicolon()"><!-- --></A><H3>
isSemicolon</H3>
<PRE>
public boolean <B>isSemicolon</B>()</PRE>
<DL>
<DD>判断有无分号。
<P>
<DD><DL>

<DT><B>返回：</B><DD>布尔型值，如果有分号分隔，则返回true；否则，返回false
 <p>
 <b>例子：</b>
 <pre>
 //此例在控制台输出有无分号，true为有，false为无。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 sheet.setCellValue(3,7,"a b c");
 sheet.setCellValue(4,7,"x y z");
 Range range = sheet.getRange("G3:G4");
 TextSplittingProperties textSplitting = new TextSplittingProperties();
 textSplitting.setSplittingType(TextSplittingConstants.DELIMITED);
 textSplitting.setTab(true);
 textSplitting.setSpace(true);
 textSplitting.setSemicolon(false);
 textSplitting.setComma(false);
 textSplitting.setOther(false);
 textSplitting.setOtherDelimiters(' ');
 textSplitting.setDimilitersAsOne(false);
 textSplitting.setTextQualifier(TextSplittingConstants.QUALIFIER_DOUBLE_QUOTES);
 textSplitting.setDecimalSeparator(TextSplittingConstants.SEPARATOR_POINT);
 textSplitting.setThousandsSeparator(TextSplittingConstants.SEPARATOR_COMMA);
 textSplitting.setDataFormat(new int[]{0,0,0});
 textSplitting.setCell(7,3);
 range.textSplitting(textSplitting);
 System.out.println(textSplitting.isSemicolon());</DL>
</DD>
</DL>
<HR>

<A NAME="isSpace()"><!-- --></A><H3>
isSpace</H3>
<PRE>
public boolean <B>isSpace</B>()</PRE>
<DL>
<DD>判断有无空格。
<P>
<DD><DL>

<DT><B>返回：</B><DD>布尔型值，如果有空格分隔，则返回true；否则，返回false
 <p>
 <b>例子：</b>
 <pre>
 //此例在控制台输出有无空格，true为有，false为无。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 sheet.setCellValue(3,7,"a b c");
 sheet.setCellValue(4,7,"x y z");
 Range range = sheet.getRange("G3:G4");
 TextSplittingProperties textSplitting = new TextSplittingProperties();
 textSplitting.setSplittingType(TextSplittingConstants.DELIMITED);
 textSplitting.setTab(true);
 textSplitting.setSpace(true);
 textSplitting.setSemicolon(false);
 textSplitting.setComma(false);
 textSplitting.setOther(false);
 textSplitting.setOtherDelimiters(' ');
 textSplitting.setDimilitersAsOne(false);
 textSplitting.setTextQualifier(TextSplittingConstants.QUALIFIER_DOUBLE_QUOTES);
 textSplitting.setDecimalSeparator(TextSplittingConstants.SEPARATOR_POINT);
 textSplitting.setThousandsSeparator(TextSplittingConstants.SEPARATOR_COMMA);
 textSplitting.setDataFormat(new int[]{0,0,0});
 textSplitting.setCell(7,3);
 range.textSplitting(textSplitting);
 System.out.println(textSplitting.isSpace());</DL>
</DD>
</DL>
<HR>

<A NAME="isTab()"><!-- --></A><H3>
isTab</H3>
<PRE>
public boolean <B>isTab</B>()</PRE>
<DL>
<DD>判断有无制表符。
<P>
<DD><DL>

<DT><B>返回：</B><DD>布尔型值，如果有制表符分隔，则返回true；否则，返回false
 <p>
 <b>例子：</b>
 <pre>
 //此例在控制台输出有无制表符，true为有，false为无。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 sheet.setCellValue(3,7,"a b c");
 sheet.setCellValue(4,7,"x y z");
 Range range = sheet.getRange("G3:G4");
 TextSplittingProperties textSplitting = new TextSplittingProperties();
 textSplitting.setSplittingType(TextSplittingConstants.DELIMITED);
 textSplitting.setTab(true);
 textSplitting.setSpace(true);
 textSplitting.setSemicolon(false);
 textSplitting.setComma(false);
 textSplitting.setOther(false);
 textSplitting.setOtherDelimiters(' ');
 textSplitting.setDimilitersAsOne(false);
 textSplitting.setTextQualifier(TextSplittingConstants.QUALIFIER_DOUBLE_QUOTES);
 textSplitting.setDecimalSeparator(TextSplittingConstants.SEPARATOR_POINT);
 textSplitting.setThousandsSeparator(TextSplittingConstants.SEPARATOR_COMMA);
 textSplitting.setDataFormat(new int[]{0,0,0});
 textSplitting.setCell(7,3);
 range.textSplitting(textSplitting);
 System.out.println(textSplitting.isTab());</DL>
</DD>
</DL>
<HR>

<A NAME="setCell(int, int)"><!-- --></A><H3>
setCell</H3>
<PRE>
public void <B>setCell</B>(int&nbsp;row,
                    int&nbsp;column)</PRE>
<DL>
<DD>如不从文件中取数据则设置单元格。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>row</CODE> - 行号<DD><CODE>column</CODE> - 列号
 <p>
 <b>例子：</b>
 <pre>
 //此例设置文本分列属性的单元格为(7,3)。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 String[] aa = {"a b c","x y z"};
 sheet.setCellValue(3,7,aa,false);
 Range range = sheet.getRange("G3:G4");
 TextSplittingProperties textSplitting = new TextSplittingProperties();
 textSplitting.setSplittingType(TextSplittingConstants.DELIMITED);
 textSplitting.setTab(true);
 textSplitting.setSpace(true);
 textSplitting.setSemicolon(false);
 textSplitting.setComma(false);
 textSplitting.setOther(false);
 textSplitting.setOtherDelimiters(' ');
 textSplitting.setDimilitersAsOne(false);
 textSplitting.setTextQualifier(TextSplittingConstants.QUALIFIER_DOUBLE_QUOTES);
 textSplitting.setDecimalSeparator(TextSplittingConstants.SEPARATOR_POINT);
 textSplitting.setThousandsSeparator(TextSplittingConstants.SEPARATOR_COMMA);
 textSplitting.setDataFormat(new int[]{0,0,0});
 textSplitting.setCell(7,3);
 range.textSplitting(textSplitting);
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当给定的单元格地址错误或越界</DL>
</DD>
</DL>
<HR>

<A NAME="setComma(boolean)"><!-- --></A><H3>
setComma</H3>
<PRE>
public void <B>setComma</B>(boolean&nbsp;comma)</PRE>
<DL>
<DD>设置逗号为分隔符号。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>comma</CODE> - 布尔型，如果为true，则用逗号分隔；否则，取消设置 
 <p>
 <b>例子：</b>
 <pre>
 //此例设置逗号不是分隔符号。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 sheet.setCellValue(3,7,"a b c");
 sheet.setCellValue(4,7,"x y z");
 Range range = sheet.getRange("G3:G4");
 TextSplittingProperties textSplitting = new TextSplittingProperties();
 textSplitting.setSplittingType(TextSplittingConstants.DELIMITED);
 textSplitting.setTab(true);
 textSplitting.setSpace(true);
 textSplitting.setSemicolon(false);
 textSplitting.setComma(false);
 textSplitting.setOther(false);
 textSplitting.setOtherDelimiters(' ');
 textSplitting.setDimilitersAsOne(false);
 textSplitting.setTextQualifier(TextSplittingConstants.QUALIFIER_DOUBLE_QUOTES);
 textSplitting.setDecimalSeparator(TextSplittingConstants.SEPARATOR_POINT);
 textSplitting.setThousandsSeparator(TextSplittingConstants.SEPARATOR_COMMA);
 textSplitting.setDataFormat(new int[]{0,0,0});
 textSplitting.setCell(7,3);
 range.textSplitting(textSplitting);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="setDataFormat(int[])"><!-- --></A><H3>
setDataFormat</H3>
<PRE>
public void <B>setDataFormat</B>(int[]&nbsp;dataFormat)</PRE>
<DL>
<DD>设置数据格式。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>dataFormat</CODE> - 表示数据格式的整型数组，其常量和相应的值如下：
 <pre>
 TextSplittingConstants.GENERAL_TYPE = 0（数据格式为常规）；
 TextSplittingConstants.TEXT_TYPE = 1（数据格式为文本）；
 TextSplittingConstants.SKIP_TYPE = 3 (跳过数据格式(不导入))
 TextSplittingConstants.MDY_TYPE = 20（日期格式为“月日年”）；
 TextSplittingConstants.DMY_TYPE = 21（日期格式为“日月年”）；
 TextSplittingConstants.YMD_TYPE = 22（日期格式为“年月日”）；
 TextSplittingConstants.MYD_TYPE = 23（日期格式为“月日年”）；
 TextSplittingConstants.DYM_TYPE = 24（日期格式为“日年月”）；
 TextSplittingConstants.YDM_TYPE = 25（日期格式为“年日月”）；
 </pre>
 <p>
 <b>例子：</b>
 <pre>
 //此例设置数据格式为常规
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 sheet.setCellValue(3,7,"a b c");
 sheet.setCellValue(4,7,"x y z");
 Range range = sheet.getRange("G3:G4");
 TextSplittingProperties textSplitting = new TextSplittingProperties();
 textSplitting.setSplittingType(TextSplittingConstants.DELIMITED);
 textSplitting.setTab(true);
 textSplitting.setSpace(true);
 textSplitting.setSemicolon(false);
 textSplitting.setComma(false);
 textSplitting.setOther(false);
 textSplitting.setOtherDelimiters(' ');
 textSplitting.setDimilitersAsOne(false);
 textSplitting.setTextQualifier(TextSplittingConstants.QUALIFIER_DOUBLE_QUOTES);
 textSplitting.setDecimalSeparator(TextSplittingConstants.SEPARATOR_POINT);
 textSplitting.setThousandsSeparator(TextSplittingConstants.SEPARATOR_COMMA);
 textSplitting.setDataFormat(new int[]{0,0,0});
 textSplitting.setCell(7,3);
 range.textSplitting(textSplitting);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="setDecimalSeparator(int)"><!-- --></A><H3>
setDecimalSeparator</H3>
<PRE>
public void <B>setDecimalSeparator</B>(int&nbsp;decimalSeparator)</PRE>
<DL>
<DD>设置小数位分隔符。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>decimalSeparator</CODE> - 小数位分隔符，其常量和相应的值如下：
 <pre>
 TextSplittingConstants.SEPARATOR_COMMA = 0（逗号为分隔符）；
 TextSplittingConstants.SEPARATOR_POINT = 1（点为分隔符）
 </pre>
 <p>
 <b>例子：</b>
 <pre>
 //此例设置点为小数位分隔符。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 sheet.setCellValue(3,7,"a b c");