Edit

Share via


TableView Interface

Definition

Represents a view that displays Outlook items in a table, with each item in a row and the details of the item in the columns.

public interface class TableView : Microsoft::Office::Interop::Outlook::_TableView
[System.Runtime.InteropServices.Guid("00063096-0000-0000-C000-000000000046")]
public interface TableView : Microsoft.Office.Interop.Outlook._TableView
Public Interface TableView
Implements _TableView
Derived
Attributes
Implements

Remarks

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 _TableView.

The TableView object, derived from the View object, allows you to create customizable views that allow you to display Outlook items in a table.

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

You can configure the appearance and functionality of the TableView object. Use the AutomaticColumnSizing property to determine whether the view automatically resizes columns and the AutomaticGrouping property to determine if the view automatically groups Outlook items. Use the AutoPreview property to determine whether preview information is displayed within the row for an Outlook item in the view, and the AutoPreviewFont property to specify the font used to display preview information. Use the MultiLine property to determine whether to show Outlook items in multiline mode.

You can also configure how Outlook items appear within the TableView object. Use the ColumnFont property to specify the font used for column headers and the RowFont property to specify the font used for Outlook items in the view. Use the AllowInCellEditing property to allow editing of Outlook item property values in the view. Use the Filter property to determine which Outlook items to display in the view and the ViewFields collection to specify the Outlook item properties to display for each Outlook item. Use the GroupByFields to specify the Outlook item properties by which Outlook items are grouped, and the SortFields collection to specify the Outlook item properties by which Outlook items are sorted in the view.

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

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

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

Properties

AllowInCellEditing

Returns or sets a Boolean (bool in C#) value that determines whether in-cell editing is allowed in the TableView object. Read/write.

(Inherited from _TableView)
AlwaysExpandConversation

Returns or sets a Boolean (bool in C#) value that indicates whether conversations are always fully expanded in the table view. Read/write.

(Inherited from _TableView)
Application

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

(Inherited from _TableView)
AutoFormatRules

Returns an AutoFormatRules object that represents the set of formatting rules applicable to the TableView object. Read-only.

(Inherited from _TableView)
AutomaticColumnSizing

Returns or sets a Boolean (bool in C#) value that indicates whether the columns in the TableView object are automatically sized by Outlook. Read/write.

(Inherited from _TableView)
AutomaticGrouping

Returns or sets a Boolean (bool in C#) value that indicates whether the automatic grouping is active in the TableView object. Read/write.

(Inherited from _TableView)
AutoPreview

Returns or sets an OlAutoPreview constant that determines how items are automatically previewed by the TableView object. Read/write.

(Inherited from _TableView)
AutoPreviewFont

Returns a ViewFont object that represents the font used when automatically previewing Outlook items in the TableView object. Read-only.

(Inherited from _TableView)
Class

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

(Inherited from _TableView)
ColumnFont

Returns a ViewFont object that represents the font used when displaying column headers in the TableView object. Read-only.

(Inherited from _TableView)
DefaultExpandCollapseSetting

Returns or sets an OlDefaultExpandCollapseSetting constant that determines the default expansion setting for groups in the TableView object. Read/write.

(Inherited from _TableView)
Filter

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

(Inherited from _TableView)
GridLineStyle

Returns or sets an OlGridLineStyle constant that represents the line style used for grid lines in the TableView object. Read/write.

(Inherited from _TableView)
GroupByFields

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

(Inherited from _TableView)
HideReadingPaneHeaderInfo

Returns or sets a Boolean (bool in C#) value that determines whether the header for an Outlook item is displayed in the Reading Pane for the TableView object. Read/write.

(Inherited from _TableView)
Language

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

(Inherited from _TableView)
LockUserChanges

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

(Inherited from _TableView)
MaxLinesInMultiLineView

Returns or sets an Integer (int in C#) value that determines the maximum number of lines displayed in multiline mode for the TableView object. Read/write.

(Inherited from _TableView)
MultiLine

Returns or sets an OlMultiLine constant that determines how multiple lines are displayed in the TableView object. Read/write.

(Inherited from _TableView)
MultiLineWidth

Returns or sets an Integer (int in C#) value that represents the text width (in characters) needed to trigger multiline mode in the TableView object . Read/write

(Inherited from _TableView)
Name

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

(Inherited from _TableView)
Parent

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

(Inherited from _TableView)
RowFont

Returns a ViewFont object that represents the font used when displaying rows in the TableView object. Read-only.

(Inherited from _TableView)
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 _TableView)
Session

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

(Inherited from _TableView)
ShowConversationByDate

Returns or sets a Boolean (bool in C#) value that indicates whether items in a conversation are vertically left-aligned and ordered by the received date and time, with the most recent item on top. Read/write.

(Inherited from _TableView)
ShowConversationSendersAboveSubject

Returns or sets a Boolean (bool in C#) value that indicates whether the table view displays the participating senders above the subject line in the conversation header, or below it. Read/write.

(Inherited from _TableView)
ShowFullConversations

Returns or sets a Boolean (bool in C#) value that indicates whether to display conversation items from other folders, such as the Sent Items folder, as part of the conversation in the table view. Read/write.

(Inherited from _TableView)
ShowItemsInGroups

Returns or sets a Boolean (bool in C#) value that determines whether Outlook items are shown in groups within the TableView object. Read/write.

(Inherited from _TableView)
ShowNewItemRow

Returns or sets a Boolean (bool in C#) value that determines if the new item row is displayed in the TableView object. Read/write

(Inherited from _TableView)
ShowReadingPane

Returns or sets a Boolean (bool in C#) value that indicates whether the Reading Pane is displayed in the TableView object. Read/write.

(Inherited from _TableView)
ShowUnreadAndFlaggedMessages

This object, member, or enumeration is deprecated and is not intended to be used in your code.

(Inherited from _TableView)
SortFields

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

(Inherited from _TableView)
Standard

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

(Inherited from _TableView)
ViewFields

Returns a ViewFields object that represents the set of fields with which Outlook items are displayed in the TableView object. Read-only.

(Inherited from _TableView)
ViewType

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

(Inherited from _TableView)
XML

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

(Inherited from _TableView)

Methods

Apply()

Applies the TableView object to the current view.

(Inherited from _TableView)
Copy(String, OlViewSaveOption)

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

(Inherited from _TableView)
Delete()

Deletes an object from a collection.

(Inherited from _TableView)
GetTable()

Returns a Table object that represents all of the Microsoft Outlook items that are contained in a TableViewobject.

(Inherited from _TableView)
GoToDate(DateTime)

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

(Inherited from _TableView)
Reset()

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

(Inherited from _TableView)
Save()

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

(Inherited from _TableView)

Applies to