天天看点

如何自定义ADD-IN EXPRESS高级任务窗和Outlook区域的外观

ADD-IN EXPRESS系列产品介绍:

ADD-IN EXPRESS产品是根据Microsoft Office的深度定制的坚实框架,控件产品使用了解决方案模板、可视化设计和组件来开发适用于所有Office的版本。功能强大,支持的Office扩展、COM加载项、Outlook插件、RTD服务器、智能标记、Excel XLL和UDF。

在嵌入表单中以Office和.net为基础结构实现的Add-in Express,对于所有Office应用程序都是相同的(区别仅在于类名),以Excel任务窗格为例,检查其主要元素,看看怎么根据自己的喜好自定义它们。例如,采用高级Excel任务窗格的默认设计:

如何自定义ADD-IN EXPRESS高级任务窗和Outlook区域的外观

..并把它变成这一个:

如何自定义ADD-IN EXPRESS高级任务窗和Outlook区域的外观

简单地更改表单颜色,即将BackColor设置为绿色,并将UseOfficeThemeForBackGround属性设置为false将不够,因为这将只绘制所需颜色的窗体,而窗格的其他部分将根据Excel的颜色主题绘制:

如何自定义ADD-IN EXPRESS高级任务窗和Outlook区域的外观

为了理解下一步做什么,我使用了一个图形编辑器,并概述了组成窗格的区域。

如何自定义ADD-IN EXPRESS高级任务窗和Outlook区域的外观

上面的屏幕截图显示了展开状态下的窗格,它由三个主要区域组成:窗体、标题和分割区。为了更好的感知,我们管这些区域从窗格的边缘偏移距离叫填充。表单区域没有什么特别的意义,因为它可以适应设计创建的内容。但是Header和Splitter以及Padding区域一样可以改变成你想要的方式。

什么是高级任务窗格?

在加载项Express中,任务窗格是您的窗体所在的特定控件(ADXContainerControl)。当窗格上有多个窗体时,它们将它们存储在列表中。

重新绘制任务窗格时,首先以某种颜色绘制其背景,然后绘制标题和分割符。窗体下面的区域没有标识,当用户悬停在标题或分割器上的某个按钮上时,窗格将会被完全重绘。

如何修改任务窗格外观?

Add-in Express在AddinExpress.Extensions.ADXContainerControl类中可以实现任务窗格的基本功能。从该类继承以下类:ADXContainerControlOL,ADXContainerControlXL,ADXContainerControlPP,ADXContainerControlWD,它们分别支持Outlook,Excel,Power Point和Word特有的行为和绘图。

要更改任务窗格的标准设计时,我们需要创建一个可以继承上述类之一的新类,并覆盖所需的虚拟方法和属性。在本例中,我们继承了ADXContainerControlXL类。

public class MyContainerControl : ADXContainerControlXL
{
 
}
           

此外,我们需要指定应使用新类而不是默认类,所有需要覆盖ADXExcelTaskPane类中的GetContainerControlType方法,并返回新类的类型。

protected override Type GetContainerControlType()
{
    return typeof(MyContainerControl);
}
           

现在,我们需要覆盖并实现新的MyContainerControl类的属性和方法。 在这里,我将只描述最重要的,但是我们也可以通过以下链接下载这个例子的完整代码。如果要使用所需的颜色填充任务窗格的整个绘图区域,请覆盖BackColor属性:

public override Color BackColor
{
    get { return Color.FromArgb(0x21, 0x73, 0x46); }
}
           

对于窗格边框的内部间距,我们也可以覆盖Padding属性以调整Header、Splitter和Form区域例如:

public override Padding Padding
{
    get
    {
        Padding offsets = base.Padding;
        if (owner.RegionState == AddinExpress.XL.ADXRegionState.Hidden)
            offsets = new Padding(1, 2, 1, 2);
        return offsets;
    }
}
           

想要正确地绘制按钮上的图标,我们需要知道窗格的布局和位置(垂直或水平)。因此我们可以使用覆盖OnInitialized方法并将这些值存储在内部变量中。该方法将在窗格初始化时被调用,比如在显示窗格、更改其布局或切换到另一个Office主题之后。

protected override void OnInitialized()
{
    base.OnInitialized();
    owner = Owner as ExcelTaskPane1;
    layout = owner.Item.Position;
    isVertical = false;
    switch (layout)
    {
        case AddinExpress.XL.ADXExcelTaskPanePosition.Left:
        case AddinExpress.XL.ADXExcelTaskPanePosition.Right:
 
        isVertical = true;
        break;
    }
}
           

下面为大家介绍在绘制各种窗格控件时直接涉及的方法。考虑到背景是较暗的,我们使用白色文字颜色:

protected override void OnDrawText(DrawTextArgs e)
{
    e.ForeColor = Color.White;
    base.OnDrawText(e);
}
protected override void OnDrawHeader(DrawArgs e)
{
    //base.OnDrawHeader(e);
    e.DrawControls();
}
           

请注意,对于OnDrawHeader方法,我们只绘制子控件(通过调用e.DrawControls()方法),不需要调用基本方法,因为选择了任务:在自定义背景上绘制子控件,调用基本方法一般使用在一些Excel版本中的渐变绘制背景(例如Excel 2010)。

我们要覆盖的下一个方法是OnDrawControl(DrawControlArgs e),当显示ADXDrawControlType中列出的任何控件时,将调用此方法。

protected override void OnDrawControl(DrawControlArgs e)
{
    if (e.ControlType == ADXDrawControlType.Separator) // Excel 2010 and below
        return;
 
    // Draw any control except for splitter button
    if (e.ControlType != ADXDrawControlType.Splitter)
    {
        // Determine whether the button is available or not.
        bool disabled = false;
        switch (e.ControlType)
        {
            case ADXDrawControlType.Previous:
                disabled = !IsScrollButtonPresent(false); break;
            case ADXDrawControlType.Next:
                disabled = !IsScrollButtonPresent(true); break;
        }
 
        // If the button is available and has been clicked, or the mouse cursor hovers
        // over it, fill the background color corresponding to the button state.
        if (!disabled && e.State != ADXDrawControlState.Up)
        {
            SolidBrush br = new SolidBrush(e.State == ADXDrawControlState.Focused ?
            btnBackColor : btnPressedColor);
            e.Graphics.FillRectangle(br, e.Bounds);
            br.Dispose();
        }
 
        // Take the button image from the resources
        // and draw it using the DrawImage method.
        Image image = GetSkinImage(e.ControlType);
        if (image != null)
        {
            Size imgSize = image.Size;
            Rectangle destRect = new Rectangle(
                    e.Bounds.Left + (e.Bounds.Width - imgSize.Width) / 2,
                    e.Bounds.Top + (e.Bounds.Height - imgSize.Height) / 2,
                    imgSize.Width, imgSize.Height);
 
            // If the button is disabled, draw it with 50% transparency.
            float alpha = disabled ? 0.5f : 1.0f;
            DrawImage(e.Graphics, image, destRect, new Rectangle(Point.Empty,
                imgSize), alpha);
        }
        e.DrawControls();
    }
    else
        base.OnDrawControl(e);
}
           

本文翻译自:https://www.add-in-express.com/

转载请注明慧都控件网