PdfArray is the PDF Array object.
*
* An array is a sequence of PDF objects. An array may contain a mixture of object types.
* An array is written as a left square bracket ([), followed by a sequence of objects,
* followed by a right square bracket (]).
* This object is described in the 'Portable Document Format Reference Manual version 1.3'
* section 4.6 (page 40).
*
* @see PdfObject
*/
public class PdfArray : PdfObject {
// membervariables
/** this is the actual array of PdfObjects */
protected ArrayList arrayList;
// constructors
/**
* Constructs an empty PdfArray-object.
*/
public PdfArray() : base(ARRAY) {
arrayList = new ArrayList();
}
/**
* Constructs an PdfArray-object, containing 1 PdfObject.
*
* @param object a PdfObject that has to be added to the array
*/
public PdfArray(PdfObject obj) : base(ARRAY) {
arrayList = new ArrayList();
arrayList.Add(obj);
}
public PdfArray(float[] values) : base(ARRAY) {
arrayList = new ArrayList();
Add(values);
}
public PdfArray(int[] values) : base(ARRAY) {
arrayList = new ArrayList();
Add(values);
}
/**
* Constructs an PdfArray-object, containing all the PdfObjects in a given PdfArray.
*
* @param array a PdfArray that has to be added to the array
*/
public PdfArray(PdfArray array) : base(ARRAY) {
arrayList = new ArrayList(array.ArrayList);
}
// methods overriding some methods in PdfObject
/**
* Returns the PDF representation of this PdfArray.
*
* @return an array of bytes
*/
public override void ToPdf(PdfWriter writer, Stream os) {
os.WriteByte((byte)'[');
bool first = true;
PdfObject obj = null;
foreach (PdfObject obja in arrayList) {
obj = (obja == null) ? PdfNull.PDFNULL : obja;
type = obj.Type;
if (!first && type != PdfObject.ARRAY && type != PdfObject.DICTIONARY && type != PdfObject.NAME && type != PdfObject.STRING)
os.WriteByte((byte)' ');
first = false;
obj.ToPdf(writer, os);
}
os.WriteByte((byte)']');
}
// methods concerning the ArrayList-membervalue
/**
* Returns an ArrayList containing PdfObjects.
*
* @return an ArrayList
*/
public ArrayList ArrayList {
get {
return arrayList;
}
}
/**
* Returns the number of entries in the array.
*
* @return the size of the ArrayList
*/
public int Size {
get {
return arrayList.Count;
}
}
/**
* Adds a PdfObject to the PdfArray.
*
* @param object PdfObject to add
* @return true
*/
public virtual bool Add(PdfObject obj) {
arrayList.Add(obj);
return true;
}
public bool Add(float[] values) {
for (int k = 0; k < values.Length; ++k)
arrayList.Add(new PdfNumber(values[k]));
return true;
}
public bool Add(int[] values) {
for (int k = 0; k < values.Length; ++k)
arrayList.Add(new PdfNumber(values[k]));
return true;
}
/**
* Adds a PdfObject to the PdfArray.
*
* The newly added object will be the first element in the ArrayList.
*
* @param object PdfObject to add
*/
public void AddFirst(PdfObject obj) {
arrayList.Insert(0, obj);
}
/**
* Checks if the PdfArray allready contains a certain PdfObject.
*
* @param object PdfObject to check
* @return true
*/
public bool Contains(PdfObject obj) {
return arrayList.Contains(obj);
}
public ListIterator GetListIterator() {
return new ListIterator(arrayList);
}
public override string ToString() {
return arrayList.ToString();
}
public PdfObject GetPdfObject( int idx ) {
return (PdfObject)arrayList[idx];
}
public PdfObject GetDirectObject( int idx ) {
return PdfReader.GetPdfObject(GetPdfObject(idx));
}
// more of the same like PdfDictionary. (MAS 2/17/06)
public PdfDictionary GetAsDict(int idx) {
PdfDictionary dict = null;
PdfObject orig = GetDirectObject(idx);
if (orig != null && orig.IsDictionary())
dict = (PdfDictionary) orig;
return dict;
}
public PdfArray GetAsArray(int idx) {
PdfArray array = null;
PdfObject orig = GetDirectObject(idx);
if (orig != null && orig.IsArray())
array = (PdfArray) orig;
return array;
}
public PdfStream GetAsStream(int idx) {
PdfStream stream = null;
PdfObject orig = GetDirectObject(idx);
if (orig != null && orig.IsStream())
stream = (PdfStream) orig;
return stream;
}
public PdfString GetAsString(int idx) {
PdfString str = null;
PdfObject orig = GetDirectObject(idx);
if (orig != null && orig.IsString())
str = (PdfString) orig;
return str;
}
public PdfNumber GetAsNumber(int idx) {
PdfNumber number = null;
PdfObject orig = GetDirectObject(idx);
if (orig != null && orig.IsNumber())
number = (PdfNumber) orig;
return number;
}
public PdfName GetAsName(int idx) {
PdfName name = null;
PdfObject orig = GetDirectObject(idx);
if (orig != null && orig.IsName())
name = (PdfName) orig;
return name;
}
public PdfBoolean GetAsBoolean(int idx) {
PdfBoolean b = null;
PdfObject orig = GetDirectObject(idx);
if (orig != null && orig.IsBoolean())
b = (PdfBoolean) orig;
return b;
}
public PdfIndirectReference GetAsIndirectObject(int idx) {
PdfIndirectReference refi = null;
PdfObject orig = GetPdfObject(idx); // not getDirect this time.
if (orig != null && orig.IsIndirect())
refi = (PdfIndirectReference) orig;
return refi;
}
}
}