FontColorSortField

Class FontColorSortField

java.lang.Object

com.grapecity.documents.excel.SortFieldBase

com.grapecity.documents.excel.FontColorSortField

All Implemented Interfaces:

IFontColorSortField, ISortField

---

public class FontColorSortField extends SortFieldBase implements IFontColorSortField

表示按字体颜色对数据排序的排序字段。

使用此类可定义一个排序条件，用于比较键区域中的字体颜色，而不是单元格值。将创建的排序字段添加到工作表排序中，可根据 SortOrder 将具有指定字体颜色的行或列移动到顶部或底部。

 worksheet.getRange("A1:B4").setValue(new Object[][] {
     {"Name", "Score"},
     {"Amy", 2},
     {"Ben", 1},
     {"Cara", 3}
 });
 worksheet.getRange("B3").getFont().setColor(Color.GetRed());
 FontColorSortField sortField = new FontColorSortField(worksheet.getRange("B2:B4"), Color.GetRed(), SortOrder.Ascending);
 worksheet.getSort().getSortFields().add(sortField);
 worksheet.getSort().setRange(worksheet.getRange("A2:B4"));
 worksheet.getSort().setOrientation(SortOrientation.Columns);
 worksheet.getSort().apply();
 

• Constructor Summary

  Constructors

  Constructor

  Description

  FontColorSortField(IRange key, Color color)

  按字体颜色排序。

  FontColorSortField(IRange key, Color color, SortOrder order)

  创建按字体颜色排序的排序字段。

• Method Summary

  All MethodsInstance MethodsConcrete Methods

  Modifier and Type

  Method

  Description

  final Color

  getColor()

  获取用于排序依据的 Color。

  final SortOrder

  getOrder()

  获取排序顺序。

  Methods inherited from class com.grapecity.documents.excel.SortFieldBase

  getKey, getPriority, getSortOn, setPriority

  Methods inherited from class java.lang.Object

  clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  Methods inherited from interface com.grapecity.documents.excel.ISortField

  getKey, getPriority, getSortOn, setPriority

• Constructor Details

  • FontColorSortField

    public FontColorSortField(IRange key, Color color)

    按字体颜色排序。

    此构造函数创建一个按指定字体颜色匹配单元格的排序字段，并将 SortOrder.Ascending 转发给FontColorSortField(IRange,Color,SortOrder)。

    
     worksheet.getRange("A1:B4").setValue(new Object[][] {
         {"Name", "Score"},
         {"A", 2},
         {"B", 1},
         {"C", 3}
     });
     worksheet.getRange("B2").getFont().setColor(Color.GetRed());
     FontColorSortField sortField = new FontColorSortField(worksheet.getRange("B2:B4"), Color.GetRed());
     worksheet.getSort().getSortFields().add(sortField);
     

    Parameters:

    key - 在排序区域中标识排序键的区域。

    color - 要排序依据的字体颜色。

  • FontColorSortField

    public FontColorSortField(IRange key, Color color, SortOrder order)

    创建按字体颜色排序的排序字段。

    使用此构造函数可定义排序键区域、排序所依据的字体颜色，以及确定匹配值在排序结果中排在最前还是最后的 SortOrder。

    
     worksheet.getRange("A1:B4").setValue(new Object[][] {
         {"Name", "Score"},
         {"Alice", 2},
         {"Bob", 1},
         {"Carol", 3}
     });
     worksheet.getRange("B2").getFont().setColor(Color.GetRed());
     FontColorSortField field = new FontColorSortField(worksheet.getRange("B2:B4"), Color.GetRed(), SortOrder.Ascending);
     worksheet.getSort().getSortFields().add(field);
     

    Parameters:

    key - 为字体颜色排序字段定义排序键的区域。

    color - 要排序依据的字体颜色。

    order - 要应用的排序顺序。

• Method Details

  • getOrder

    public final SortOrder getOrder()

    获取排序顺序。

    返回 SortOrder，该值确定具有指定字体颜色的条目在排序操作期间的放置方式。

    
     worksheet.getRange("A1:B4").setValue(new Object[][] {{"Name", "Score"}, {"A", 2}, {"B", 1}, {"C", 3}});
     worksheet.getRange("B3:B4").getFont().setColor(Color.GetBlue());
     FontColorSortField sortField = new FontColorSortField(worksheet.getRange("B2:B4"), Color.GetBlue(), SortOrder.Ascending);
     SortOrder order = sortField.getOrder();
     

    Specified by:

    getOrder in interface IFontColorSortField

    Returns:

    字体颜色排序字段的排序顺序。

  • getColor

    public final Color getColor()

    获取用于排序依据的 Color。

    这是存储在排序字段中的字体颜色条件，用于在按字体颜色排序时匹配单元格。

    
     worksheet.getRange("A1:B4").setValue(new Object[][] {{"Name", "Score"}, {"A", 2}, {"B", 1}, {"C", 3}});
     worksheet.getRange("B3:B4").getFont().setColor(Color.GetBlue());
     FontColorSortField sortField = new FontColorSortField(worksheet.getRange("B2:B4"), Color.GetBlue(), SortOrder.Ascending);
     Color color = sortField.getColor();
     

    Specified by:

    getColor in interface IFontColorSortField

    Returns:

    此排序字段在按字体颜色排序期间用于匹配字体颜色的 Color。