§4.2
Interface ICollectionValue<T> 49
4.2 Interface ICollectionValue<T>
Inheritsfrom: System.Collections.Generic.IEnumerable<T>,System.IFormattable,
and IShowable.
Implemented by: ArrayList<T> (section 6.2), HashBag<T> (section 6.11), Hash-
Dictionary<K,V> (section 7.1), HashSet<T> (section 6.10), HashedArrayList<T>
(section 6.4), HashedLinkedList<T> (section 6.5), IntervalHeap<T> (section 6.12),
LinkedList<T> (section 6.3),SortedArray<T> (section 6.7), TreeBag<T> (section6.9),
TreeDictionary<K,V> (section 7.2),TreeSet<T>(section 6.8), and WrappedArray<T>
(section 6.6).
Properties
 Read-only property
EventTypeEnum
ActiveEvents
is the set ofevents for which
there are active event handlers attached to this collection. More precisely, it
is the of bitwise or of the EventTypeEnum values for those events; see sec-
tion 3.1.
 Read-only property
int
Count
is the number of items in the collection value;
this is the number of items that enumeration of the collection value would
produce.
 Read-only property
Speed
CountSpeed
is theguaranteedrun-timeofthe
Count
property; see section 3.3.
 Read-only property
bool
IsEmpty
is true if
Count
is zero, otherwise false.
 Read-only property
EventTypeEnum
ListenableEvents
is the set of events
for which handlers can be attachedto this collection, or more precisely, the bit-
wise or of the EventTypeEnum values; see section 3.1. For instance, to test
whetheran ItemInsertedHandler can be attached, evaluate
(ListenableEvents
& EventTypeEnum.Inserted) != 0
. An attempt to attach an event handler on
an event that is not listenable will throw UnlistenableEventException.
Methods
bool
All
(Fun<T,bool> p)
applies delegate
p
to each item
x
of the collection
in enumeration order until
p(x)
evaluates to false or until there are no more
items. Returns false if
p(x)
returned false for some item; otherwise returns
true. If the delegate
p
modies the given collection, then a CollectionModi-
edException may be thrown.
void
Apply
(Act<T> act)
applies delegate
act
to each item
x
of the collection
in enumeration order. If the delegate
act
modies the given collection, then a
CollectionModiedException may be thrown.
To tiff - SDK application API:C# PDF Convert to Tiff SDK: Convert PDF to tiff images in C#.net, ASP.NET MVC, Ajax, WinForms, WPF
Online C# Tutorial for How to Convert PDF File to Tiff Image File
www.rasteredge.com
To tiff - SDK application API:VB.NET PDF Convert to Tiff SDK: Convert PDF to tiff images in vb.net, ASP.NET MVC, Ajax, WinForms, WPF
Free VB.NET Guide to Render and Convert PDF Document to TIFF
www.rasteredge.com
50 Interface ICollectionValue<T>
§4.2
T
Choose
()
returns an arbitrary item from the collection, or throws NoSuch-
ItemException if the collection is empty. Multiple calls to
Choose()
may return
the same item or distinct items, at the collection’s whim. For collections that
also implement ICollection<T> it is guaranteed that if
Choose()
returns item
x
,then
Remove(x)
on the same unmodied collection will be efcient.
void
CopyTo
(T[] arr, int i)
copies the collection’s items to array
arr
in
enumeration order,starting at position
i
in
arr
.Throws ArgumentOutOfRange-
Exception if
i < 0
or
Count+i > arr.Length
,and if so does not modify
arr
.
Throws NullReferenceException if
arr
is
null
.Throws ArrayTypeMismatchEx-
ception if some collection item is not assignable to the array’s element type,
after copying all items until, but not including, the offending one.
bool
Exists
(Fun<T,bool> p)
applies delegate
p
toeach item
x
ofthe collection
in enumeration order until
p(x)
evaluates to true or until there are no more
items. Returns true if
p(x)
returned true for some item; otherwise returns
false. If the delegate
p
modies the given collection, then a CollectionModi-
edException may be thrown.
SCG.IEnumerable<T>
Filter
(Fun<T,bool> p)
creates an enumerable whose enu-
merators apply delegate
p
to each item
x
of the collection in enumeration or-
der, yielding those items for which
p(x)
evaluates to true. Applies
p
to the
collection’s items only to the extent that items are requested from the enu-
merator. In particular, predicate
p
will not be called until the rst call of the
MoveNext()
method in an enumerator created from the enumerable. Applies
p
over again from the beginning of the collection for each enumerator created
from the enumerable. If the delegate
p
modies the given collection, then a
CollectionModiedException may be thrown.
bool
Find
(Fun<T,bool> p, out T res)
applies predicate
p
to each item
x
of
the collection in enumeration order until
p(x)
evaluates to true or until there
are no more items. Returns true if
p(x)
returned true for some item
x
and in
that case binds
res
to that item; otherwise returns false and binds the default
value for T to
res
. In case of success,
res
is the rst item
x
in the collection
for which
p(x)
is true. If the delegate
p
modies the given collection, then a
CollectionModiedException may be thrown.
T[]
ToArray
()
creates anew array that contains the collection’s items in enu-
meration order.
Events
Section 8.8.5 describes theevent handler types and section 8.8.6 describes the event
argument types. One cannot add event listeners to a list view (section 8.1), only to
the underlying list.
SDK application API:Online Convert PDF file to Tiff. Best free online PDF Tif
Online PDF to Tiff Converter. Download Free Trial. Convert a PDF File to Tiff. Just upload your file by clicking on the blue
www.rasteredge.com
SDK application API:RasterEdge XDoc.Tiff for .NET - SDK for Tiff Document Imaging
XDoc.Tiff for .NET. View, Convert, Edit, Process, Annotate Tiff Image Files. Convert Jpeg Images to Tiff. Tiff File Process. Create, Load, and Save Tiff File.
www.rasteredge.com
§4.2
Interface ICollectionValue<T> 51
event CollectionChangedHandler<T>
CollectionChanged
is raised to signal
the end ofa modication to the collection. The event argument is the collection
that was modied.
event CollectionClearedHandler<T>
CollectionCleared
is raised after the
collection or part ofit was cleared by
Clear
or
RemoveInterval
.The event argu-
ments are the collection itself and a description of what part of the collection
was cleared.
event ItemInsertedHandler<T>
ItemInserted
is raised after an item was
added to the indexed collection by
Enqueue
,
Insert
,
InsertAll
,
InsertFirst
,
InsertLast
,
Push
or the set accessor of an indexer
this[i]=e
.The event argu-
ments are the collection, the item that was added, and the position at which it
was added.
event ItemRemovedAtHandler<T>
ItemRemovedAt
is raised after an item was
removed fromthecollection by
Dequeue
,
Pop
,
RemoveAt
,
RemoveFirst
,
RemoveLast
,
or the set accessor of an indexer
this[i]=e
.The event arguments are the col-
lection and the item that was removed.
event ItemsAddedHandler<T>
ItemsAdded
is raised after an item was added
to the collection by
Add
,
Insert
,
Update
or similar, or by the set accessor of an
indexer
this[i]=e
. The event arguments are the collection itself, the item
x
that was added, and the number of copies of
x
that were added (always 1 when
the collection has set semantics).
event ItemsRemovedHandler<T>
ItemsRemoved
is raised after an item was re-
moved from the collection by
Remove
,
RemoveAt
,
RemoveRangeFromTo
,
Replace
,
RetainAll
,
Update
or similar, or by the set accessor of an indexer
this[i]=e
.
The event arguments are the collection itself, the item
x
that was removed,
and the number of copies of
x
that were removed (always 1 when the collection
has set semantics).
SDK application API:C# WPF Viewer: Load, View, Convert, Annotate and Edit Tiff
C# WPF Viewer: Load, View, Convert, Annotate and Edit Tiff. Tiff Image Viewing and Edit Functionalities in RasterEdge WPF Viewer for C#.NET. Tiff File Formats.
www.rasteredge.com
SDK application API:C# WinForms Viewer: Load, View, Convert, Annotate and Edit Tiff
C# WinForms Viewer: Load, View, Convert, Annotate and Edit Tiff. Supported Tiff Image Processing Features in RasterEdge WinForms Viewer for C#.NET. Overview.
www.rasteredge.com
52 Interface IDirectedCollectionValue<T>
§4.3
4.3 Interface IDirectedCollectionValue<T>
Inherits from: ICollectionValue<T> and IDirectedEnumerable<T>.
Implemented by: ArrayList<T> (section 6.2), CircularQueue<T> (section 6.1),
HashedArrayList<T> (section 6.4), HashedLinkedList<T> (section 6.5), LinkedList<T>
(section 6.3), SortedArray<T> (section 6.7), TreeBag<T> (section 6.9), TreeSet<T>
(section 6.8), and WrappedArray<T> (section 6.6).
Properties
 Read-only property
EventTypeEnum
ActiveEvents
,see page 49.
 Read-only property
int
Count
,see page 49.
 Read-only property
Speed
CountSpeed
,see page 49.
 Read-only property
EnumerationDirection
Direction
,see page 54.
 Read-only property
bool
IsEmpty
,see page 49.
 Read-only property
EventTypeEnum
ListenableEvents
,see page 49.
Methods
bool
All
(Fun<T,bool> p)
,see page 49.
void
Apply
(Act<T> act)
,see page 49.
IDirectedEnumerable<T>
IDirectedEnumerable<T>.Backwards
()
,
see page 54.
IDirectedCollectionValue<T>
Backwards
()
returns a new directed collection
value that has the opposite enumeration order of the given one.
T
Choose
()
,see page 50.
void
CopyTo
(T[] arr, int i)
,see page 50.
bool
Exists
(Fun<T,bool> p)
,see page 50.
SCG.IEnumerable<T>
Filter
(Fun<T,bool> p)
,see page 50.
bool
Find
(Fun<T,bool> p, out T res)
,see page 50.
bool
FindLast
(Fun<T,bool> p, out T res)
applies predicate
p
to each item
x
of the collection in reverse enumeration order until
p(x)
evaluates to true
or until there are no more items. Returns true if
p(x)
returned true for some
item
x
and in that case binds
res
to that item; otherwise returns false and
binds the default value for T to
res
. In case of success,
res
is the last item
SDK application API:C# HTML5 Viewer: Load, View, Convert, Annotate and Edit Tiff
C# HTML5 Viewer: Load, View, Convert, Annotate and Edit Tiff. Supported Tiff Image Processing Functionalities in RasterEdge XDoc. Tiff File Formats.
www.rasteredge.com
SDK application API:C# TIFF: TIFF Editor SDK to Read & Manipulate TIFF File Using C#.
C# Tiff - Read & Edit Tiff File in C#. Use C#.NET Tiff Reading and Editing Control to Process & Manipulate TIFF File. C#.NET TIFF Processing & Reading Control.
www.rasteredge.com
§4.3
Interface IDirectedCollectionValue<T> 53
x
in the collection for which
p(x)
is true. Equivalent to, but potentially more
efcient than,
Backwards().Find(p, out res)
. If the delegate
p
modies the
given collection, then a CollectionModiedException may be thrown.
T[]
ToArray
()
,see page 50.
Events
event CollectionChangedHandler<T>
CollectionChanged
,see page 51.
event CollectionClearedHandler<T>
CollectionCleared
,see page 51.
event ItemInsertedHandler<T>
ItemInserted
,see page 51.
event ItemRemovedAtHandler<T>
ItemRemovedAt
,see page 51.
event ItemsAddedHandler<T>
ItemsAdded
,see page 51.
event ItemsRemovedHandler<T>
ItemsRemoved
,see page 51.
SDK application API:VB.NET TIFF: Read, Edit & Process TIFF with VB.NET Image Document
VB.NET TIFF - How to Read and Handle TIFF File. Read, View and Edit TIFF File by Applying VB.NET TIFF Reader & Processer. Visual C#.
www.rasteredge.com
SDK application API:C# Create PDF from Tiff Library to convert tif images to PDF in C#
C#.NET PDF - .NET PDF Library for Creating PDF from Tiff in C#. C#.NET Demo Code: Tiff to PDF Conversion in Visual C# .NET Class. Add necessary references:
www.rasteredge.com
54 Interface IDirectedEnumerable<T>
§4.4
4.4 Interface IDirectedEnumerable<T>
Inheritsfrom: System.Collections.Generic.IEnumerable<T> and System.IFormattable.
Implemented by: ArrayList<T> (section 6.2), CircularQueue<T> (section 6.1),
HashedArrayList<T> (section 6.4), HashedLinkedList<T> (section 6.5), LinkedList<T>
(section 6.3), SortedArray<T> (section 6.7), TreeBag<T> (section 6.9), TreeSet<T>
(section 6.8), and WrappedArray<T> (section 6.6).
Properties
 Read-only property
EnumerationDirection
Direction
returns
Forwards
ifthe
enumeration direction is unchanged from the original, otherwise
Backwards
.
Methods
IDirectedEnumerable<T>
Backwards
()
returns a newdirected enumerablethat
has the opposite enumeration order of the given one.
§4.5
Interface IExtensible<T> 55
4.5 Interface IExtensible<T>
Inherits from: ICollectionValue<T>, System.ICloneable<T>.
Implemented by: ArrayList<T> (section 6.2), HashBag<T> (section 6.11), Hash-
Set<T> (section 6.10), HashedArrayList<T> (section 6.4), HashedLinkedList<T>
(section 6.5), IntervalHeap<T> (section 6.12), LinkedList<T> (section 6.3), SortedAr-
ray<T> (section 6.7), TreeBag<T> (section 6.9), TreeSet<T> (section 6.8), and Wrap-
pedArray<T> (section 6.6).
Properties
 Read-only property
EventTypeEnum
ActiveEvents
,see page 49.
 Read-only property
bool
AllowsDuplicates
is true if the collection has bag
semantics: if it may contain two items that are equal by the collection’s com-
parer or equality comparer. Otherwise false, in which case the collection has
set semantics.
 Read-only property
int
Count
,see page 49.
 Read-only property
Speed
CountSpeed
,see page 49.
 Read-only property
bool
DuplicatesByCounting
is true if only the number
of duplicate items is stored, not the individual duplicate values themselves;
otherwise false. Namely, values may be equal by the collection’s comparer or
equality comparer, yet distinct objects. Relevant only for collections with bag
semantics; true by convention for collections with set semantics.
 Read-only property
SCG.IEqualityComparer<T>
EqualityComparer
is the item
equality comparer used by this collection.
 Read-only property
bool
IsEmpty
,see page 49.
 Read-only property
bool
IsReadOnly
is true ifthecollection is read-only, that
is, if all attempts at structural modication (
Add
,
Clear
,
Insert
,
Remove
,
Update
and so on) will throw an exception; false if the collection admits such modi-
cations. In particular, it is true for all guarded collections; see section 8.2.
 Read-only property
EventTypeEnum
ListenableEvents
,see page 49.
Methods
bool
Add
(T x)
attempts to add item
x
to the collection. Returns true if the
item was added; returns false if it was not, for instance because the collection
has set semantics (
AllowsDuplicates
is false) and already contains an item
equal to
x
.If the item was added, it raises events ItemsAdded and Collection-
Changed. Throws ReadOnlyCollectionException if the collection is read-only.
56 Interface IExtensible<T>
§4.5
void
AddAll
<U>(SCG.IEnumerable<U> xs) where U:T
attempts toadd the items
xs
to the collection, in enumeration order. If
AllowsDuplicates
is false, then
items in
xs
that are already in the collection, and duplicate items in
xs
,are ig-
nored. Ifany itemswere added,it raises event ItemsAddedfor each itemadded
and then raises CollectionChanged. Throws ReadOnlyCollectionException if
the collection is read-only. The method is generic so that it can be applied to
enumerables with any item type U that is a subtype of T; see section 8.4.
bool
All
(Fun<T,bool> p)
,see page 49.
void
Apply
(Act<T> act)
,see page 49.
bool
Check
()
performs a comprehensive integrity check of the collection’s in-
ternal representation. Relevant only for library developers.
T
Choose
()
,see page 50.
Object
Clone
()
creates a newcollection as a shallowcopy of the given one, as
ifby creating an empty collection
newcoll
and thendoing
newcoll.AddAll(this)
.
See section 8.9.
void
CopyTo
(T[] arr, int i)
,see page 50.
bool
Exists
(Fun<T,bool> p)
,see page 50.
SCG.IEnumerable<T>
Filter
(Fun<T,bool> p)
,see page 50.
bool
Find
(Fun<T,bool> p, out T res)
,see page 50.
T[]
ToArray
()
,see page 50.
Events
event CollectionChangedHandler<T>
CollectionChanged
,see page 51.
Raised by
Add
and
AddAll
.
event CollectionClearedHandler<T>
CollectionCleared
,see page 51.
event ItemInsertedHandler<T>
ItemInserted
,see page 51.
event ItemRemovedAtHandler<T>
ItemRemovedAt
,see page 51.
event ItemsAddedHandler<T>
ItemsAdded
,see page 51.
Raised by
Add
and
AddAll
.
event ItemsRemovedHandler<T>
ItemsRemoved
,see page 51.
§4.6
Interface IIndexed<T> 57
4.6 Interface IIndexed<T>
Inherits from: ISequenced<T>.
Implemented by: ArrayList<T> (section 6.2), HashedArrayList<T> (section 6.4),
HashedLinkedList<T> (section 6.5), LinkedList<T> (section 6.3), SortedArray<T>
(section 6.7), TreeBag<T> (section 6.9), TreeSet<T> (section 6.8), and Wrapped-
Array<T> (section 6.6).
Properties and indexers
 Read-only property
EventTypeEnum
ActiveEvents
,see page 49.
 Read-only property
bool
AllowsDuplicates
,see page 55.
 Read-only property
Speed
ContainsSpeed
,see page 44.
 Read-only property
int
Count
,see page 49.
 Read-only property
Speed
CountSpeed
,see page 49.
 Read-only property
EnumerationDirection
Direction
,see page 54.
 Read-only property
bool
DuplicatesByCounting
,see page 55.
 Read-only property
SCG.IEqualityComparer<T>
EqualityComparer
,seepage 55.
 Read-only property
Speed
IndexingSpeed
is the guaranteed run-time of the
collection’s indexer
this[int]
;see section 3.3.
 Read-only property
bool
IsEmpty
,see page 49.
 Read-only property
bool
IsReadOnly
,see page 55.
 Read-only property
EventTypeEnum
ListenableEvents
,see page 49.
 Read-only indexer
T
this
[int i]
returns the
i
’th item of this indexed collec-
tion. Throws IndexOutOfRangeException if
i < 0
or
i >= Count
.
 Read-only indexer
IDirectedCollectionValue<T>
this
[int i, int n]
returns
anew directed collection value containing those items of the given collection
that have indexes
i
,
i+1
,...,
i+n-1
,in that order. Does not create a new col-
lection, but provides read-only access to the collection subsequence. Throws
ArgumentOutOfRangeException if
i < 0
or
n < 0
or
i+n > Count
.
58 Interface IIndexed<T>
§4.6
Methods
bool
Add
(T x)
,see page 55.
void
AddAll
<U>(SCG.IEnumerable<U> xs) where U:T
,see page 56.
bool
All
(Fun<T,bool> p)
,see page 49.
void
Apply
(Act<T> act)
,see page 49.
IDirectedEnumerable<T>
IDirectedEnumerable<T>.Backwards
()
,
see page 54.
IDirectedCollectionValue<T>
Backwards
()
,see page 52.
bool
Check
()
,see page 56.
T
Choose
()
,see page 50.
void
Clear
()
,see page 45.
Object
Clone
()
,see page 56.
bool
Contains
(T x)
,see page 45.
bool
ContainsAll
<U>(SCG.IEnumerable<U> xs) where U:T
,see page 45.
int
ContainsCount
(T x)
,see page 45.
void
CopyTo
(T[] arr, int i)
,see page 50.
bool
Exists
(Fun<T,bool> p)
,see page 50.
SCG.IEnumerable<T>
Filter
(Fun<T,bool> p)
,see page 50.
bool
Find
(Fun<T,bool> p, out T res)
,see page 50.
bool
Find
(ref T x)
,see page 45.
int
FindIndex
(Fun<T,bool> p)
nds the position of the rst item
x
that sat-
ises predicate
p
,if any. More precisely, applies predicate
p
to each item
x
of
the collection in enumeration order until
p(x)
evaluates to true or until there
are no more items. Returns the index of the
x
for which
p(x)
returned true, if
any; otherwise returns  
1
.If the delegate
p
modies the given collection, then
aCollectionModiedException may be thrown.
bool
FindLast
(Fun<T,bool> p, out T res)
,see page 52.
int
FindLastIndex
(Fun<T,bool> p)
nds the position of the last item
x
that
satises predicate
p
,if any. More precisely, applies predicate
p
to each item
x
of the collection in reverse enumeration order until
p(x)
evaluates to true
or until there are no more items. Returns the index of the
x
for which
p(x)
returned true, if any; otherwise returns  
1
. If the delegate
p
modies the
given collection, then a CollectionModiedException may be thrown.
Documents you may be interested
Documents you may be interested