com.aspose.words

Constructor Detail

• CustomPart

  public CustomPart()

Property Getters/Setters Detail

• getContentType/setContentType

  public java.lang.String getContentType() / public void setContentType(java.lang.String value)
  

  Specifies the content type of this custom part.

  This property is applicable only when IsExternal is false.

  The default value is an empty string. A valid value must be a non-empty string.

  Example:

  Shows how to access a document's arbitrary custom parts collection.

  Document doc = new Document(getMyDir() + "Custom parts OOXML package.docx");
  
  Assert.assertEquals(2, doc.getPackageCustomParts().getCount());
  
  // Clone the second part, then add the clone to the collection.
  CustomPart clonedPart = doc.getPackageCustomParts().get(1).deepClone();
  doc.getPackageCustomParts().add(clonedPart);
  
  Assert.assertEquals(3, doc.getPackageCustomParts().getCount());
  
  // Enumerate over the collection and print every part.
  Iterator<CustomPart> enumerator = doc.getPackageCustomParts().iterator();
  
  int index = 0;
  while (enumerator.hasNext()) {
      CustomPart customPart = (CustomPart) enumerator.next();
      System.out.println(MessageFormat.format("Part index {0}:", index));
      System.out.println(MessageFormat.format("\tName: {0}", customPart.getName()));
      System.out.println(MessageFormat.format("\tContentType: {0}", customPart.getContentType()));
      System.out.println(MessageFormat.format("\tRelationshipType: {0}", customPart.getRelationshipType()));
      if (customPart.isExternal()) {
          System.out.println("\tSourced from outside the document");
      } else {
          System.out.println(MessageFormat.format("\tSourced from within the document, length: {0} bytes", customPart.getData().length));
      }
      index++;
  }
  
  // We can remove elements from this collection individually, or all at once.
  doc.getPackageCustomParts().removeAt(2);
  
  Assert.assertEquals(2, doc.getPackageCustomParts().getCount());
  
  doc.getPackageCustomParts().clear();
  
  Assert.assertEquals(0, doc.getPackageCustomParts().getCount());

• getData/setData

  public byte[] getData() / public void setData(byte[] value)
  

  Contains the data of this custom part.

  This property is applicable only when IsExternal is false.

  The default value is an empty byte array. The value cannot be null.

  Example:

  Shows how to access a document's arbitrary custom parts collection.

  Document doc = new Document(getMyDir() + "Custom parts OOXML package.docx");
  
  Assert.assertEquals(2, doc.getPackageCustomParts().getCount());
  
  // Clone the second part, then add the clone to the collection.
  CustomPart clonedPart = doc.getPackageCustomParts().get(1).deepClone();
  doc.getPackageCustomParts().add(clonedPart);
  
  Assert.assertEquals(3, doc.getPackageCustomParts().getCount());
  
  // Enumerate over the collection and print every part.
  Iterator<CustomPart> enumerator = doc.getPackageCustomParts().iterator();
  
  int index = 0;
  while (enumerator.hasNext()) {
      CustomPart customPart = (CustomPart) enumerator.next();
      System.out.println(MessageFormat.format("Part index {0}:", index));
      System.out.println(MessageFormat.format("\tName: {0}", customPart.getName()));
      System.out.println(MessageFormat.format("\tContentType: {0}", customPart.getContentType()));
      System.out.println(MessageFormat.format("\tRelationshipType: {0}", customPart.getRelationshipType()));
      if (customPart.isExternal()) {
          System.out.println("\tSourced from outside the document");
      } else {
          System.out.println(MessageFormat.format("\tSourced from within the document, length: {0} bytes", customPart.getData().length));
      }
      index++;
  }
  
  // We can remove elements from this collection individually, or all at once.
  doc.getPackageCustomParts().removeAt(2);
  
  Assert.assertEquals(2, doc.getPackageCustomParts().getCount());
  
  doc.getPackageCustomParts().clear();
  
  Assert.assertEquals(0, doc.getPackageCustomParts().getCount());

• isExternal/isExternal

  public boolean isExternal() / public void isExternal(boolean value)
  

  False if this custom part is stored inside the OOXML package. True if this custom part is an external target.

  The default value is false.

  Example:

  Shows how to access a document's arbitrary custom parts collection.

  Document doc = new Document(getMyDir() + "Custom parts OOXML package.docx");
  
  Assert.assertEquals(2, doc.getPackageCustomParts().getCount());
  
  // Clone the second part, then add the clone to the collection.
  CustomPart clonedPart = doc.getPackageCustomParts().get(1).deepClone();
  doc.getPackageCustomParts().add(clonedPart);
  
  Assert.assertEquals(3, doc.getPackageCustomParts().getCount());
  
  // Enumerate over the collection and print every part.
  Iterator<CustomPart> enumerator = doc.getPackageCustomParts().iterator();
  
  int index = 0;
  while (enumerator.hasNext()) {
      CustomPart customPart = (CustomPart) enumerator.next();
      System.out.println(MessageFormat.format("Part index {0}:", index));
      System.out.println(MessageFormat.format("\tName: {0}", customPart.getName()));
      System.out.println(MessageFormat.format("\tContentType: {0}", customPart.getContentType()));
      System.out.println(MessageFormat.format("\tRelationshipType: {0}", customPart.getRelationshipType()));
      if (customPart.isExternal()) {
          System.out.println("\tSourced from outside the document");
      } else {
          System.out.println(MessageFormat.format("\tSourced from within the document, length: {0} bytes", customPart.getData().length));
      }
      index++;
  }
  
  // We can remove elements from this collection individually, or all at once.
  doc.getPackageCustomParts().removeAt(2);
  
  Assert.assertEquals(2, doc.getPackageCustomParts().getCount());
  
  doc.getPackageCustomParts().clear();
  
  Assert.assertEquals(0, doc.getPackageCustomParts().getCount());

  See Also:

  Name

• getName/setName

  public java.lang.String getName() / public void setName(java.lang.String value)
  

  Gets or sets this part's absolute name within the OOXML package or the target URL.

  If the relationship target is internal, then this property is the absolute part name within the package. If the relationship target is external, then this property is the target URL.

  The default value is an empty string. A valid value must be a non-empty string.

  Example:

  Shows how to access a document's arbitrary custom parts collection.

  Document doc = new Document(getMyDir() + "Custom parts OOXML package.docx");
  
  Assert.assertEquals(2, doc.getPackageCustomParts().getCount());
  
  // Clone the second part, then add the clone to the collection.
  CustomPart clonedPart = doc.getPackageCustomParts().get(1).deepClone();
  doc.getPackageCustomParts().add(clonedPart);
  
  Assert.assertEquals(3, doc.getPackageCustomParts().getCount());
  
  // Enumerate over the collection and print every part.
  Iterator<CustomPart> enumerator = doc.getPackageCustomParts().iterator();
  
  int index = 0;
  while (enumerator.hasNext()) {
      CustomPart customPart = (CustomPart) enumerator.next();
      System.out.println(MessageFormat.format("Part index {0}:", index));
      System.out.println(MessageFormat.format("\tName: {0}", customPart.getName()));
      System.out.println(MessageFormat.format("\tContentType: {0}", customPart.getContentType()));
      System.out.println(MessageFormat.format("\tRelationshipType: {0}", customPart.getRelationshipType()));
      if (customPart.isExternal()) {
          System.out.println("\tSourced from outside the document");
      } else {
          System.out.println(MessageFormat.format("\tSourced from within the document, length: {0} bytes", customPart.getData().length));
      }
      index++;
  }
  
  // We can remove elements from this collection individually, or all at once.
  doc.getPackageCustomParts().removeAt(2);
  
  Assert.assertEquals(2, doc.getPackageCustomParts().getCount());
  
  doc.getPackageCustomParts().clear();
  
  Assert.assertEquals(0, doc.getPackageCustomParts().getCount());

  See Also:

  IsExternal

• getRelationshipType/setRelationshipType

  public java.lang.String getRelationshipType() / public void setRelationshipType(java.lang.String value)
  

  Gets or sets the relationship type from the parent part to this custom part.

  The relationship type for a custom part must be "unknown" e.g. a custom relationship type, not one of the relationship types defined within ISO/IEC 29500.

  The default value is an empty string. A valid value must be a non-empty string.

  Example:

  Shows how to access a document's arbitrary custom parts collection.

  Document doc = new Document(getMyDir() + "Custom parts OOXML package.docx");
  
  Assert.assertEquals(2, doc.getPackageCustomParts().getCount());
  
  // Clone the second part, then add the clone to the collection.
  CustomPart clonedPart = doc.getPackageCustomParts().get(1).deepClone();
  doc.getPackageCustomParts().add(clonedPart);
  
  Assert.assertEquals(3, doc.getPackageCustomParts().getCount());
  
  // Enumerate over the collection and print every part.
  Iterator<CustomPart> enumerator = doc.getPackageCustomParts().iterator();
  
  int index = 0;
  while (enumerator.hasNext()) {
      CustomPart customPart = (CustomPart) enumerator.next();
      System.out.println(MessageFormat.format("Part index {0}:", index));
      System.out.println(MessageFormat.format("\tName: {0}", customPart.getName()));
      System.out.println(MessageFormat.format("\tContentType: {0}", customPart.getContentType()));
      System.out.println(MessageFormat.format("\tRelationshipType: {0}", customPart.getRelationshipType()));
      if (customPart.isExternal()) {
          System.out.println("\tSourced from outside the document");
      } else {
          System.out.println(MessageFormat.format("\tSourced from within the document, length: {0} bytes", customPart.getData().length));
      }
      index++;
  }
  
  // We can remove elements from this collection individually, or all at once.
  doc.getPackageCustomParts().removeAt(2);
  
  Assert.assertEquals(2, doc.getPackageCustomParts().getCount());
  
  doc.getPackageCustomParts().clear();
  
  Assert.assertEquals(0, doc.getPackageCustomParts().getCount());

Method Detail

• deepClone

  public CustomPart deepClone()

  Makes a "deep enough" copy of the object. Does not duplicate the bytes of the Data value.

  Example:

  Shows how to access a document's arbitrary custom parts collection.

  Document doc = new Document(getMyDir() + "Custom parts OOXML package.docx");
  
  Assert.assertEquals(2, doc.getPackageCustomParts().getCount());
  
  // Clone the second part, then add the clone to the collection.
  CustomPart clonedPart = doc.getPackageCustomParts().get(1).deepClone();
  doc.getPackageCustomParts().add(clonedPart);
  
  Assert.assertEquals(3, doc.getPackageCustomParts().getCount());
  
  // Enumerate over the collection and print every part.
  Iterator<CustomPart> enumerator = doc.getPackageCustomParts().iterator();
  
  int index = 0;
  while (enumerator.hasNext()) {
      CustomPart customPart = (CustomPart) enumerator.next();
      System.out.println(MessageFormat.format("Part index {0}:", index));
      System.out.println(MessageFormat.format("\tName: {0}", customPart.getName()));
      System.out.println(MessageFormat.format("\tContentType: {0}", customPart.getContentType()));
      System.out.println(MessageFormat.format("\tRelationshipType: {0}", customPart.getRelationshipType()));
      if (customPart.isExternal()) {
          System.out.println("\tSourced from outside the document");
      } else {
          System.out.println(MessageFormat.format("\tSourced from within the document, length: {0} bytes", customPart.getData().length));
      }
      index++;
  }
  
  // We can remove elements from this collection individually, or all at once.
  doc.getPackageCustomParts().removeAt(2);
  
  Assert.assertEquals(2, doc.getPackageCustomParts().getCount());
  
  doc.getPackageCustomParts().clear();
  
  Assert.assertEquals(0, doc.getPackageCustomParts().getCount());