Class ImageListViewItem
Represents an item in the image list view.
Inheritance
Implements
Namespace: Manina.Windows.Forms
Assembly: ImageListView.dll
Syntax
[TypeConverter(typeof(ImageListViewItemTypeConverter))]
public class ImageListViewItem : ICloneable
Constructors
| Improve this Doc View SourceImageListViewItem()
Initializes a new instance of the ImageListViewItem class.
Declaration
public ImageListViewItem()
ImageListViewItem(Object)
Initializes a new instance of a virtual ImageListViewItem class.
Declaration
public ImageListViewItem(object key)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Object | key | The key identifying this item. |
ImageListViewItem(Object, String)
Initializes a new instance of a virtual ImageListViewItem class.
Declaration
public ImageListViewItem(object key, string text)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Object | key | The key identifying this item. |
| System.String | text | Text of this item. |
ImageListViewItem(String)
Initializes a new instance of the ImageListViewItem class.
Declaration
public ImageListViewItem(string filename)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | filename | The image filename representing the item. |
ImageListViewItem(String, String)
Initializes a new instance of the ImageListViewItem class.
Declaration
public ImageListViewItem(string filename, string text)
Parameters
| Type | Name | Description |
|---|---|---|
| System.String | filename | The image filename representing the item. |
| System.String | text | Item text |
Properties
| Improve this Doc View SourceAdaptor
Gets the adaptor of this item.
Declaration
[Browsable(false)]
public ImageListView.ImageListViewItemAdaptor Adaptor { get; }
Property Value
| Type | Description |
|---|---|
| ImageListView.ImageListViewItemAdaptor |
Artist
Gets the name of the artist.
Declaration
[Browsable(true)]
public string Artist { get; }
Property Value
| Type | Description |
|---|---|
| System.String |
Checked
Gets or sets a value determining if the item is checked.
Declaration
[Browsable(true)]
public bool Checked { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
Copyright
Gets image copyright information.
Declaration
[Browsable(true)]
public string Copyright { get; }
Property Value
| Type | Description |
|---|---|
| System.String |
DateAccessed
Gets the last access date of the image file represented by this item.
Declaration
[Browsable(true)]
public DateTime DateAccessed { get; }
Property Value
| Type | Description |
|---|---|
| System.DateTime |
DateCreated
Gets the creation date of the image file represented by this item.
Declaration
[Browsable(true)]
public DateTime DateCreated { get; }
Property Value
| Type | Description |
|---|---|
| System.DateTime |
DateModified
Gets the modification date of the image file represented by this item.
Declaration
[Browsable(true)]
public DateTime DateModified { get; }
Property Value
| Type | Description |
|---|---|
| System.DateTime |
DateTaken
Gets the date and time the image was taken.
Declaration
[Browsable(true)]
public DateTime DateTaken { get; }
Property Value
| Type | Description |
|---|---|
| System.DateTime |
Dimensions
Gets image dimensions.
Declaration
[Browsable(true)]
public Size Dimensions { get; }
Property Value
| Type | Description |
|---|---|
| System.Drawing.Size |
Enabled
Gets a value determining if the item is enabled.
Declaration
[Browsable(true)]
public bool Enabled { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
EquipmentModel
Gets the camera model.
Declaration
[Browsable(true)]
public string EquipmentModel { get; }
Property Value
| Type | Description |
|---|---|
| System.String |
ExposureTime
Gets the exposure time in seconds.
Declaration
[Browsable(true)]
public float ExposureTime { get; }
Property Value
| Type | Description |
|---|---|
| System.Single |
FileName
Gets or sets the name of the image file represented by this item.
Declaration
[Browsable(true)]
public string FileName { get; set; }
Property Value
| Type | Description |
|---|---|
| System.String |
FilePath
Gets the path of the image file represented by this item.
Declaration
[Browsable(true)]
public string FilePath { get; }
Property Value
| Type | Description |
|---|---|
| System.String |
FileSize
Gets file size in bytes.
Declaration
[Browsable(true)]
public long FileSize { get; }
Property Value
| Type | Description |
|---|---|
| System.Int64 |
FileType
Gets the shell type of the image file represented by this item.
Declaration
[Browsable(true)]
public string FileType { get; }
Property Value
| Type | Description |
|---|---|
| System.String |
FNumber
Gets the F number.
Declaration
[Browsable(true)]
public float FNumber { get; }
Property Value
| Type | Description |
|---|---|
| System.Single |
FocalLength
Gets focal length of the lens in millimeters.
Declaration
[Browsable(true)]
public float FocalLength { get; }
Property Value
| Type | Description |
|---|---|
| System.Single |
Focused
Gets a value determining if the item is focused.
Declaration
[Browsable(false)]
public bool Focused { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
FolderName
Gets the name of the folder represented by this item.
Declaration
[Browsable(true)]
public string FolderName { get; }
Property Value
| Type | Description |
|---|---|
| System.String |
ImageDescription
Gets image description.
Declaration
[Browsable(true)]
public string ImageDescription { get; }
Property Value
| Type | Description |
|---|---|
| System.String |
ImageListView
Gets the ImageListView owning this item.
Declaration
[Browsable(false)]
public ImageListView ImageListView { get; }
Property Value
| Type | Description |
|---|---|
| ImageListView |
Index
Gets the index of the item.
Declaration
[Browsable(false)]
public int Index { get; }
Property Value
| Type | Description |
|---|---|
| System.Int32 |
ISOSpeed
Gets the ISO speed.
Declaration
[Browsable(true)]
public ushort ISOSpeed { get; }
Property Value
| Type | Description |
|---|---|
| System.UInt16 |
LargeIcon
Gets the large shell icon of the image file represented by this item. If the icon image is not cached, it will be added to the cache queue and null will be returned.
Declaration
[Browsable(false)]
public Image LargeIcon { get; }
Property Value
| Type | Description |
|---|---|
| System.Drawing.Image |
Rating
Gets rating in percent between 0-99 (Windows specific).
Declaration
[Browsable(true)]
public ushort Rating { get; }
Property Value
| Type | Description |
|---|---|
| System.UInt16 |
Resolution
Gets image resolution in pixels per inch.
Declaration
[Browsable(true)]
public SizeF Resolution { get; }
Property Value
| Type | Description |
|---|---|
| System.Drawing.SizeF |
Selected
Gets or sets a value determining if the item is selected.
Declaration
[Browsable(false)]
public bool Selected { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
SmallIcon
Gets the small shell icon of the image file represented by this item. If the icon image is not cached, it will be added to the cache queue and null will be returned.
Declaration
[Browsable(false)]
public Image SmallIcon { get; }
Property Value
| Type | Description |
|---|---|
| System.Drawing.Image |
Software
Gets the name of the application that created this file.
Declaration
[Browsable(true)]
public string Software { get; }
Property Value
| Type | Description |
|---|---|
| System.String |
StarRating
Gets the star rating between 0-5 (Windows specific).
Declaration
[Browsable(true)]
public ushort StarRating { get; }
Property Value
| Type | Description |
|---|---|
| System.UInt16 |
SubItems
Gets the collection of sub items.
Declaration
[Browsable(true)]
public ImageListViewSubItemCollection SubItems { get; }
Property Value
| Type | Description |
|---|---|
| ImageListViewSubItemCollection |
Tag
Gets or sets the user-defined data associated with the item.
Declaration
[Browsable(true)]
[TypeConverter(typeof(StringConverter))]
public object Tag { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Object |
Text
Gets or sets the text associated with this item. If left blank, item Text reverts to the name of the image file.
Declaration
[Browsable(true)]
public string Text { get; set; }
Property Value
| Type | Description |
|---|---|
| System.String |
ThumbnailCacheState
Gets the cache state of the item thumbnail.
Declaration
[Browsable(false)]
public CacheState ThumbnailCacheState { get; }
Property Value
| Type | Description |
|---|---|
| CacheState |
ThumbnailImage
Gets the thumbnail image. If the thumbnail image is not cached, it will be added to the cache queue and null will be returned. The returned image needs to be disposed by the caller.
Declaration
[Browsable(false)]
public Image ThumbnailImage { get; }
Property Value
| Type | Description |
|---|---|
| System.Drawing.Image |
UserComment
Gets user comments.
Declaration
[Browsable(true)]
public string UserComment { get; }
Property Value
| Type | Description |
|---|---|
| System.String |
VirtualItemKey
Gets the virtual item key associated with this item. Returns null if the item is not a virtual item.
Declaration
[Browsable(false)]
public object VirtualItemKey { get; }
Property Value
| Type | Description |
|---|---|
| System.Object |
ZOrder
Gets or sets the draw order of the item.
Declaration
[Browsable(true)]
public int ZOrder { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Int32 |
Methods
| Improve this Doc View SourceBeginEdit()
Begins editing the item. This method must be used while editing the item to prevent collisions with the cache manager.
Declaration
public void BeginEdit()
Clone()
Creates a new object that is a copy of the current instance.
Declaration
public object Clone()
Returns
| Type | Description |
|---|---|
| System.Object | A new object that is a copy of this instance. |
EndEdit()
Ends editing and updates the item.
Declaration
public void EndEdit()
EndEdit(Boolean)
Ends editing and updates the item.
Declaration
public void EndEdit(bool update)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Boolean | update | If set to true, the item will be immediately updated. |
GetCachedImage(CachedImageType)
Gets an image from the cache manager. If the thumbnail image is not cached, it will be added to the cache queue and DefaultImage of the owner image list view will be returned. If the thumbnail could not be cached ErrorImage of the owner image list view will be returned.
Declaration
public Image GetCachedImage(CachedImageType imageType)
Parameters
| Type | Name | Description |
|---|---|---|
| CachedImageType | imageType | Type of cached image to return. |
Returns
| Type | Description |
|---|---|
| System.Drawing.Image | Requested thumbnail or icon. |
GetSubItemText(ColumnType)
Returns the sub item item text corresponding to the specified column type.
Declaration
public string GetSubItemText(ColumnType type)
Parameters
| Type | Name | Description |
|---|---|---|
| ColumnType | type | The type of information to return. |
Returns
| Type | Description |
|---|---|
| System.String | Formatted text for the given column type. |
ToString()
Returns a System.String that represents this instance.
Declaration
public override string ToString()
Returns
| Type | Description |
|---|---|
| System.String | A System.String that represents this instance. |
Overrides
Update()
Updates item thumbnail and item details.
Declaration
public void Update()