sortproperties.html

永中OFFICE二次开发帮助文档

<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.worksheets.SortProperties</CODE> 中的 <CODE>getMatchCase</CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>布尔型值，如为true，则排序时区分大小写；否则，不区分大小写
 <p>  
 <b>例子：</b>
 <pre>  
 //此例此例在控制台上输出排序时是否区分大小写。如果为true，则排序时区分大小写；如果为false，则排序时不区分大小写。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 Range range = sheet.getRange("B4:E16");
 range.fillRandom();
 String[] heading = {"aa", "bb", "cc", "dd"};
 sheet.setCellValue(3, 2, heading, true);
 range = sheet.getRange("B3:E16");    
 SortProperties sortProperties = new SortProperties();
 sortProperties.setSortKey1(1);
 sortProperties.setOrder1(true);
 sortProperties.setMatchCase(true);
 sortProperties.setRowHeader(true);
 range.sort(sortProperties); 
 System.out.println(sortProperties.getMatchCase());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getOrder1()"><!-- --></A><H3>
getOrder1</H3>
<PRE>
public boolean <B>getOrder1</B>()</PRE>
<DL>
<DD>获取主关键字排序方式。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.worksheets.SortProperties</CODE> 中的 <CODE>getOrder1</CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>主关键字排序方式，如果主关键字排序方式为“升序”，返回true；否则，返回false
 <p>
 <b>例子：</b>
 <pre>
 //此例在控制台上输出主关键字的排序方式。如果为true，则排序方式为升序；如为false,排序方式为降序。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 Range range = sheet.getRange("B4:E16");
 range.fillRandom();
 String[] heading = {"aa", "bb", "cc", "dd"};
 sheet.setCellValue(3, 2, heading, true);
 range = sheet.getRange("B3:E16");    
 SortProperties sortProperties = new SortProperties();
 sortProperties.setSortKey1(1);
 sortProperties.setOrder1(true);
 sortProperties.setRowHeader(true);
 range.sort(sortProperties);
 System.out.println(sortProperties.getOrder1());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getOrder2()"><!-- --></A><H3>
getOrder2</H3>
<PRE>
public boolean <B>getOrder2</B>()</PRE>
<DL>
<DD>获取次要关键字排序方式。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.worksheets.SortProperties</CODE> 中的 <CODE>getOrder2</CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>次要关键字排序方式，如果次要关键字排序方式为“升序”，返回true；否则，返回false
 <p>
 <b>例子：</b>
 <pre> 
 //此例在控制台上输出次关键字的排序方式。如果为true，排序方式为升序；如果为false，排序方式为降序。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 Range range = sheet.getRange("B4:E16");
 range.fillRandom();
 String[] heading = {"aa", "bb", "cc", "dd"};
 sheet.setCellValue(3, 2, heading, true);
 range = sheet.getRange("B3:E16");    
 SortProperties sortProperties = new SortProperties();
 sortProperties.setSortKey1(1);
 sortProperties.setOrder1(true);
 sortProperties.setSortKey2(3);
 sortProperties.setOrder2(true);
 sortProperties.setRowHeader(true);
 range.sort(sortProperties);
 System.out.println(sortProperties.getOrder2());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getOrder3()"><!-- --></A><H3>
getOrder3</H3>
<PRE>
public boolean <B>getOrder3</B>()</PRE>
<DL>
<DD>获取第三关键字排序方式。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.worksheets.SortProperties</CODE> 中的 <CODE>getOrder3</CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>第三关键字排序方式，如果第三关键字排序方式为"升序"，返回true；否则，返回false
 <p>
 <b>例子：</b>
 <pre>
 //此例在控制台上输出第三关键字的排序方式。如果为true，排序方式为升序；如果为false，排序方式为降序。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 Range range = sheet.getRange("B4:E16");
 range.fillRandom();
 String[] heading = {"aa", "bb", "cc", "dd"};
 sheet.setCellValue(3, 2, heading, true);
 range = sheet.getRange("B3:E16");    
 SortProperties sortProperties = new SortProperties();
 sortProperties.setSortKey1(1);
 sortProperties.setOrder1(true);
 sortProperties.setSortKey2(3);
 sortProperties.setOrder2(true);
 sortProperties.setSortKey3(2);
 sortProperties.setOrder3(false);
 sortProperties.setRowHeader(true);
 range.sort(sortProperties);
 System.out.println(sortProperties.getOrder3());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getOrientation()"><!-- --></A><H3>
getOrientation</H3>
<PRE>
public boolean <B>getOrientation</B>()</PRE>
<DL>
<DD>获取排序方向。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.worksheets.SortProperties</CODE> 中的 <CODE>getOrientation</CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>布尔型值，如果按行排序，则返回true；否则，返回false
 <p>
 <b>例子：</b>
 <pre>
 //此例在控制台上输出排序方向。输出结果如果为true，则按行排序；如果为false，则按列排序。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 Range range = sheet.getRange("B4:E16");
 range.fillRandom();
 String[] heading = {"aa", "bb", "cc", "dd"};
 sheet.setCellValue(3, 2, heading, true);
 range = sheet.getRange("B3:E16");    
 SortProperties sortProperties = new SortProperties();
 sortProperties.setSortKey1(1);
 sortProperties.setOrder1(true);
 sortProperties.setOrientation(false);
 sortProperties.setRowHeader(true);
 range.sort(sortProperties); 
 System.out.println(sortProperties.getOrientation());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getSortKey1()"><!-- --></A><H3>
getSortKey1</H3>
<PRE>
public int <B>getSortKey1</B>()</PRE>
<DL>
<DD>获取排序主关键字索引。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.worksheets.SortProperties</CODE> 中的 <CODE>getSortKey1</CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>排序主关键字索引
 <p>
 <b>例子：</b>
 <pre>
 //此例在控制台上输出排序主关键字的索引值。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 Range range = sheet.getRange("B4:E16");
 range.fillRandom();
 String[] heading = {"aa", "bb", "cc", "dd"};
 sheet.setCellValue(3, 2, heading, true);
 range = sheet.getRange("B3:E16");    
 SortProperties sortProperties = new SortProperties();
 sortProperties.setSortKey1(1);
 sortProperties.setOrder1(true);
 sortProperties.setRowHeader(true);
 range.sort(sortProperties);
 System.out.println(sortProperties.getSortKey1());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getSortKey2()"><!-- --></A><H3>
getSortKey2</H3>
<PRE>
public int <B>getSortKey2</B>()</PRE>
<DL>
<DD>获取次要关键字索引值。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.worksheets.SortProperties</CODE> 中的 <CODE>getSortKey2</CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>次要关键字索引值
 <p>
 <b>例子：</b>
 <pre> 
 //此例在控制台上输出排序次要关键字的索引值。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 Range range = sheet.getRange("B4:E16");
 range.fillRandom();
 String[] heading = {"aa", "bb", "cc", "dd"};
 sheet.setCellValue(3, 2, heading, true);
 range = sheet.getRange("B3:E16");    
 SortProperties sortProperties = new SortProperties();
 sortProperties.setSortKey1(1);
 sortProperties.setOrder1(true);
 sortProperties.setSortKey2(3);
 sortProperties.setOrder2(true);
 sortProperties.setRowHeader(true);
 range.sort(sortProperties);
 System.out.println(sortProperties.getSortKey2());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getSortKey3()"><!-- --></A><H3>
getSortKey3</H3>
<PRE>
public int <B>getSortKey3</B>()</PRE>
<DL>
<DD>获取排序第三关键字索引值。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.worksheets.SortProperties</CODE> 中的 <CODE>getSortKey3</CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>第三关键字索引值
 <p>
 <b>例子：</b>
 <pre>
 //此例在控制台上输出排序第三关键字的索引值。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 Range range = sheet.getRange("B4:E16");
 range.fillRandom();
 String[] heading = {"aa", "bb", "cc", "dd"};
 sheet.setCellValue(3, 2, heading,t rue);
 range = sheet.getRange("B3:E16");    
 SortProperties sortProperties = new SortProperties();
 sortProperties.setSortKey1(1);
 sortProperties.setOrder1(true);
 sortProperties.setSortKey2(3);
 sortProperties.setOrder2(true);
 sortProperties.setSortKey3(2);
 sortProperties.setOrder3(false);
 sortProperties.setRowHeader(true);
 range.sort(sortProperties);
 System.out.println(sortProperties.getSortKey3());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="isBiHua()"><!-- --></A><H3>
isBiHua</H3>
<PRE>
public boolean <B>isBiHua</B>()</PRE>
<DL>
<DD>获取是否按笔划排序。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.worksheets.SortProperties</CODE> 中的 <CODE>isBiHua</CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>布尔型值，如为true，则按笔划排序；否则，不按笔划排序
 <p>
 <b>例子：</b>
 <pre>  
 //此例在控制台输出是否按笔划排序。输出结果如果为true，则按笔划排序；如果为false，则不按笔划排序。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 Range range = sheet.getRange("B4:E16");
 range.fillRandom();
 String[] heading = {"aa", "bb", "cc", "dd"};
 sheet.setCellValue(3, 2, heading, true);
 range = sheet.getRange("B3:E16");    
 SortProperties sortProperties = new SortProperties();
 sortProperties.setSortKey1(1);
 sortProperties.setOrder1(true);
 sortProperties.setBiHua(false);
 sortProperties.setRowHeader(true);
 range.sort(sortProperties); 
 System.out.println(sortProperties.isBiHua());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="setBiHua(boolean)"><!-- --></A><H3>
setBiHua</H3>
<PRE>
public void <B>setBiHua</B>(boolean&nbsp;biHua)</PRE>
<DL>
<DD>设置是否按笔划排序。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.worksheets.SortProperties</CODE> 中的 <CODE>setBiHua</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>biHua</CODE> - 布尔型值，如为true，则按笔划排序；否则，不按笔划排序
 <p>
 <b>例子：</b>
 <pre>
 //此例设置不按笔划排序。    
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 Range range = sheet.getRange("B4:E16");
 range.fillRandom();
 String[] heading = {"aa", "bb", "cc", "dd"};
 sheet.setCellValue(3, 2, heading, true);
 range = sheet.getRange("B3:E16");    
 SortProperties sortProperties = new SortProperties();
 sortProperties.setSortKey1(1);
 sortProperties.setOrder1(true);
 sortProperties.setBiHua(false);
 sortProperties.setRowHeader(true);
 range.sort(sortProperties); 
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="setCustomListOrder(int)"><!-- --></A><H3>
setCustomListOrder</H3>
<PRE>
public void <B>setCustomListOrder</B>(int&nbsp;custom)</PRE>
<DL>
<DD>该方法设置自定义排序方式。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.worksheets.SortProperties</CODE> 中的 <CODE>setCustomListOrder</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>custom</CODE> - 自定义排序方式索引，为整型数值
 <pre>
       0 - 正常
       1 - Sun,Mon,Tue...
       2 - Sunday,Monday,Tuesday...
       3 - Jan,Feb,Mar...
       4 - January,Febuary,March...
       5 - 日，一，二...
       6 - 星期日，星期一，星期二...
       7 - 一月，二月，三月...
       8 - 第一季，第二季，第三季...
       9 - 正月，二月，三月...
       10 - 子，丑，寅，卯...
       11 - 甲，乙，丙，丁...
 </pre>
 <p>
 <b>例子：</b>
 <pre>   
 //此例设置排序方式为正常，并且设置包含标题行。
 Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                  .getWorksheets().getActiveWorksheet();
 Range range = sheet.getRange("B4:E16");
 range.fillRandom();
 String[] heading = {"aa","bb","cc","dd"};
 sheet.setCellValue(3,2,heading,true);
 range = sheet.getRange("B3:E16");    
 SortProperties sortProperties = new SortProperties();
 sortProperties.setSortKey1(1);