原创企业级控件库之图片浏览控件

原创企业级控件库之图片浏览控件

发布日期：2010年12月18日星期六作者:EricHu

　　在上两篇：我介绍了原创企业级控件库之组合查询控件和原创企业级控件库之大数据量分页控件，受到了很多朋友的支持，给了我很大的动力，在此我特表感谢。有的朋友要求把源码提供上来，我在第一篇就讲了，源码会在我这个系列讲完之后提供，大家先别着急，如果你确实需要，可以时常关注此系列，谢谢大家。其实，在系列文章中，我已把核心代码贡献出来了。学习有时是参考别人与实践别人的劳动成果的过程，你光把别人的代码拿过来用用，不研究其实质，进步很慢。

这篇我将给大家介绍：企业级控件库之图片浏览控件。

　　摘要

　　我想大家用过或听说过ACDSee 对于图片浏览的强大功能，我接下来介绍的控件与ACDSee相比，可谓是天壤之别，虽没有其强大的功能，但用在一些常用的软件上，提供一些常用的基本功能还是可以的。同时，我只提供一个模子，代码开源，你可以随便修改以满足自己的需要。

　　成就别人、等于成就自己。我没什么要求，欢迎大家多多支持与评论，觉得不错的，记得点击文章左下角的”关注博客”，就这么简单。同时，你要用什么好的想法，也可以与我交流，谢谢。

　　图片浏览控件运行效果如下图：

　　

　　本控件类图：

　　本控件类详细信息：

　　本控件核心代码:　

        #region 公共方法
        #region 增加图片到PictureBox:void AddImage(string fileName, bool isAsync)
        /// <summary>
        /// 增加要显示的图片
        /// </summary>
        /// <param name="fileName">图片路径全名</param>
        /// <param name="isAsync">true:异步方式加载图片</param>
        public void AddImage(string fileName, bool isAsync)
        {
            if (isAsync)//异步加载图片
            {
                //图片异步加载完成后的处理事件
                picView.LoadCompleted += new AsyncCompletedEventHandler(picView_LoadCompleted);
                //图片加裁时，显示等待光标
                picView.UseWaitCursor = true;
                //采用异步加裁方式
                picView.WaitOnLoad = false;
                //开始异步加裁图片
                picView.LoadAsync(fileName);
            }
            else
            {
                picView.Image = Image.FromFile(fileName);//载入图片
            }
            InitialImage();
           
        }
        /// <summary>
        /// 增加要显示的图片
        /// </summary>
        /// <param name="img">Image</param>
        public void AddImage(Image img)
        {
            if (img != null)
            {
                picView.Image = img;
                InitialImage();
            }
            else
            {
                picView = null;
            }
        }
        #endregion
        #region 得到ImageView中的图片:Image GetImageInImageView()
        /// <summary>
        /// 得到ImageView中的图片
        /// </summary>
        /// <returns>Image</returns>
        public Image GetImageInImageView()
        {
            if (picView.Image != null)
            {
                return picView.Image;
            }
            else
            {
                return null;
            }
        }
        #endregion
        #region 放大、缩小、适应图片大小、移动图片、左旋转图片与右旋转图片
        /// <summary>
        /// 放大图片
        /// </summary>
        public void ZoomInImage()
        {
            if (picView.Image != null)
            {
                if (picView.Width < 5000)
                {
                    zoom(picView.Location, 1100);
                    CenterImage();
                }
                else
                {
                    MessageBox.Show("对不起，不能再进行放大!","提示信息",MessageBoxButtons.OK,MessageBoxIcon.Information);
                }
            }
        }
        
        /// <summary>
        /// 缩小图片
        /// </summary>
        public void ZoomOutImage()
        {
            if (picView.Image != null)
            {
                if (picView.Image.Width / picView.Width < 5 && -7 < 0)
                {
                    zoom(picView.Location, 900);
                    CenterImage();
                }
                else
                {
                    MessageBox.Show("对不起，不能再进行缩小!", "提示信息", MessageBoxButtons.OK, MessageBoxIcon.Information);
                }
            }
        }
        /// <summary>
        /// 适应图片大小
        /// </summary>
        public void FitImageSize()
        {
            if (picView.Image != null)
            {
                float r1 = (float)this.w / this.picView.Width;
                float r2 = (float)this.h / this.picView.Height;
                this.picView.Scale(r1, r2);
                this.picView.Left = (this.PnlMain.Width - this.picView.Width) / 2;
                this.picView.Top = (this.PnlMain.Height - this.picView.Height) / 2;
                this.picView.Cursor = Cursors.Default;
                CenterImage();
            }
        }
        /// <summary>
        /// 移动图片
        /// </summary>
        public void MoveImage()
        {
            mnuMy.Checked = MnuMoveImageChecked;
        }
        /// <summary>
        /// 左旋转图片
        /// </summary>
        public void LeftRotateImage()
        {
            if (picView.Image != null)
            {
                picView.Image.RotateFlip(RotateFlipType.Rotate90FlipX);
                picView.Refresh();
                CenterImage();
            }
        }
        /// <summary>
        /// 右旋转图片
        /// </summary>
        public void RightRotateImage()
        {
            if (picView.Image != null)
            {
                picView.Image.RotateFlip(RotateFlipType.Rotate90FlipY);
                picView.Refresh();
                CenterImage();
            }
        }
        #endregion
        #endregion

　　下面给出整个控件的完整代码及窗体调用方法：

　　一、控件完整代码：

#region  版权信息
/*---------------------------------------------------------------------*
// Copyright (C) 2010 http://www.cnblogs.com/huyong
// 版权所有。 
// 项目  名称：《Winform通用控件库》
// 文  件  名： UcImageView.cs
// 类  全  名： DotNet.Controls.UcImageView 
// 描      述:  图像显示控件
// 创建  时间： 2010-08-05
// 创建人信息： [**** 姓名:胡勇 QQ:80368704 E-Mail:[e-mail] *****]
*----------------------------------------------------------------------*/
#endregion
using System;
using System.ComponentModel;
using System.Drawing;
using System.Windows.Forms;
using System.Drawing.Printing;
using DotNet.Common;
namespace DotNet.Controls
{
    /// <summary>
    /// 图像显示控件
    /// UcImageView
    /// 
    /// 修改纪录
    ///     2010-11-6  胡勇 优化相关代码。
    ///     2010-8-5   胡勇 创建图像显示控件
    ///     
    /// <author>
    ///     <name>胡勇</name>
    ///     <QQ>80368704</QQ>
    ///     <Email>[e-mail]</Email>
    /// </author>
    /// </summary>
    public partial class UcImageView : UserControl
    {
        #region 构造函数
        public UcImageView()
        {
            InitializeComponent();
            //记录PnlMain的size
            panelOldSize.X = PnlMain.Width;
            panelOldSize.Y = PnlMain.Height;
        }
        #endregion
        #region 公共变量
        private Point StartP = new Point(0, 0);
        private bool isMouseDown = false;
        private Point panelOldSize = new Point(0, 0);
        private int imgIndexBy1000 = 0;
        private int keyAction = 0;
        private int w, h;
        #endregion
        #region 公共事件
        [Category("图片浏览"), Description("移动或漫游图片的Checked事件Changed时发生。"), Browsable(true)]
        public event EventHandler OnMnuMoveImageCheckedChanged;
        #endregion
        #region 公共方法
        #region 增加图片到PictureBox:void AddImage(string fileName, bool isAsync)
        /// <summary>
        /// 增加要显示的图片
        /// </summary>
        /// <param name="fileName">图片路径全名</param>
        /// <param name="isAsync">true:异步方式加载图片</param>
        public void AddImage(string fileName, bool isAsync)
        {
            if (isAsync)//异步加载图片
            {
                //图片异步加载完成后的处理事件
                picView.LoadCompleted += new AsyncCompletedEventHandler(picView_LoadCompleted);
                //图片加裁时，显示等待光标
                picView.UseWaitCursor = true;
                //采用异步加裁方式
                picView.WaitOnLoad = false;
                //开始异步加裁图片
                picView.LoadAsync(fileName);
            }
            else
            {
                picView.Image = Image.FromFile(fileName);//载入图片
            }
            InitialImage();
           
        }
        /// <summary>
        /// 增加要显示的图片
        /// </summary>
        /// <param name="img">Image</param>
        public void AddImage(Image img)
        {
            if (img != null)
            {
                picView.Image = img;
                InitialImage();
            }
            else
            {
                picView = null;
            }
        }
        #endregion
        #region 得到ImageView中的图片:Image GetImageInImageView()
        /// <summary>
        /// 得到ImageView中的图片
        /// </summary>
        /// <returns>Image</returns>
        public Image GetImageInImageView()
        {
            if (picView.Image != null)
            {
                return picView.Image;
            }
            else
            {
                return null;
            }
        }
        #endregion
        #region 放大、缩小、适应图片大小、移动图片、左旋转图片与右旋转图片
        /// <summary>
        /// 放大图片
        /// </summary>
        public void ZoomInImage()
        {
            if (picView.Image != null)
            {
                if (picView.Width < 5000)
                {
                    zoom(picView.Location, 1100);
                    CenterImage();
                }
                else
                {
                    MessageBox.Show("对不起，不能再进行放大!","提示信息",MessageBoxButtons.OK,MessageBoxIcon.Information);
                }
            }
        }
        
        /// <summary>
        /// 缩小图片
        /// </summary>
        public void ZoomOutImage()
        {
            if (picView.Image != null)
            {
                if (picView.Image.Width / picView.Width < 5 && -7 < 0)
                {
                    zoom(picView.Location, 900);
                    CenterImage();
                }
                else
                {
                    MessageBox.Show("对不起，不能再进行缩小!", "提示信息", MessageBoxButtons.OK, MessageBoxIcon.Information);
                }
            }
        }
        /// <summary>
        /// 适应图片大小
        /// </summary>
        public void FitImageSize()
        {
            if (picView.Image != null)
            {
                float r1 = (float)this.w / this.picView.Width;
                float r2 = (float)this.h / this.picView.Height;
                this.picView.Scale(r1, r2);
                this.picView.Left = (this.PnlMain.Width - this.picView.Width) / 2;
                this.picView.Top = (this.PnlMain.Height - this.picView.Height) / 2;
                this.picView.Cursor = Cursors.Default;
                CenterImage();
            }
        }
        /// <summary>
        /// 移动图片
        /// </summary>
        public void MoveImage()
        {
            mnuMy.Checked = MnuMoveImageChecked;
        }
        /// <summary>
        /// 左旋转图片
        /// </summary>
        public void LeftRotateImage()
        {
            if (picView.Image != null)
            {
                picView.Image.RotateFlip(RotateFlipType.Rotate90FlipX);
                picView.Refresh();
                CenterImage();
            }
        }
        /// <summary>
        /// 右旋转图片
        /// </summary>
        public void RightRotateImage()
        {
            if (picView.Image != null)
            {
                picView.Image.RotateFlip(RotateFlipType.Rotate90FlipY);
                picView.Refresh();
                CenterImage();
            }
        }
        #endregion
        #endregion
        #region 公共属性
        private bool _mnuMoveImageChecked;
        /// <summary>
        /// 确定漫游菜单项是否处于选中状态(用于是否可以移动或漫游图片)
        /// </summary>
        [Category("图片浏览"), Description("确定漫游菜单项是否处于选中状态(用于是否可以移动或漫游图片)"),Browsable(false)]
        public bool MnuMoveImageChecked
        {
            get
            {
                return _mnuMoveImageChecked;
            }
            set
            {
                _mnuMoveImageChecked = value;
                this.mnuMy.Checked = _mnuMoveImageChecked;
            }
        }
        private bool _mnuPrintVisible = true; //默认可见
        /// <summary>
        /// 确定打印菜单项是可见还是隐藏
        /// </summary>
        [Category("图片浏览"), Description("确定打印菜单项是可见还是隐藏"), Browsable(true)]
        public bool MnuPrintVisible
        {
            get
            {
                return _mnuPrintVisible;
            }
            set
            {
                _mnuPrintVisible = value;
                this.mnuPrint.Visible = _mnuPrintVisible;
            }
        }
        #endregion
        #region 私有方法
        private void picView_LoadCompleted(object sender, AsyncCompletedEventArgs e)
        {
            //图片加载完成后，将光标恢复
            picView.UseWaitCursor = false;
        }
        #region 图片缩放
        /// <summary>
        /// 图片缩放
        /// </summary>
        /// <param name="center">缩放中心点</param>
        /// <param name="zoomIndexBy1000">缩放倍率的1000倍</param>
        private void zoom(Point center, int zoomIndexBy1000)
        {
            //记录原始的picView的Size
            Point oldSize = new Point(picView.Width, picView.Height);
            //实施放大（以x方向为基准计算得出y方向大小，防止多次运算误差积累使Image和picView的尺寸不匹配）
            picView.Width = picView.Width * zoomIndexBy1000 / 1000;
            picView.Height = picView.Width * imgIndexBy1000 / 1000;
            //重新定位标定后的picView位置
            picView.Left -= ((picView.Width - oldSize.X) * (center.X * 1000 / oldSize.X)) / 1000;
            picView.Top -= ((picView.Height - oldSize.Y) * (center.Y * 1000 / oldSize.Y)) / 1000;
            //重新设定横向滚动条最大值和位置
            if (picView.Width - PnlMain.Width > 0)
            {
                hScrollBarImageView.Visible = true;
                hScrollBarImageView.Maximum = picView.Width - PnlMain.Width + vScrollBarImageView.Width + 2;
                hScrollBarImageView.Value = (picView.Left >= 0 ? 0 : (-picView.Left > hScrollBarImageView.Maximum ? hScrollBarImageView.Maximum : -picView.Left));
            }
            else
            {
                hScrollBarImageView.Visible = false;
            }
            //重新设定纵向滚动条最大值和位置
            if (picView.Height - PnlMain.Height > 0)
            {
                vScrollBarImageView.Visible = true;
                vScrollBarImageView.Maximum = picView.Height - PnlMain.Height + hScrollBarImageView.Width + 2;
                vScrollBarImageView.Value = (picView.Top >= 0 ? 0 : (-picView.Top > vScrollBarImageView.Maximum ? vScrollBarImageView.Maximum : -picView.Top));
            }
            else
            {
                vScrollBarImageView.Visible = false;
            }
        }
        #endregion
        #region 图片加裁到PictureBox中后，对其进行初始化操作
        /// <summary>
        /// 图片加裁到PictureBox中后，对其进行初始化操作
        /// </summary>
        private void InitialImage()
        {
            ImageChange();//得到最适合显示的图片尺寸
            this.w = this.picView.Width;
            this.h = this.picView.Height;
            //设定图片位置
            picView.Location = new Point(0, 0);
            //设定图片初始尺寸
            picView.Size = picView.Image.Size;
            //设定图片纵横比
            imgIndexBy1000 = (picView.Image.Height * 1000) / picView.Image.Width;
            //设定滚动条
            if (picView.Width - PnlMain.Width > 0)
            {
                hScrollBarImageView.Maximum = picView.Width - PnlMain.Width + vScrollBarImageView.Width + 2;//+ hScrollBarImageView.LargeChange
                hScrollBarImageView.Visible = true;
            }
            if (picView.Height - PnlMain.Height > 0)
            {
                vScrollBarImageView.Maximum = picView.Height - PnlMain.Height + hScrollBarImageView.Height + 2;//+ vScrollBarImageView.LargeChange
                vScrollBarImageView.Visible = true;
            }
            CenterImage();
        }
        #endregion
        #region 居中与全屏显示图片
        /// <summary>
        /// 使图片全屏显示
        /// </summary>
        private void FullImage()
        {
            if (picView.Image.Width < picView.Width && picView.Image.Height < picView.Height)
            {
                picView.SizeMode = PictureBoxSizeMode.CenterImage;
            }
            CalculateAspectRatioAndSetDimensions();
        }
        /// <summary>
        /// 保持图片居中显示
        /// </summary>
        private void CenterImage()
        {
            picView.Left = PnlMain.Width / 2 - picView.Width / 2;
            picView.Top = PnlMain.Height / 2 - picView.Height / 2;
        }
        #endregion
        #region CalculateAspectRatioAndSetDimensions
        /// <summary>
        /// CalculateAspectRatioAndSetDimensions
        /// </summary>
        /// <returns>double</returns>
        private double CalculateAspectRatioAndSetDimensions()
        {
            double ratio;
            if (picView.Image.Width > picView.Image.Height)
            {
                ratio = picView.Image.Width / picView.Image.Height;
                picView.Height = Convert.ToInt16(double.Parse(picView.Width.ToString()) / ratio);
            }
            else
            {
                ratio = picView.Image.Height / picView.Image.Width;
                picView.Width = Convert.ToInt16(double.Parse(picView.Height.ToString()) / ratio);
            }
            return ratio;
        }
        #endregion
        #region 用于适应图片大小
        /// <summary>
        /// 用于适应图片大小
        /// </summary>
        private void ImageChange()
        {
            this.picView.Height = this.picView.Image.Height;
            this.picView.Width = this.picView.Image.Width;
            float cx = 1;
            if (this.picView.Image.Height > this.PnlMain.Height) cx =
                (float)(this.PnlMain.Height - 10) / (float)this.picView.Image.Height;
            this.picView.Scale(cx);
            this.picView.Left = (this.PnlMain.Width - this.picView.Width) / 2;
            this.picView.Top = (this.PnlMain.Height - this.picView.Height) / 2;
        }
        #endregion
        #endregion
        #region 窗口（PnlMain）尺寸改变时图像的显示位置控制
        /************************************************************
         * 窗口（PnlMain）尺寸改变时图像的显示位置控制
         ************************************************************/
        private void PnlMain_Resize(object sender, EventArgs e)
        {
            //对左右的方向操作（左右）
            if (picView.Width <= PnlMain.Width) //图片左右居中
            {
                picView.Left = (PnlMain.Width - picView.Width) / 2;
                hScrollBarImageView.Visible = false;
            }
            else if (picView.Left < 0 && picView.Width + picView.Left < PnlMain.Width)//图片靠右
            {
                picView.Left = PnlMain.Width - picView.Width;
                hScrollBarImageView.Visible = true;
            }
            else if (picView.Left > 0 && picView.Width + picView.Left > PnlMain.Width)//图片靠左
            {
                picView.Left = 0;
                hScrollBarImageView.Visible = true;
            }
            else//保证显示的中心图样不变（左右）
            {
                picView.Left += (PnlMain.Width - panelOldSize.X) / 2;
                hScrollBarImageView.Visible = true;
            }
            //设定横向滚动条最大值
            hScrollBarImageView.Maximum = (picView.Width - PnlMain.Width > 0 ? picView.Width - PnlMain.Width + hScrollBarImageView.Maximum + 2 : 0);
            //设定横向滚动条Value
            hScrollBarImageView.Value = (picView.Left >= 0 ? 0 : -picView.Left);
            //重置旧的pannel1的Width
            panelOldSize.X = PnlMain.Width;
            //对上下的方向操作（上下）
            if (picView.Height <= PnlMain.Height)//图片上下居中
            {
                picView.Top = (PnlMain.Height - picView.Height) / 2;
                vScrollBarImageView.Visible = false;
            }
            else if (picView.Top < 0 && picView.Height + picView.Top < PnlMain.Height)//图片靠下
            {
                picView.Top = PnlMain.Height - picView.Height;
                vScrollBarImageView.Visible = true;
            }
            else if (picView.Top > 0 && picView.Height + picView.Top > PnlMain.Height)//图片靠上
            {
                picView.Top = 0;
                vScrollBarImageView.Visible = true;
            }
            else//保证显示的中心图样不变（上下）
            {
                picView.Top += (PnlMain.Height - panelOldSize.Y) / 2;
                vScrollBarImageView.Visible = true;
            }
            //设定纵向滚动条最大值
            vScrollBarImageView.Maximum = (picView.Height - PnlMain.Height > 0 ? picView.Height - PnlMain.Height + vScrollBarImageView.Maximum + 2 : 0);
            //设定纵向滚动条Value
            vScrollBarImageView.Value = (picView.Top >= 0 ? 0 : -picView.Top);
            //重置旧的pannel1的Height
            panelOldSize.Y = PnlMain.Height;
        }
        #endregion
        #region 滚动条滚动时，图片移动
        /************************************************************
         * 滚动条滚动时，图片移动
         ************************************************************/
        private void vScrollBarImageView_ValueChanged(object sender, EventArgs e)
        {
            picView.Top = -vScrollBarImageView.Value;
        }
        private void hScrollBarImageView_ValueChanged(object sender, EventArgs e)
        {
            picView.Left = -hScrollBarImageView.Value;
        }
        #endregion
        #region PictureBox 鼠标按下、鼠标进入、松开与移动事件
        private void picView_MouseDown(object sender, MouseEventArgs e)
        {
            StartP = e.Location;
            isMouseDown = true;
        }
        private void picView_MouseEnter(object sender, EventArgs e)
        {
            picView.Focus();
        }
        private void picView_MouseMove(object sender, MouseEventArgs e)
        {
            if (mnuMy.Checked && isMouseDown)
            {
                this.picView.Cursor = Cursors.SizeAll;
                //计算出移动后两个滚动条应该的Value
                int x = -picView.Left + StartP.X - e.X;
                int y = -picView.Top + StartP.Y - e.Y;
                //如果滚动条的value有效则执行操作；
                if (x >= -PnlMain.Width + 10 && x <= picView.Width - 10)
                {
                    if (hScrollBarImageView.Visible)
                    {
                        if (x > 0)
                            hScrollBarImageView.Value = x > hScrollBarImageView.Maximum ? hScrollBarImageView.Maximum : x;
                        picView.Left = -x - (vScrollBarImageView.Visible && x < 0 ? vScrollBarImageView.Width : 0);
                    }
                    else
                        picView.Left = -x;
                }
                
                if (y >= -PnlMain.Height + 10 && y <= picView.Height - 10)
                {
                    if (vScrollBarImageView.Visible)
                    {
                        if (y > 0)
                            vScrollBarImageView.Value = y > vScrollBarImageView.Maximum ? vScrollBarImageView.Maximum : y;
                        picView.Top = -y - (hScrollBarImageView.Visible && y < 0 ? hScrollBarImageView.Height : 0);
                    }
                    else
                        picView.Top = -y;
                }
                /*****************************************************
                 * 给予调整滚动条调整图片位置
                 *****************************************************
                计算出移动后两个滚动条应该的Value*/
                /*int w = hScrollBarImageView.Value + StartP.X -e.X;
                int z = vScrollBarImageView.Value + StartP.Y -e.Y;
                如果滚动条的value有效则执行操作；
                否则将滚动条按不同情况拉到两头
                if (w >= 0 && w <= hScrollBarImageView.Maximum)
                {
                    hScrollBarImageView.Value = w;
                }
                else
                {
                    hScrollBarImageView.Value = (w < 0 ? 0 : hScrollBarImageView.Maximum);
                }
                if (z >= 0 && z <= vScrollBarImageView.Maximum)
                {
                    vScrollBarImageView.Value = z;
                }
                else
                {
                    vScrollBarImageView.Value = (z < 0 ? 0 : vScrollBarImageView.Maximum);
                }*/
            }
            else
            {
                this.picView.Cursor = Cursors.Default;
            }
        }
        private void picView_MouseUp(object sender, MouseEventArgs e)
        {
            isMouseDown = false;
        }
        #endregion
        #region 滚动鼠标滚轮实现鼠标缩放
        /************************************************************
         * 滚动鼠标滚轮实现鼠标缩放
         ************************************************************/
        private void picView_MouseWheel(object sender, MouseEventArgs e)
        {
            switch (keyAction)
            {
                case 1:
                    if (e.Delta > 0 && picView.Width < 10000)
                    {
                        zoom(e.Location, 1100);
                    }
                    else if (e.Delta < 0 && picView.Image.Width / picView.Width < 5)
                    {
                        zoom(e.Location, 900);
                    }
                    CenterImage();//使图片居中显示
                    break;
                case 2:
                    if (hScrollBarImageView.Visible)
                        hScrollBarImageView.Value = (hScrollBarImageView.Value - e.Delta < 0 ? 0 : (hScrollBarImageView.Value - e.Delta > hScrollBarImageView.Maximum ? hScrollBarImageView.Maximum : hScrollBarImageView.Value - e.Delta));
                    break;
                default:
                    if (vScrollBarImageView.Visible)
                        vScrollBarImageView.Value = (vScrollBarImageView.Value - e.Delta < 0 ? 0 : (vScrollBarImageView.Value - e.Delta > vScrollBarImageView.Maximum ? vScrollBarImageView.Maximum : vScrollBarImageView.Value - e.Delta));
                    break;
            }
        }
        #endregion
        #region 窗体按键事件处理
        private void UcImageView_KeyDown(object sender, KeyEventArgs e)
        {
            if (e.Control)
                keyAction = 1;
            else if (e.Shift)
                keyAction = 2;
        }
        private void UcImageView_KeyUp(object sender, KeyEventArgs e)
        {
            keyAction = 0;
        } 
        private void picView_KeyDown(object sender, KeyEventArgs e)
        {
            if (e.Control)
                keyAction = 1;
            else if (e.Shift)
                keyAction = 2;
            else
                keyAction = 3;
        }
        private void picView_KeyUp(object sender, KeyEventArgs e)
        {
            keyAction = 0;
        }
        #endregion
        #region 快捷菜单事件代码
        //放大图片
        private void mnuZoomIn_Click(object sender, EventArgs e)
        {
            this.ZoomInImage();
        }
        //缩小图片
        private void mnuZoomOut_Click(object sender, EventArgs e)
        {
            this.ZoomOutImage();
        }
        //适应图片大小
        private void mnuFitSize_Click(object sender, EventArgs e)
        {
            this.FitImageSize();
        }
        //漫游图片
        private void mnuMy_Click(object sender, EventArgs e)
        {
            MnuMoveImageChecked = !mnuMy.Checked;
            this.MoveImage();
        }
        //左旋转图片
        private void mnuLeftRotate_Click(object sender, EventArgs e)
        {
            this.LeftRotateImage();
        }
        //右旋转图片
        private void mnuRightRotate_Click(object sender, EventArgs e)
        {
            this.RightRotateImage();
        }
        #region 打印图片
        //打印图片
        private void mnuPrint_Click(object sender, EventArgs e)
        {
            if (picView.Image != null)
            {
                PrintDialog printDgImageView = new PrintDialog();
                /*设置纸张类型
                PaperSize pg = new PaperSize("A3",297,420);
                printDocImageView.DefaultPageSettings.PaperSize = pg;*/
                PaperSize pg = new PaperSize("A3", 23, 33);
                printDgImageView.Document = printDocImageView;
                if (printDgImageView.ShowDialog() == DialogResult.OK)
                {
                    try
                    {
                        printDocImageView.Print();
                    }
                    catch
                    {
                        //停止打印
                        printDocImageView.PrintController.OnEndPrint(printDocImageView, new System.Drawing.Printing.PrintEventArgs());
                    }
                }
            }
            else
            {
                DialogHelper.ShowWarningMsg("对不起，没有要打印的数据!");
            }
        }
        private void printDocImageView_PrintPage(object sender, PrintPageEventArgs e)
        {
            this.FitImageSize();//实际尺寸
            if (picView.Image != null)
            {
                e.Graphics.DrawImage(picView.Image, picView.Location.X, picView.Location.Y, picView.Width, picView.Height);
            }
        }
        #endregion
        #endregion
        #region 窗体事件
        private void mnuMy_CheckedChanged(object sender, EventArgs e)
        {
            if (OnMnuMoveImageCheckedChanged != null)
            {
                MnuMoveImageChecked = this.mnuMy.Checked;
                OnMnuMoveImageCheckedChanged(sender, EventArgs.Empty);
            }
        }
        #endregion
    }
}

　　二、WinForm窗体调用方法完整代码：

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
using DotNet.Common;
namespace DotNet.WinForm.Example
{
    public partial class FrmUcImageView : Form
    {
        public FrmUcImageView()
        {
            InitializeComponent();
        }

        private void FrmUcImageView_Shown(object sender, EventArgs e)
        {
            try
            {
                ucImageViewTest.AddImage(Image.FromFile(Application.StartupPath + "//windows7.jpg"));
            }
            catch(Exception ex)
            {
                DialogHelper.ShowErrorMsg(ex.Message);
            }
        }
        private void btnAdd_Click(object sender, EventArgs e)
        {
            openImgDlg.Filter = "Image Files(*.jpg;*.jpeg;*.tiff;*.gif)|*.jpg;*.gpeg;*.tiff;*.gif|All files (*.*)|*.*";//图片文件的类型
            if (openImgDlg.ShowDialog() == DialogResult.OK)
            {
                string FileName, pathName;
                pathName = openImgDlg.FileName;
                FileName = FileHelper.GetName(pathName);
                ucImageViewTest.AddImage(Image.FromFile(pathName));
            }
        }
        private void btnZoomIn_Click(object sender, EventArgs e)
        {
            ucImageViewTest.ZoomInImage();
        }
        private void btnZoomOut_Click(object sender, EventArgs e)
        {
            ucImageViewTest.ZoomOutImage();
        }
        private void btnMy_Click(object sender, EventArgs e)
        {
            btnMy.Checked = ucImageViewTest.MnuMoveImageChecked = !btnMy.Checked;
            ucImageViewTest.MoveImage();
        }
        private void btnFitSize_Click(object sender, EventArgs e)
        {
            ucImageViewTest.FitImageSize();
        }
        private void btnLeftRotate_Click(object sender, EventArgs e)
        {
            ucImageViewTest.LeftRotateImage();
        }
        private void btnRightRotate_Click(object sender, EventArgs e)
        {
            ucImageViewTest.RightRotateImage();
        }
        private void ucImageViewTest_OnMnuMoveImageCheckedChanged(object sender, EventArgs e)
        {
            //使ucImageViewDj中的快捷菜单中的漫游的选中状态与当前窗口漫游按钮的选中状态保持一至
            btnMy.Checked = ucImageViewTest.MnuMoveImageChecked;
        }
        private void btnExit_Click(object sender, EventArgs e)
        {
            this.Close();
        }
    }
}

　　　　　　　　　　　　　　　　　　　　　　 © 2010 EricHu

原创作品，转贴请注明作者和出处，留此信息。

------------------------------------------------

cnBlobs:http://www.cnblogs.com/huyong/
CSDN：http://blog.csdn.net/chinahuyong