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

从版本8.2开始，Add-in Express开始打开其内部基础架构，允许开发人员自定义高级Excel、Wor、PowerPoint任务窗格和Outlook的某些区域。在新版本中，可以自定义标题、控件以及分隔符和边框。我们还可以修改最小化区域的外观，控制标题可见性，更改填充，获取HitTest信息等。

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

..并把它变成这一个：

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

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

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

什么是高级任务窗格br>在加载项Express中，任务窗格是您的窗体所在的特定控件（ADXContainerControl）。当窗格上有多个窗体时，它们将它们存储在列表中。
重新绘制任务窗格时，首先以某种颜色绘制其背景，然后绘制标题和分割符。窗体下面的区域没有标识，当用户悬停在标题或分割器上的某个按钮上时，窗格将会被完全重绘。
如何修改任务窗格外观br>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 /span>            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 /span> 0.5f : 1.0f;            DrawImage(e.Graphics, image, destRect, new Rectangle(Point.Empty,                imgSize), alpha);        }        e.DrawControls();    }    else        base.OnDrawControl(e);}

控件网超级促销月，狂欢大放价，全场产品低价来袭，火爆开抢>>>

截止时间：2016年11月30日

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

转载请注明控件网

标签：VCL.NET文档管理Office

来源：慧都