com.aspose.words

Property Getters/Setters Detail

• getCount

  public int getCount()
  

  Gets the total number of the items in the collection.

  Example:

  Shows how to formatting fields

  Document doc = new Document();
  DocumentBuilder builder = new DocumentBuilder(doc);
  
  // Use a document builder to insert field with no format
  Field field = builder.insertField("= 2 + 3");
  
  // We can format our field here instead of in the field code
  FieldFormat format = field.getFormat();
  format.setNumericFormat("$###.00");
  field.update();
  
  // Apply a date/time format
  field = builder.insertField("DATE");
  format = field.getFormat();
  format.setDateTimeFormat("dddd, MMMM dd, yyyy");
  field.update();
  
  // Apply 2 general formats at the same time
  field = builder.insertField("= 25 + 33");
  format = field.getFormat();
  format.getGeneralFormats().add(GeneralFormat.LOWERCASE_ROMAN);
  format.getGeneralFormats().add(GeneralFormat.UPPER);
  field.update();
  
  int index = 0;
  Iterator<Integer> generalFormatEnumerator = format.getGeneralFormats().iterator();
  while (generalFormatEnumerator.hasNext()) {
      System.out.println(MessageFormat.format("General format index {0}: {1}", index++, generalFormatEnumerator.toString()));
  }
  
  Assert.assertEquals("LVIII", field.getResult());
  Assert.assertEquals(2, format.getGeneralFormats().getCount());
  Assert.assertEquals(format.getGeneralFormats().get(0), GeneralFormat.LOWERCASE_ROMAN);
  
  // Removing field formats
  format.getGeneralFormats().remove(GeneralFormat.LOWERCASE_ROMAN);
  format.getGeneralFormats().removeAt(0);
  Assert.assertEquals(format.getGeneralFormats().getCount(), 0);
  field.update();
  
  // Our field has no general formats left and is back to default form
  Assert.assertEquals(field.getResult(), "58");

• get

  public int get(int index)
  

  Gets a general format at the specified index. The value of the property is GeneralFormat integer constant.

  Parameters:

  index - The index of a general format.

  Returns:

  A general format.

  Example:

  Shows how to formatting fields

  Document doc = new Document();
  DocumentBuilder builder = new DocumentBuilder(doc);
  
  // Use a document builder to insert field with no format
  Field field = builder.insertField("= 2 + 3");
  
  // We can format our field here instead of in the field code
  FieldFormat format = field.getFormat();
  format.setNumericFormat("$###.00");
  field.update();
  
  // Apply a date/time format
  field = builder.insertField("DATE");
  format = field.getFormat();
  format.setDateTimeFormat("dddd, MMMM dd, yyyy");
  field.update();
  
  // Apply 2 general formats at the same time
  field = builder.insertField("= 25 + 33");
  format = field.getFormat();
  format.getGeneralFormats().add(GeneralFormat.LOWERCASE_ROMAN);
  format.getGeneralFormats().add(GeneralFormat.UPPER);
  field.update();
  
  int index = 0;
  Iterator<Integer> generalFormatEnumerator = format.getGeneralFormats().iterator();
  while (generalFormatEnumerator.hasNext()) {
      System.out.println(MessageFormat.format("General format index {0}: {1}", index++, generalFormatEnumerator.toString()));
  }
  
  Assert.assertEquals("LVIII", field.getResult());
  Assert.assertEquals(2, format.getGeneralFormats().getCount());
  Assert.assertEquals(format.getGeneralFormats().get(0), GeneralFormat.LOWERCASE_ROMAN);
  
  // Removing field formats
  format.getGeneralFormats().remove(GeneralFormat.LOWERCASE_ROMAN);
  format.getGeneralFormats().removeAt(0);
  Assert.assertEquals(format.getGeneralFormats().getCount(), 0);
  field.update();
  
  // Our field has no general formats left and is back to default form
  Assert.assertEquals(field.getResult(), "58");

Method Detail

• add

  public void add(int item)
          throws java.lang.Exception

  Adds a general format to the collection.

  Parameters:

  item - A GeneralFormat value. A general format.

  Example:

  Shows how to formatting fields

  Document doc = new Document();
  DocumentBuilder builder = new DocumentBuilder(doc);
  
  // Use a document builder to insert field with no format
  Field field = builder.insertField("= 2 + 3");
  
  // We can format our field here instead of in the field code
  FieldFormat format = field.getFormat();
  format.setNumericFormat("$###.00");
  field.update();
  
  // Apply a date/time format
  field = builder.insertField("DATE");
  format = field.getFormat();
  format.setDateTimeFormat("dddd, MMMM dd, yyyy");
  field.update();
  
  // Apply 2 general formats at the same time
  field = builder.insertField("= 25 + 33");
  format = field.getFormat();
  format.getGeneralFormats().add(GeneralFormat.LOWERCASE_ROMAN);
  format.getGeneralFormats().add(GeneralFormat.UPPER);
  field.update();
  
  int index = 0;
  Iterator<Integer> generalFormatEnumerator = format.getGeneralFormats().iterator();
  while (generalFormatEnumerator.hasNext()) {
      System.out.println(MessageFormat.format("General format index {0}: {1}", index++, generalFormatEnumerator.toString()));
  }
  
  Assert.assertEquals("LVIII", field.getResult());
  Assert.assertEquals(2, format.getGeneralFormats().getCount());
  Assert.assertEquals(format.getGeneralFormats().get(0), GeneralFormat.LOWERCASE_ROMAN);
  
  // Removing field formats
  format.getGeneralFormats().remove(GeneralFormat.LOWERCASE_ROMAN);
  format.getGeneralFormats().removeAt(0);
  Assert.assertEquals(format.getGeneralFormats().getCount(), 0);
  field.update();
  
  // Our field has no general formats left and is back to default form
  Assert.assertEquals(field.getResult(), "58");

• iterator

  public java.util.Iterator<GeneralFormat> iterator()

  Returns an enumerator object.

  Example:

  Shows how to formatting fields

  Document doc = new Document();
  DocumentBuilder builder = new DocumentBuilder(doc);
  
  // Use a document builder to insert field with no format
  Field field = builder.insertField("= 2 + 3");
  
  // We can format our field here instead of in the field code
  FieldFormat format = field.getFormat();
  format.setNumericFormat("$###.00");
  field.update();
  
  // Apply a date/time format
  field = builder.insertField("DATE");
  format = field.getFormat();
  format.setDateTimeFormat("dddd, MMMM dd, yyyy");
  field.update();
  
  // Apply 2 general formats at the same time
  field = builder.insertField("= 25 + 33");
  format = field.getFormat();
  format.getGeneralFormats().add(GeneralFormat.LOWERCASE_ROMAN);
  format.getGeneralFormats().add(GeneralFormat.UPPER);
  field.update();
  
  int index = 0;
  Iterator<Integer> generalFormatEnumerator = format.getGeneralFormats().iterator();
  while (generalFormatEnumerator.hasNext()) {
      System.out.println(MessageFormat.format("General format index {0}: {1}", index++, generalFormatEnumerator.toString()));
  }
  
  Assert.assertEquals("LVIII", field.getResult());
  Assert.assertEquals(2, format.getGeneralFormats().getCount());
  Assert.assertEquals(format.getGeneralFormats().get(0), GeneralFormat.LOWERCASE_ROMAN);
  
  // Removing field formats
  format.getGeneralFormats().remove(GeneralFormat.LOWERCASE_ROMAN);
  format.getGeneralFormats().removeAt(0);
  Assert.assertEquals(format.getGeneralFormats().getCount(), 0);
  field.update();
  
  // Our field has no general formats left and is back to default form
  Assert.assertEquals(field.getResult(), "58");

• remove

  public void remove(int item)
             throws java.lang.Exception

  Removes all occurrences of the specified general format from the collection.

  Parameters:

  item - A GeneralFormat value. A general format.

  Example:

  Shows how to formatting fields

  Document doc = new Document();
  DocumentBuilder builder = new DocumentBuilder(doc);
  
  // Use a document builder to insert field with no format
  Field field = builder.insertField("= 2 + 3");
  
  // We can format our field here instead of in the field code
  FieldFormat format = field.getFormat();
  format.setNumericFormat("$###.00");
  field.update();
  
  // Apply a date/time format
  field = builder.insertField("DATE");
  format = field.getFormat();
  format.setDateTimeFormat("dddd, MMMM dd, yyyy");
  field.update();
  
  // Apply 2 general formats at the same time
  field = builder.insertField("= 25 + 33");
  format = field.getFormat();
  format.getGeneralFormats().add(GeneralFormat.LOWERCASE_ROMAN);
  format.getGeneralFormats().add(GeneralFormat.UPPER);
  field.update();
  
  int index = 0;
  Iterator<Integer> generalFormatEnumerator = format.getGeneralFormats().iterator();
  while (generalFormatEnumerator.hasNext()) {
      System.out.println(MessageFormat.format("General format index {0}: {1}", index++, generalFormatEnumerator.toString()));
  }
  
  Assert.assertEquals("LVIII", field.getResult());
  Assert.assertEquals(2, format.getGeneralFormats().getCount());
  Assert.assertEquals(format.getGeneralFormats().get(0), GeneralFormat.LOWERCASE_ROMAN);
  
  // Removing field formats
  format.getGeneralFormats().remove(GeneralFormat.LOWERCASE_ROMAN);
  format.getGeneralFormats().removeAt(0);
  Assert.assertEquals(format.getGeneralFormats().getCount(), 0);
  field.update();
  
  // Our field has no general formats left and is back to default form
  Assert.assertEquals(field.getResult(), "58");

• removeAt

  public void removeAt(int index)
               throws java.lang.Exception

  Removes a general format occurrence at the specified index.

  Parameters:

  index -

  Example:

  Shows how to formatting fields

  Document doc = new Document();
  DocumentBuilder builder = new DocumentBuilder(doc);
  
  // Use a document builder to insert field with no format
  Field field = builder.insertField("= 2 + 3");
  
  // We can format our field here instead of in the field code
  FieldFormat format = field.getFormat();
  format.setNumericFormat("$###.00");
  field.update();
  
  // Apply a date/time format
  field = builder.insertField("DATE");
  format = field.getFormat();
  format.setDateTimeFormat("dddd, MMMM dd, yyyy");
  field.update();
  
  // Apply 2 general formats at the same time
  field = builder.insertField("= 25 + 33");
  format = field.getFormat();
  format.getGeneralFormats().add(GeneralFormat.LOWERCASE_ROMAN);
  format.getGeneralFormats().add(GeneralFormat.UPPER);
  field.update();
  
  int index = 0;
  Iterator<Integer> generalFormatEnumerator = format.getGeneralFormats().iterator();
  while (generalFormatEnumerator.hasNext()) {
      System.out.println(MessageFormat.format("General format index {0}: {1}", index++, generalFormatEnumerator.toString()));
  }
  
  Assert.assertEquals("LVIII", field.getResult());
  Assert.assertEquals(2, format.getGeneralFormats().getCount());
  Assert.assertEquals(format.getGeneralFormats().get(0), GeneralFormat.LOWERCASE_ROMAN);
  
  // Removing field formats
  format.getGeneralFormats().remove(GeneralFormat.LOWERCASE_ROMAN);
  format.getGeneralFormats().removeAt(0);
  Assert.assertEquals(format.getGeneralFormats().getCount(), 0);
  field.update();
  
  // Our field has no general formats left and is back to default form
  Assert.assertEquals(field.getResult(), "58");