PasteOption

Class PasteOption

java.lang.Object

com.grapecity.documents.excel.PasteOption

---

public class PasteOption extends Object

表示控制复制区域粘贴方式的选项。

将此类与 IRange.copy(IRange,PasteOption) 配合使用，可以指定粘贴操作是否包括隐藏单元格，以及要粘贴哪些 PasteType 值。新实例默认允许粘贴隐藏区域，其默认粘贴类型包括公式和格式。

 worksheet.getRange("A1:B3").setValue(new Object[][] {
     {"Name", "Value"},
     {"Alice", 100},
     {"Bob", 200}
 });
 worksheet.getRange("2:2").setHidden(true);
 
 PasteOption option = new PasteOption();
 option.setAllowPasteHiddenRange(false);
 worksheet.getRange("A1:B3").copy(worksheet.getRange("D10"), option);
 

• Constructor Summary

  Constructors

  Constructor

  Description

  PasteOption()

   

• Method Summary

  All MethodsInstance MethodsConcrete Methods

  Modifier and Type

  Method

  Description

  boolean

  getAllowPasteHiddenRange()

  获取复制区域中的隐藏单元格是否包含在粘贴操作中。

  EnumSet<PasteType>

  getPasteType()

  获取在区域复制操作中应用的粘贴类型。

  void

  setAllowPasteHiddenRange(boolean allowPasteHiddenRange)

  设置复制区域中的隐藏单元格是否包含在粘贴操作中。

  void

  setPasteType(EnumSet<PasteType> pasteType)

  设置在区域复制操作中应用的粘贴类型。

  Methods inherited from class java.lang.Object

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

• Constructor Details

  • PasteOption

    public PasteOption()

• Method Details

  • getAllowPasteHiddenRange

    public boolean getAllowPasteHiddenRange()

    获取复制区域中的隐藏单元格是否包含在粘贴操作中。

    将此属性与 IRange.copy(IRange,PasteOption) 配合使用，可以确定是否粘贴隐藏行或隐藏列中的内容。新的 PasteOption 实例默认允许粘贴隐藏区域。

    
     worksheet.getRange("A1:B3").setValue(new Object[][] {
         {"Name", "Value"},
         {"Alice", 100},
         {"Bob", 200}
     });
     worksheet.getRange("2:2").setHidden(true);
     
     PasteOption option = new PasteOption();
     option.setAllowPasteHiddenRange(false);
     boolean allowPasteHiddenRange = option.getAllowPasteHiddenRange();
     worksheet.getRange("A1:B3").copy(worksheet.getRange("D10"), option);
     

    Returns:

    如果复制区域中的隐藏单元格包含在粘贴操作中，则返回 true；否则返回 false。

  • setAllowPasteHiddenRange

    public void setAllowPasteHiddenRange(boolean allowPasteHiddenRange)

    设置复制区域中的隐藏单元格是否包含在粘贴操作中。

    将此属性与 IRange.copy(IRange,PasteOption) 配合使用，可以确定是否粘贴隐藏行或隐藏列中的内容。新的 PasteOption 实例默认允许粘贴隐藏区域。

    
     worksheet.getRange("A1:B3").setValue(new Object[][] {
         {"Name", "Value"},
         {"Alice", 100},
         {"Bob", 200}
     });
     worksheet.getRange("2:2").setHidden(true);
     
     PasteOption option = new PasteOption();
     option.setAllowPasteHiddenRange(false);
     worksheet.getRange("A1:B3").copy(worksheet.getRange("D10"), option);
     

    Parameters:

    allowPasteHiddenRange - 如果复制区域中的隐藏单元格包含在粘贴操作中，则为 true；否则为 false。

  • getPasteType

    public EnumSet<PasteType> getPasteType()

    获取在区域复制操作中应用的粘贴类型。

    将此方法与 IRange.copy(IRange,PasteOption) 配合使用，可以检查或重用当前粘贴配置。新的 PasteOption 实例默认返回包含 PasteType.Formulas 和 PasteType.Formats 的集合。

    
     worksheet.getRange("A1").setFormula("=1+1");
     worksheet.getRange("A1").getInterior().setColor(Color.GetYellow());
     
     PasteOption option = new PasteOption();
     option.setPasteType(EnumSet.of(PasteType.Values));
     worksheet.getRange("A1").copy(worksheet.getRange("B1"), option);
     EnumSet<PasteType> pasteTypes = option.getPasteType();
     

    Returns:

    控制源区域中哪些部分被粘贴的当前 PasteType 值集合。

  • setPasteType

    public void setPasteType(EnumSet<PasteType> pasteType)

    设置在区域复制操作中应用的粘贴类型。

    将此方法与 IRange.copy(IRange,PasteOption) 配合使用，可以指定粘贴源区域的哪些部分。新的 PasteOption 实例默认包括 PasteType.Formulas 和 PasteType.Formats。

    
     worksheet.getRange("A1").setFormula("=1+1");
     worksheet.getRange("A1").getInterior().setColor(Color.GetYellow());
     
     PasteOption option = new PasteOption();
     option.setPasteType(EnumSet.of(PasteType.Values));
     worksheet.getRange("A1").copy(worksheet.getRange("B1"), option);
     

    Parameters:

    pasteType - 控制源区域中哪些部分被粘贴的 PasteType 值集合。