IconView IconView IconView Interface


Represents a view that displays Outlook items as a series of labeled icons.

public interface class IconView : Microsoft::Office::Interop::Outlook::_IconView
public interface IconView : Microsoft.Office.Interop.Outlook._IconView
Public Interface IconView
Implements _IconView


This is a .NET interface derived from a COM coclass that is required by managed code for interoperability with the corresponding COM object. Use this derived interface to access all method, property, and event members of the COM object. However, if a method or event you want to use shares the same name under the same COM object, cast to the corresponding primary interface to call the method, and cast to the latest events interface to connect to the event. Refer to this topic for information about the COM object. For information about the method and property members of the COM object, see _IconView.

The IconView object, derived from the View object, allows you to create customizable views that allow you to display Outlook items as large or small icons, with labels.

Outlook provides several built-in views, and you can also create custom IconView objects. Use the Add(String, OlViewType, OlViewSaveOption) method of the Views collection to add a new IconView to a Folder object. Use the Standard property to determine if an existing IconView object is built-in or custom.

The IconView object supports several different view types, depending on the desired layout in which to display Outlook items. Use the IconViewType property to set the view type.

You can also configure how Outlook items appear within the IconView object. Use the IconPlacement property to determine how the icons for Outlook items are arranged within the view. Use the Filter property to determine which Outlook items to display in the view and the SortFields collection to specify the Outlook item properties by which Outlook items are sorted in the view.

The definition for each IconView object is stored in Extensible Markup Language (XML) format. Use the XML property to work with the XML definition for the IconView object.

Use the Apply() method to apply any changes made to the IconView object to the current view. Use the Save() method to persist any changes made to the IconView object. Use the LockUserChanges property to allow or prevent changes to the user interface for the view.

You can change built-in IconView objects, but you cannot delete them. Use the Delete() method to delete a custom IconView object. Use the Reset() method to reset the properties of a built-in IconView object to their default values.


Application Application Application

Returns an Application object that represents the parent Outlook application for the object. Read-only.

(Inherited from _IconView)

Class Class Class

Returns an OlObjectClass constant indicating the object's class. Read-only.

(Inherited from _IconView)

Filter Filter Filter

Returns or sets a String (string in C#) value that represents the filter for a view. Read/write.

(Inherited from _IconView)

IconPlacement IconPlacement IconPlacement

Returns or sets an OlIconViewPlacement value that determines how icons are placed within the IconView object. Read/write

(Inherited from _IconView)

IconViewType IconViewType IconViewType

Returns or sets an OlIconViewType constant that determines how Outlook items are displayed in the IconView object. Read/write.

(Inherited from _IconView)

Language Language Language

Returns or sets a String (string in C#) value that represents the language setting for the view. Read/write.

(Inherited from _IconView)

LockUserChanges LockUserChanges LockUserChanges

Returns or sets a Boolean (bool in C#) value that indicates whether a user can modify the settings of the current view. Read/write.

(Inherited from _IconView)

Name Name Name

Returns or sets a String (string in C#) value that represents the display name for the object. Read/write.

(Inherited from _IconView)

Parent Parent Parent

Returns the parent Object of the specified object. Read-only.

(Inherited from _IconView)

SaveOption SaveOption SaveOption

Returns an OlViewSaveOption constant that specifies the folders in which the specified view is available and the read permissions attached to the view. Read-only.

(Inherited from _IconView)

Session Session Session

Returns the NameSpace object for the current session. Read-only.

(Inherited from _IconView)

SortFields SortFields SortFields

Returns an OrderFields object that represents the set of fields by which the items displayed in the IconView object are ordered. Read-only.

(Inherited from _IconView)

Standard Standard Standard

Returns a Boolean (bool in C#) value that indicates whether the IconView object is a built-in Outlook view. Read-only.

(Inherited from _IconView)

ViewType ViewType ViewType

Returns an OlViewType constant that indicates the view type of the view. Read-only.

(Inherited from _IconView)


Returns or sets a String (string in C#) value that specifies the XML definition of the view. Read/write.

(Inherited from _IconView)


Apply() Apply() Apply()

Applies the IconView object to the current view.

(Inherited from _IconView)

Copy(String, OlViewSaveOption) Copy(String, OlViewSaveOption) Copy(String, OlViewSaveOption)

Creates a new View object based on the existing IconView object.

(Inherited from _IconView)

Delete() Delete() Delete()

Deletes an object from a collection.

(Inherited from _IconView)

GoToDate(DateTime) GoToDate(DateTime) GoToDate(DateTime)

Changes the date used by the current view to display information.

(Inherited from _IconView)

Reset() Reset() Reset()

Resets a built-in Microsoft Outlook view to its original settings.

(Inherited from _IconView)

Save() Save() Save()

Saves the view, or saves the changes to a view.

(Inherited from _IconView)

Applies to