ImageBox and TabList update's - virtual mode, pixel grid, bug fixes and more!

csharp winforms imagebox tablist

Our last post before the new year and some new material is an update to the ImageBox (now at version 1.1.2.0) and TabList (at version 1.0.0.2) controls. You can grab the updated source from the links at the end of the post, or from the GitHub page.

ImageBox

Virtual mode allows you to use the ImageBox control without a backing image
Virtual mode allows you to use the ImageBox control without a backing image
The pixel grid allows you to show a grid when zoomed in
The pixel grid allows you to show a grid when zoomed in

Changes and new features

  • Added IsPointInImage method. This function returns if a given point is within the image viewport, and is useful for combining with PointToImage.
  • Added ImageBorderColor property, allowing you to customize the color of the image border
  • Added a new ImageBoxBorderStyle, FixedSingleGlowShadow. This style allows for a more smoother outer glow shadow instead of the existing clunky drop shadow.
  • Added ShowPixelGrid and PixelGridColor properties. When set, a dotted grid is displayed around pixels when zooming in on an image.
  • Added new overload to PointToImage which allows you to specify if the function should map the given point to the nearest available edge(s) if the point is outside the image boundaries
  • Added AllowDoubleClick property. When set, the normal double click events and overrides work as expected.
  • Added VirtualMode and VirtualSize properties. These new properties allow you to use all functionality of the ImageBox control without having to set the Image property. You can also use the new VirtualDraw event to provide custom drawing without having to override existing drawing functionality.
  • Additional documentation added via XML comments

Fixed

  • If the GridDisplayMode property is set to Image an explicit image border is no longer drawn, instead the ImageBorder property is correctly honoured.
  • Fixes a problem where half the pixels of the first row/column were lost when zooming. Thanks to Rotem for the fix.
  • The GetImageViewport method now correctly returns a width and height that accounts for control size, padding and zoom levels.
  • Fixed incorrect attributes on AutoSize property
  • Fixed the image viewport sometimes being the incorrect size when zoomed in. Thanks to WMJ for the fix.
  • Fixes "see also" documentation errors for events

TabList

Changes and new features

  • Added ShowTabList property. When set to False, the list of tabs is no longer displayed, and navigation can only occur via code.
  • Added AllowTabSelection property. When set to False, the control can no longer gain focus, mouse hover effects are not displayed, and navigation can only occur via code. This allows you to disable navigation whilst still having the tabs visible.

Fixed

  • Fixed the HoverIndex property always defaulting to zero.

Happy New Year all!

Update History

  • 2012-12-31 - First published
  • 2020-11-21 - Updated formatting

Like what you're reading? Perhaps you like to buy us a coffee?

Donate via Buy Me a Coffee

Donate via PayPal

Files

Manually writing the byte order mark (BOM) for an encoding into a stream
Creating a custom ErrorProvider component for use with Windows Forms applications

Comments

# Ferry

Hi, i've been trying out the imagebox for a project of mine. i've done the entire 'tutorial' and everything worked properly till part 5. But because i wanted to remove the 'flicker' i really want to use the latest version. only in this version for some reason the imagebox doesnt refresh when panning like it did before. It seems to only update(repaint) when you stop moving the mouse. I want the image to move with the mouse, not just update when done. I hope you have any idea why this doesn't work like that in this newest version.

I'm using the virtual mode and i draw a small list of images in the viewport.

Reply

# Richard Moss

Hello,

Thanks for the comment. I have a pending update with a fix for drag and drop, I'll take a look at this issue as well and fix it.

Thanks; Richard Moss

Reply

# Mario Muja

Thanks a lot for your efforts. The selection region looks very nice. For my current project, I need multiple selection regions within the same image (enable the user to click into selection regions within the image to "activate" the region and allow to change the size of the region). I can implement the management of multiple selection regions for the same image - do you see an easier solution using your libraries?

Reply

# Richard Moss

Thanks for your interest! The last update to the control (http://www.cyotek.com/blog/adding-drag-handles-to-an-imagebox-to-allow-resizing-of-selection-regions) includes a new demo control that allows you to move and resize the selection. I see no reason why you couldn't tinker this control to support multiple selections reasonably easily. Hmm, in fact that may be a good excuse for a new blog post on the subject (besides I have a bug fix to make to the new control anyway :))

Regards; Richard Moss

Reply

# CD

Does the nuget package add the imagebox control to the toolbox to be able to drag over to form or do I need to use the nuget package through code only? As the nuget package seems not to add it to the toolbox for me.

Reply

# Richard Moss

No, it doesn't add a toolbox item - this isn't something a NuGet package can do. And besides, it wouldn't be desirable behaviour either given that each solution will get a fresh copy of the package. You would need to either manually add it to the toolbox (which I wouldn't do) or create any control on your form, then open the .designer file and change it to be an ImageBox. Not ideal, but not too much of a hassle either.

Reply

# CD

Thanks. Just wanted to be sure I wasn't missing something. I am a noob to nuget.

Reply

# Richard Moss

You're welcome. Question comes up every so often, I should probably add some instructions somewhere on how to do it!

Regards; Richard Moss

Reply

# Konstantin Samsonov

Selection region in pixel mode not snap to pixel grid

Reply

# Richard Moss

Correct, it doesn't - it was never designed to.

Should be easy enough to add, fee free to submit a pull request.

Reply

# Jonathan

I'm trying to import an image into the imagebox and then draw a rectangle, but the virtual property mode in true takes it out to the image some solution so I can draw on the image?

Reply

# Richard Moss

Hello,

You don't need to use the virtual mode for this - just hook into the Paint event and draw your shapes in that. See the Scaled Adornments demonstration for an example.

Regards; Richard Moss

Reply

author
Richard Moss
Founder

The founder of Cyotek, Richard enjoys creating new blog content for the site. Much more though, he likes to develop programs, and can often found writing reams of code. A long term gamer, he has aspirations in one day creating an epic video game - but until that time comes, he is mostly content with adding new bugs to WebCopy and the other Cyotek products.

Related Articles

View All Articles
article
csharp winforms imagebox tiff sample

Displaying multi-page tiff files using the ImageBox control and C#

A brief article showing how to display individual pages from a multi-page tiff file in the ImageBox control.

avatar
Richard Moss
article
csharp winforms imagebox drag resize

Adding drag handles to an ImageBox to allow resizing of selection regions

The `ImageBox` control is already a versatile little control and I use it for all sorts of tasks. One of the features I recently wanted was to allow users to be able to select a source region, then adjust this as needed. The control already allows you to draw a selection region, but if you need to adjust that ... well, you can't. You can only draw a new region. This article describes how to extend the `ImageBox` to include the ability to resize the selection region. A older demonstration which shows how to drag the selection around has also been incorporated, in a more tidy fashion than the demo.

avatar
Richard Moss
article
csharp imagebox

ImageBox 1.1.4.0 update

Update 1.1.4.0 of the ImageBox control is now available, with a large number of new features and bug fixes.

avatar
Richard Moss
article
csharp winforms imagebox tablist

ImageBox and TabList update's - virtual mode, pixel grid, bug fixes and more!

Update 1.1.2.0 of the ImageBox control is now available, with a variety of new features and bug fixes.

avatar
Richard Moss
article
csharp winforms zoom imagebox scrollablecontrol

ImageBox update, version 1.1.0.0

Overview of an update to the ImageBox control

avatar
Richard Moss
article
csharp zoom imagebox scrollablecontrol

Zooming to fit a region in a ScrollableControl

An article which describes how to adjust the zoom and view port in a ScrollableControl to match a specified rectangle.

avatar
Richard Moss
article
csharp zoom imagebox scrollablecontrol

Zooming into a fixed point on a ScrollableControl

An article which describes how to zoom into a fixed point in a ScrollableControl, keeping a given point in the same position after the zoom.

avatar
Richard Moss
article
csharp winforms graphics imagebox select rectangle

Creating an image viewer in C# Part 5: Selecting part of an image

This article describes adding new functionality to the ImageBox control to allow selecting portions of the current image.

avatar
Richard Moss
article
csharp winforms image imagebox pdf ghostscript convert

Extending the ImageBox component to display the contents of a PDF file using C#

Article describing how to extend the ImageBox control to support displaying PDF files using the GhostScript API, removing the need for a dedicated PDF reader.

avatar
Richard Moss
article
csharp winforms scroll zoom image graphics pan imagebox

Creating a scrollable and zoomable image viewer in C# Part 4

Fourth and final in a multi part series on creating an image viewer that can be scrolled and zoomed in C#. After part three added panning, we now add zoom support via the mouse wheel and clicking with the left or right buttons, along with some additional display properties.

avatar
Richard Moss
article
csharp winforms scroll zoom check image imagebox

Creating a scrollable and zoomable image viewer in C# Part 3

Third in a multi part series on creating an image viewer that can be scrolled and zoomed in C#. After part two added scrolling support, we now extend this to support panning and keyboard scrolling.

avatar
Richard Moss
article
csharp winforms scroll zoom check image imagebox

Creating a scrollable and zoomable image viewer in C# Part 2

Second in a multi part series on creating an image viewer that can be scrolled and zoomed in C#. After part one created the initial component with auto resize, we now add scrolling support.

avatar
Richard Moss
article
csharp winforms scroll zoom check image imagebox

Creating a scrollable and zoomable image viewer in C# Part 1

First in a multi part series on creating an image viewer that can be scrolled and zoomed in C#.

avatar
Richard Moss