BaseGallery Members

Represents a base class for galleries.

Constructors

Name Description
BaseGallery() Initializes a new instance of the BaseGallery class with the default settings.

Properties

Name Description
AllowAllUp Gets or sets whether or not all gallery items can simultaneously be in a normal (elevated) state.
AllowGlyphSkinning Gets or sets whether items within this gallery should colorize their icons using foreground colors.
AllowHoverAnimation static Gets or sets whether or not hovering over gallery items is accompanied with animation effects.
AllowHoverImages Gets or sets whether the hover images feature is enabled.
AllowHtmlText Gets or sets whether captions for items and groups in this gallery can be formatted using HTML tags.
AllowItemDrag Gets or sets whether gallery items can be dragged-and-dropped.
AllowMarqueeSelection Gets or sets whether the marquee selection feature is enabled, which allows gallery items to be selected by dragging over items with the mouse.
Appearance Gets the appearances that are used to paint gallery elements.
CanAnimate This member supports the internal infrastructure, and is not intended to be used directly from your code.
CanRaiseEvents protected Gets a value indicating whether the component can raise an event. Inherited from Component.
CheckDrawMode Gets or sets how gallery items are painted when in the checked state.
CheckSelectedItemViaKeyboard Gets or sets whether the gallery item currently selected via the keyboard should be immediately checked.
ClearSelectionOnClickEmptySpace Gets or sets whether the current selection is cleared when clicking the empty space.
ColumnCount Gets or sets the (maximum) number of columns in the gallery.
Container Gets the IContainer that contains the Component. Inherited from Component.
DesignMode protected Gets a value that indicates whether the Component is currently in design mode. Inherited from Component.
DistanceBetweenItems Gets or sets the distance between Gallery items.
DistanceItemCaptionToDescription Gets or sets the distance between an item's caption and its description.
DistanceItemImageToText Gets or sets the distance between an item's image and its text.
DrawImageBackground Gets or sets whether the background of the Gallery item's image is displayed.
Events protected Gets the list of event handlers that are attached to this Component. Inherited from Component.
FirstItemVertAlignment Gets or sets the first gallery item's vertical position beyond which this item cannot be moved when scrolling backwards. (When the gallery is horizontally oriented (see GalleryControlGallery.Orientation), the FirstItemVertAlignment property defines the first item's horizontal position.
FirstItemVertIndent Gets or sets a custom indent of the first gallery item from the gallery's top or left edge (depending on the gallery's orientation). The property is in effect when BaseGallery.FirstItemVertAlignment is set to Custom.
FixedHoverImageSize Gets or sets whether hover images are displayed with the same size.
FixedImageSize Gets or sets whether gallery item images have the same display size, as specified by the BaseGallery.ImageSize property.
FocusedItem Gets a currently focused GalleryItem in this gallery.
GroupContentMargin Gets or sets margins of a gallery group's content.
Groups Gets a collection of groups owned by the gallery.
HoverImages Gets or sets the source of hover images.
HoverImageSize Gets or sets the size of hover images.
Images Gets or sets the source of images that can be displayed within gallery items.
ImageSize Gets or sets the display size of gallery item images.
ItemAutoSizeMode Gets or sets the auto-size mode of gallery items.
ItemCheckMode Gets or sets whether item checking (selection) is enabled, and how the items can be checked (selected).
ItemClickFireMode Gets or sets whether clicks on gallery items are handled synchronously or asynchronously.
ItemImageLayout Gets or sets how a gallery item's image is displayed within the item's image area.
ItemImageLocation Gets or sets the location of images within gallery items, relative to the items' text.
ItemImagePadding Gets or sets the amount of space, in pixels, between the Gallery item's image and its borders.
ItemSize Gets or sets the size of gallery items when item auto-sizing is disabled. The Width attribute is also in effect when the auto-height feature is enabled.
ItemTextPadding Gets or sets the amount of space, in pixels, between the Gallery item's text and its borders.
LastItemVertAlignment Gets or sets the last gallery item's vertical position, beyond which this item cannot be moved when scrolling forwards. (When the gallery is horizontally oriented (see GalleryControlGallery.Orientation), the LastItemVertAlignment property defines the last item's horizontal position.
LastItemVertIndent Gets or sets a custom indent of the last gallery item from the gallery's bottom or right edge (depending on the gallery's orientation). The property is in effect when BaseGallery.LastItemVertAlignment is set to Custom.
MaxItemWidth Gets or sets an item's maximum width in GalleryItemAutoSizeMode.Default auto-size mode.
OptionsImageLoad Provides access to the set of properties that manage image loading options for items in this gallery.
OwnerControl Gets a control that owns this BaseGallery.
RowCount Gets or sets the number of rows in a gallery when the gallery is displayed within a dropdown window.
ScaleImages Gets or sets whether gallery items are automatically stretched to match the current DPI settings of the user's monitor.
ScrollMode Gets or sets how the gallery is scrolled when the BaseGallery.ScrollTo method is called.
ScrollSpeed Gets or sets how fast the gallery is scrolled when calling the BaseGallery.ScrollTo method.
ShowGroupCaption Gets or sets whether group captions are displayed.
ShowItemImage Gets or sets whether Gallery items display their images.
ShowItemText Gets or sets whether Gallery items display their caption and description.
Site Gets or sets the ISite of the Component. Inherited from Component.
Tag Gets or sets an object that contains data on the current BaseGallery object.
UseMaxImageSize Gets or sets whether gallery item images have the same display size as the biggest image.

Methods

Name Description
AddAnimation(ImageLoadInfo) This member supports the internal infrastructure, and is not intended to be used directly from your code.
Assign(BaseGallery) Assigns all GalleryItems, displayed within the specific BaseGallery to the current BaseGallery.
BeginUpdate() Locks the BaseGallery, preventing visual updates of the object and its elements until the EndUpdate or CancelUpdate method is called.
CancelUpdate() Unlocks the BaseGallery object after it has been locked by the BeginUpdate method, without causing an immediate visual update.
CreateFrom(BaseGallery) Copies contents and settings from the specified gallery to the current gallery.
CreateObjRef(Type) Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. Inherited from MarshalByRefObject.
Destroy() Destroys gallery items and clears gallery group collection.
DestroyItems() Destroys gallery items that belong to the current gallery.
Dispose() Releases all resources used by the Component. Inherited from Component.
EndUpdate() Unlocks the BaseGallery object after a call to the BeginUpdate method and causes an immediate visual update.
Equals(Object) Determines whether the specified object is equal to the current object. Inherited from Object.
Equals(Object, Object) static Determines whether the specified object instances are considered equal. Inherited from Object.
ForceItemRefresh(ImageLoadInfo) This member supports the internal infrastructure, and is not intended to be used directly from your code.
GetAllItems() Returns a list containing all gallery items that belong to the current gallery.
GetAllowHoverAnimation() static Returns whether animation on hovering gallery items is actually enabled.
GetCheckedItem() Returns the checked (selected) gallery item (if only one item is selected).
GetCheckedItems() Returns a list containing the currently checked (selected) gallery items.
GetCheckedItemsCount() Returns the total number of currently checked gallery items.
GetHashCode() Serves as the default hash function. Inherited from Object.
GetItemByCaption(String) Returns an item that has the specified caption.
GetItemByValue(Object) Gets a GalleryItem that matches the specific value.
GetLifetimeService() Retrieves the current lifetime service object that controls the lifetime policy for this instance. Inherited from MarshalByRefObject.
GetService(Type) protected Returns an object that represents a service provided by the Component or by its Container. Inherited from Component.
GetType() Gets the Type of the current instance. Inherited from Object.
GetVisibleItems() Returns a list containing visible gallery items.
InitializeLifetimeService() Obtains a lifetime service object to control the lifetime policy for this instance. Inherited from MarshalByRefObject.
Invalidate() Invalidates the region which is occupied by the gallery.
Invalidate(GalleryItem) Invalidates the region which is occupied by the specified Gallery item.
Invalidate(Rectangle) Invaldates the specified region of the current BaseGallery object.
LayoutChanged() Recalculates all the graphical information of the gallery.
MakeVisible(GalleryItem) Makes the specified gallery item visible onscreen, if it's hidden due to scrolling.
MemberwiseClone() protected Creates a shallow copy of the current Object. Inherited from Object.
MemberwiseClone(Boolean) protected Creates a shallow copy of the current MarshalByRefObject object. Inherited from MarshalByRefObject.
RaiseGetLoadingImage(GetLoadingImageEventArgs) Raises the BaseGallery.GetLoadingImage event with specific arguments.
RaiseGetThumbnailImage(ThumbnailImageEventArgs) Raises the BaseGallery.GetThumbnailImage event with specific arguments.
ReferenceEquals(Object, Object) static Determines whether the specified Object instances are the same instance. Inherited from Object.
RefreshGallery() Recalculates all the graphical information of the gallery.
ScrollTo(GalleryItem, Boolean) Scrolls the gallery (with or without an animation effect) making the specified item visible.
ScrollTo(GalleryItem, Boolean, VertAlignment) Scrolls the gallery (with or without an animation effect) making the specified gallery item visible at a specific position.
ScrollTo(GalleryItemGroup, Boolean) Scrolls the gallery (with or without an animation effect) making the specified gallery group visible.
ScrollTo(GalleryItemGroup, Boolean, VertAlignment) Scrolls the gallery (with or without an animation effect) making the specified gallery group visible at a specific position.
SetItemCheck(GalleryItem, Boolean) Checks or unchecks the specified item. If multiple item checking is enabled and the CTRL or SHIFT key is currently pressed, the SetItemCheck method doesn't uncheck the previously checked items. Otherwise, these items are unchecked.
SetItemCheck(GalleryItem, Boolean, Boolean) Checks or unchecks the specified item, while allowing you to specify whether the previously checked items should be unchecked.
ToString() Returns a String containing the name of the Component, if any. This method should not be overridden. Inherited from Component.

Events

Name Description
CustomDrawEmptyBackground
CustomDrawItemImage Enables the Gallery item's image to be painted manually.
CustomDrawItemText Enables the Gallery item's text to be painted manually.
Disposed Occurs when the component is disposed by a call to the Dispose() method. Inherited from Component.
EndScroll Fires after gallery scrolling stops.
FilterMenuItemClick Fires when a standard item of a gallery's Group Filter menu is clicked.
FilterMenuPopup Fires when an end-user invokes the Group Filter menu.
GalleryItemHover Fires when the mouse pointer hovers over a Gallery item.
GalleryItemLeave Fires when the mouse pointer leaves a Gallery item.
GetLoadingImage Allows you to set the custom loading indicator.
GetThumbnailImage Occurs each time the gallery needs to display an item whose image is loaded asynchronously.
ItemCheckedChanged Fires whenever an item's check (selected) state is changed.
ItemClick Fires when a Gallery item is clicked.
ItemDoubleClick Fires after a gallery item has been double-clicked.
MarqueeSelectionCompleted Fires when a user has finished selecting gallery items using marquee selection.
See Also