textsplittingproperties.html

永中OFFICE二次开发帮助文档

 textSplitting.setTextQualifier(TextSplittingConstants.QUALIFIER_DOUBLE_QUOTES);
 textSplitting.setDecimalSeparator(TextSplittingConstants.SEPARATOR_POINT);
 textSplitting.setThousandsSeparator(TextSplittingConstants.SEPARATOR_COMMA);
 textSplitting.setDataFormat(new int[]{0,0,0,0,0,0,0});
 textSplitting.setCell(4,2);
 range.textSplitting(textSplitting);
 System.out.println(textSplitting.getFileName());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getOriginalDataType()"><!-- --></A><H3>
getOriginalDataType</H3>
<PRE>
public int <B>getOriginalDataType</B>()</PRE>
<DL>
<DD>取得分列方式的常量值。
<P>
<DD><DL>

<DT><B>返回：</B><DD>分列方式，其常量和相应的值如下：
 <pre>
 TextSplittingConstants.DELIMITED = 0（分隔符号）；
 TextSplittingConstants.FIXED_WIDTH = 1（固定宽度）
 </pre>
 <p>
 <b>例子：</b>
 <pre>
 //此例在控制台输出分列方式的常量值。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 Range range = sheet.getRange("D2");
 TextSplittingProperties textSplitting = new TextSplittingProperties();
 textSplitting.setFileName("d:\\temp\\newmail.txt");
 textSplitting.setStartRow(1);
 textSplitting.setSplittingType(TextSplittingConstants.DELIMITED);
 textSplitting.setTab(true);
 textSplitting.setSpace(true);
 textSplitting.setSemicolon(true);
 textSplitting.setComma(true);
 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,0,0,0,0});
 textSplitting.setCell(4,2);
 range.textSplitting(textSplitting);
 System.out.println(textSplitting.getOriginalDataType());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getOtherDelimiters()"><!-- --></A><H3>
getOtherDelimiters</H3>
<PRE>
public char <B>getOtherDelimiters</B>()</PRE>
<DL>
<DD>取得其它分隔符。
<P>
<DD><DL>

<DT><B>返回：</B><DD>所使用的其他分隔符，为char型
 <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);
 System.out.println(textSplitting.getOtherDelimiters());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getRow()"><!-- --></A><H3>
getRow</H3>
<PRE>
public int <B>getRow</B>()</PRE>
<DL>
<DD>得到单元格行号。
<P>
<DD><DL>

<DT><B>返回：</B><DD>行号
 <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);
 System.out.println(textSplitting.getRow());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getStartRow()"><!-- --></A><H3>
getStartRow</H3>
<PRE>
public int <B>getStartRow</B>()</PRE>
<DL>
<DD>取得导入起始行。
<P>
<DD><DL>

<DT><B>返回：</B><DD>起始行号
 <p>
 <b>例子：</b>
 <pre>
 //此例在控制台输出导入起始行的行号。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 Range range = sheet.getRange("D2");
 TextSplittingProperties textSplitting = new TextSplittingProperties();
 textSplitting.setFileName("d:\\temp\\newmail.txt");
 textSplitting.setStartRow(1);
 textSplitting.setSplittingType(TextSplittingConstants.DELIMITED);
 textSplitting.setTab(true);
 textSplitting.setSpace(true);
 textSplitting.setSemicolon(true);
 textSplitting.setComma(true);
 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,0,0,0,0});
 textSplitting.setCell(4,2);
 range.textSplitting(textSplitting);
 System.out.println(textSplitting.getStartRow());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getTextQualifier()"><!-- --></A><H3>
getTextQualifier</H3>
<PRE>
public int <B>getTextQualifier</B>()</PRE>
<DL>
<DD>得到文本识别符号。
<P>
<DD><DL>

<DT><B>返回：</B><DD>文本识别符号，其常量和相应的值如下：
 <pre>
 TextSplittingConstants.QUALIFIER_DOUBLE_QUOTES = 0（双引号为文本识别符号）；
 TextSplittingConstants.QUALIFIER_SINGLE_QUOTES = 1（单引号为文本识别符号）；
 TextSplittingConstants.QUALIFIER_NONE = 3（没有为文本识别符号）
 </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);
 System.out.println(textSplitting.getTextQualifier());
 </pre><DT><B>另请参见：</B><DD><A HREF="../../../../../application/constants/TextSplittingConstants.html" title="application.constants 中的接口"><CODE>TextSplittingConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getThousandsSeparator()"><!-- --></A><H3>
getThousandsSeparator</H3>
<PRE>
public int <B>getThousandsSeparator</B>()</PRE>
<DL>
<DD>得到千分位分隔符。
<P>
<DD><DL>

<DT><B>返回：</B><DD>千分位分隔符，其常量和相应的值如下：
 <pre>
 TextSplittingConstants.SEPARATOR_COMMA = 0（逗号为分隔符）；
 TextSplittingConstants.SEPARATOR_POINT = 1（点为分隔符）；
 TextSplittingConstants.SEPARATOR_SPACE = 3（空格为分隔符）；
 TextSplittingConstants.SEPARATOR_SINGLE_QUOTES = 4（单引号为分隔符）
 </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);
 System.out.println(textSplitting.getThousandsSeparator());
 </pre><DT><B>另请参见：</B><DD><A HREF="../../../../../application/constants/TextSplittingConstants.html" title="application.constants 中的接口"><CODE>TextSplittingConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="isComma()"><!-- --></A><H3>
isComma</H3>
<PRE>
public boolean <B>isComma</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.isComma());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="isDelimitersAsOne()"><!-- --></A><H3>
isDelimitersAsOne</H3>
<PRE>
public boolean <B>isDelimitersAsOne</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");