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

南方刺

ADD-IN EXPRESS产品是根据Microsoft Office的深度定制的坚实框架，控件产品使用了解决方案模板、可视化设计和组件来开发适用于所有Office的版本。功能强大，支持的Office扩展、COM加载项、Outlook插件、RTD服务器、智能标记、Excel XLL和UDF。
从版本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区域一样可以改变成你想要的方式。


什么是高级任务窗格？在加载项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);
}慧都控件网超级促销月，狂欢大放价，全场产品低价来袭，火爆开抢>>>

截止时间：2016年11月30日
本文翻译自：Write Office COM add-in, smart tag, RTD server in Visual Studio .NET, VSTO, VCL
转载请注明慧都控件网