ShellListView Properties

Gets the ImageList that is currently used.

Use this property to turn on or off drag support with the Windows Explorer.

Use this property to turn on or off drop support with the Windows Explorer.

Set this property to true if you like the component to be refreshed automatically if a Drive is added or removed. This property is directly connected to the Enabled property of an internal instance of ShellChangeNotifier.

Indicates whether automatic refresh is enabled or not.

The delay in milliseconds after that the control scrolls automatically during a drag and drop operation. A value of 0 disables the auto scroll feature.

Adjust the size of the given column so that it fills the remaining horizontal space.

Gets or sets the ContextMenuStrip that is displayed if no item of the listview is under the cursor if the user clicks the right mouse button. If this value is null, no ContextMenu is shown.

Use this property to turn on or off the checkboxes for file and folder selection. The checkboxes will only work, if a ShellControlConnector has been assigned to the ShellControlConnector property of this component. It will automatically synchronize the selection state of the items in multiple shell controls linked together with this ShellControlConnector.

Use this property to display checkboxes for the control.

Refer to the SelectionList property to determine which items are selected. Please do not use this property, it is currently not supported. The CheckBoxes in an ordinary ListView do not support the grayed CheckState furthermore the ListView does not support them at all in View TileView.

true if m_SelectedFiles should contain whole paths instead of files only.

Gets the collection of all column headers that appear in the control.

Gets or sets the ToolStripRenderMode of the BackgroundContextMenu and the HeaderContextMenu.

The ContextMenuStrip is converted to an ordinary ContextMenu. This makes it possible to merge your ContextMenuStrip with the Default ShellContextMenu provided by the system. The "Opening" and "Closing" events of the ContextMenuStrip will be raised if the ContextMenu "Popup"/"Collapse" event occurs. For menu items only the "Click" event is available. All other events are not available. All ToolStripMenuItems are converted, and ToolStripSeparators are recognized. The ShortCut Keys defined in a ToolStripMenuItem are not converted. If you would like to have the ShortCut-Keys, leave this Property null, instead set the ContextMenu property to your menu explicitly.

Copy mode allows you to control the behaviour when files or folders get dropped.

Overwriting the CreateParams property to set the WS_VISIBLE flag; bug #8960

Gets a value indicating whether the design mode.

Local variable to detect whether the mouse is clicked or dragged

Local variable to detect whether the mouse is clicked or dragged

During a drag and drop operation that origins in this control this member contains the IDataObject. Filled in the ItemDrag method of the control.

Indicates that a DragLeave was executed recently; bug #6536

Gets or sets the item on that a current drag and drop operation would be executed.

During a drag and drop operation this member contains the IDataObject that is dragged over the control. Filled in DragEnter.

In Thumbnail view, only load thumbnails that are already in the thumbnail cache for folders. Default value true will avoid potentially huge delays that are caused by live folder thumbnails reflecting the contents of the folder.

Specifies, whether filename are presented with file extensions or not. By default, this depends on the respective setting in Windows Explorer.

If FileSystemOnly is set to True, objects and virtual folders which do not have a file system path, will not be displayed. Exceptions are 'My Computer', 'Libraries' and 'Network'

You can use a single pattern, e.g. '*.doc' or concatenate several patterns using semicolons to separate them, e.g. '*.exe;*.com'.

Define a regular expression to filter the files that will be enumerated.

Sets the folder of the ShellListView.

The font used to display text in the control.

Gets or sets the ContextMenuStrip that will be shown if the user rightclicks on the headerbar. Get: If it's null, we generate a list of available columns.

Returns the area occupied by the ListView header.

Gets or sets a value indicating whether the selected item in the control remains highlighted when the control loses focus.

Internal attribute is used by classes deriving from JamBaseShellListView.

Gets the columns as JamShellColumnCollection.

Gets a value indicating whether this object is currently in edit-mode.

Gets a value indicating whether the component is initialized.

The value this property is true between the calls BeginInit() and EndInit() of the ISupportInitialize interface.

Returns a collection containing all ShellListItems in the ShellListView. Items are of type ShellListItem

Gets or sets a value indicating whether the label text of the list items can be edited.

Gets or sets an ImageList holding images that can be used as custom images in small viewstates.

Gets or sets a list of large images.

Indicates that the list changed after a DragLeave was executed; bug #6536

If set to true, the control will not fill automatically after it was created. The FullRefresh method must be called explicitly. Since filling shell control with the appropriate items is a costly operation, this property can be useful to prevent unnecessary refreshes of the control.

The number of system columns without the columns added by the user.

The value of the OwnerDraw property must always be true. This is why the Property is reimplemented here. The setting to false is ignored, and a debug message is shown.

Contains the files that were pasted during a Paste operation.

This property allows you to get or set the folder, which contents should be displayed. If you want to display a non file system folder, use the SpecialFolder property.

If true, the folder actions changing the contents of the folder are not allowed. E.g.: Adding, removing or renaming files via context menu, DragDrop, Copy/Paste.

This property provides access to a list of all files including their extension, which are currently selected in the ShellListView. Dependent on the user settings, the file names in the ListView may be displayed without extension, which makes it difficult to further process them when they are accessed only by the SelectedItems property. You can also use the SelectedFiles property to add files to the selection by using SelectedFiles.Add method.

Simple getter/setter for m_SelectedFiles, for use by deriving classes.

Gets the items that are selected in the control.

Gets or sets the shellbrowser instance.

Returns the reference to the ShellChangeNotifier that is associated with this instance.

Indicates whether the Windows ShellContextMenu should be shown or not.

Connects this control to a ShellControlConnector component, which allows to synchronize several shell controls.

Activates/deactivates the internal drag drop handling of the component.

If set, compressed files and folders will be shown in that particular Color, show normally otherwise (if null).

If set, encrypted files and folders will be shown in that particular color, show normally otherwise (if null).

If set to true, the context menu will be shown if a right click event occurs.

If set to true the ShellList component will show a MessageBox if an error occured, otherwise the errors will only be logged to the Debug output.

Obsolete: Use ViewState.ExtraLargeIcons instead.

If set to true, files will be shown in the control. If set to false, files will not be visible in the control.

The property ShowFolders allows you to include the folders in the ShellListView, similar to FrontPage 2000.

Is set to 'true', hidden elements will also be shown.

Whether to show the informational shell tooltips, the default is true

If set to 'false', the Network Neighbourhood is not shown in the component, otherwise it is shown (the default value is true).

If set to 'false', no overlay icons will be shown, which improves the performance of the control.

Use this property to show an additional folder with the caption '..' that allows the user to navigate to the parent folder of the current folder.

If set to true, the recycle bin will be visible. If set to false, the recycle bin will be hidden (the default value is true).

If set to to 'true', the shell context menu will be shown on top of the provided popup menu. If set to 'false', the shell context menu will be shown below the provided popup menu. The value true is currently not supported. The menu items will be shown correctly, however their Click event cannot be triggered.

Gets or sets an ImageList holding images that can be used as custom images in small viewstates.

Gets or sets a list of small images.

The column according to which the listed objects are sorted. If this is set to a negative value, sorting is disabled by setting SortOrder to SortOrder.None, this is useful to insert large amounts of items, e.g. during a search.

Gets or sets the current sort order.

Gets or sets the sort order for items in the control.

SpecialFolder allows you to set or get the type of the currently listed folder. You can use the ShellFolder constants here.

Get or set the color of the frame that is drawn around the thumbnails. If this value is set to null, no frame will be shown.

Gets or sets preferences whether to display file icons or thumbnails in the list.

Obsolete: Use ViewState.Thumbnails instead.

Use the ThumbnailSize property to get or set the size in pixels of the thumbnail images.

Returns an array of the currently used ShColumnIds.

If true, the slow tooltip that contains additional information like the folder size is used. Setting this value to false increases the performance.

Set this property to true if you want the component to utilize the default system font. It is also set to true if the UseSystemStyles property is set.

Use this property to turn on or off the usage of the system specific design, i.e. enable Vista visual styles of the explorer components.

Whether to use the system threadpool to obtain information on listview items. If this property is false, the complete file detail information is retrieved as soon as the item is displayed the first time within the listview. If the property is true thumbnails and icons are fetched in worker threads in the background. The setting of this property affects the control the next time the FullRefresh method is called.

The current version of the ShellBrowser.

Gets or sets the vertical scroll position.

Overrides the ListView.View property. Use ViewState instead.

Gets or sets how items are displayed in the ShellListView control.

Not supported.

Not supported.