C++博客-λ-calculus（惊愕到手了欧耶，BlogExportFull.aspx）

GacUI Demo：文本框高亮（一）

陈梓瀚(vczh) — Fri, 11 May 2012 16:58:00 GMT

摘要: GacUI的高亮Demo做了一半。现在的进度是，可以手写着色器的状态转换函数，但是自动从正则表达式产生着色器的状态转换函数部分还没有集成进GacUI。这篇博客还是照旧，看图、看Demo代码，说着色原理。这次的Demo要做一个可以动态切换着色器的小程序，里面包含INI、XML和C++三种着色器。现在只实现了INI一中，手写的... 阅读全文

陈梓瀚(vczh) 2012-05-12 00:58 发表评论

GacUI Demo：文本框基本应用

陈梓瀚(vczh) — Sat, 05 May 2012 10:37:00 GMT

摘要: GacUI添加了一个新的Demo。这个Demo用了几个按钮（之所以不用菜单是因为不想让Demo一下子包含太多新东西）来实现剪贴板操作、只读控制和行跳转等功能。在剪贴板里面的内容是文字的时候，Paste按钮会被Enable。这个过程是自动的，也就是说，你在画图里面复制了一个图片，这个按钮也会变灰。Cut和Copy按钮仅在文本框有文字被选中的时候可用，因此相应了文... 阅读全文

陈梓瀚(vczh) 2012-05-05 18:37 发表评论

GacUI Demo：标签页

陈梓瀚(vczh) — Tue, 01 May 2012 07:28:00 GMT

    GacUI新增了一个Demo。这里模拟了一个简单到过头了的编辑程序。界面是一个标签页，第一页里面只有一个按钮：Add Page。点中了他之后，其它页包含一个用来关掉自己的按钮，和一个多行的文本框。

    这个Demo要展示的其中一个问题是，在按下关闭按钮的时候，由于那个Page会被移除并删除，会导致按钮自己也被删除。但是事件发生过后，实际上还有很多事情要做的。所以这里展示了如何使用GacUI进行“延迟执行”，在事件结束之后再删除自己。为了方便，这个Demo使用了C++11（但是库的实现并不依赖与C++11）。先上图：

    然后我们来看代码：

#include "..\..\Public\Source\GacUIIncludes.h"
#include <Windows.h>

int CALLBACK WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int CmdShow)
{
    return SetupWindowsDirect2DRenderer();
}

class TextBoxPage : public GuiTabPage
{
private:
    static int pageCounter;

    GuiButton*                closeButton;
    GuiMultilineTextBox*    textBox;

    void closeButton_Clicked(GuiGraphicsComposition* sender, GuiEventArgs& arguments)
    {
        // deleteing the tab page will also delete the button, because the button is in the page
        // when an event is processing, the button is not going to be deleted
        // because there are many works to do after this event
        // and maybe someone has already added another event handler to this button
        // so it use GetApplication()->InvokeInMainThread to send a function to the queue
        // so that this function will be executed after this input message (an input message raises multiple events)
        // to the user, this page is closed after cliking this button
        GetApplication()->InvokeInMainThread([this]()
        {
            // remove the page and delete it
            this->GetOwnerTab()->RemovePage(this);
            delete this;
        });
    }

    void OnPageContainerReady(GuiGraphicsComposition* sender, GuiEventArgs& arguments)
    {
        // create a table to place a button and a text box
        GuiTableComposition* table=new GuiTableComposition;
        table->SetRowsAndColumns(2, 1);
        table->SetRowOption(0, GuiCellOption::MinSizeOption());
        table->SetRowOption(1, GuiCellOption::PercentageOption(1.0));
        table->SetColumnOption(0, GuiCellOption::PercentageOption(1.0));
        table->SetAlignmentToParent(Margin(0, 0, 0, 0));
        table->SetCellPadding(2);

        {
            GuiCellComposition* cell=new GuiCellComposition;
            table->AddChild(cell);
            cell->SetSite(0, 0, 1, 1);

            closeButton=g::NewButton();
            closeButton->SetText(L"Close Me!");
            closeButton->Clicked.AttachMethod(this, &TextBoxPage::closeButton_Clicked);
            cell->AddChild(closeButton->GetBoundsComposition());
        }

        {
            GuiCellComposition* cell=new GuiCellComposition;
            table->AddChild(cell);
            cell->SetSite(1, 0, 1, 1);

            textBox=g::NewMultilineTextBox();
            textBox->GetBoundsComposition()->SetAlignmentToParent(Margin(0, 0, 0, 0));
            textBox->SetText(L"You can input several lines of text here.\r\nThis is a multiple line text box.");
            cell->AddChild(textBox->GetBoundsComposition());
        }

        this->GetContainer()->GetContainerComposition()->AddChild(table);
    }

public:
    TextBoxPage()
        :closeButton(0)
        ,textBox(0)
    {
        PageContainerReady.AttachMethod(this, &TextBoxPage::OnPageContainerReady);
        this->SetText(L"Page "+itow(++pageCounter));
    }

    ~TextBoxPage()
    {
    }
};

int TextBoxPage::pageCounter=0;

class TextBoxPageWindow : public GuiWindow
{
private:
    GuiTab*                        tabControl;
    GuiTabPage*                    controlPanelPage;
    GuiButton*                    buttonAddPage;

    void buttonAddPage_Clicked(GuiGraphicsComposition* sender, GuiEventArgs& arguments)
    {
        // when the button is clicked, it creates a new TextBoxPage and adds it to the tab control
        TextBoxPage* page=new TextBoxPage;
        tabControl->CreatePage(page);
        tabControl->SetSelectedPage(page);
    }
public:
    TextBoxPageWindow()
        :GuiWindow(GetCurrentTheme()->CreateWindowStyle())
    {
        this->SetText(L"Controls.Tab.TextBoxPage");
        this->GetBoundsComposition()->SetPreferredMinSize(Size(640, 480));

        // create a tab control
        tabControl=g::NewTab();
        tabControl->GetBoundsComposition()->SetAlignmentToParent(Margin(2, 2, 2, 2));
        this->AddChild(tabControl);

        // the first page is a control panel
        controlPanelPage=tabControl->CreatePage();
        controlPanelPage->SetText(L"Control Panel");

        // add a button to the control panel
        buttonAddPage=g::NewButton();
        buttonAddPage->SetText(L"Add a tab page");
        buttonAddPage->Clicked.AttachMethod(this, &TextBoxPageWindow::buttonAddPage_Clicked);
        controlPanelPage->GetContainer()->GetContainerComposition()->SetInternalMargin(Margin(2, 2, 2, 2));
        controlPanelPage->GetContainer()->AddChild(buttonAddPage);

        this->ForceCalculateSizeImmediately();
        this->MoveToScreenCenter();
    }

    ~TextBoxPageWindow()
    {
    }
};

void GuiMain()
{
    GuiWindow* window=new TextBoxPageWindow();
    GetApplication()->Run(window);
    delete window;
}

    那一大段的注释，就是在讲延迟执行的事情。看过C++11的人都知道，lambda expression实际上就是一个functor。在旧C++里面，调用InvokeInMainThread的时候，要么可以传一个void(*)(void*)和void*，要么可以传一个带operator()()的struct。在新C++里面，直接把lambda expression写在里面就好了。

    如果不使用延迟执行，在事件发生的时候把自己删掉，会导致Access Violation的发生，因为接下来要访问的对象被你删掉了。如果使用延迟执行，就可以在input message处理完之后，执行删除的代码。这样一切都是好的。

    下一个Demo就是关于文本框的操作，再下一个Demo是关于如何做用来显示代码的高亮文本框的事情。敬请期待，啊哈哈哈。

陈梓瀚(vczh) 2012-05-01 15:28 发表评论

GacUI Demo：多选框和单选框

陈梓瀚(vczh) — Fri, 27 Apr 2012 14:02:00 GMT

    GacUI发布了一个新的Demo。这个Demo是关于多选框和单选框的。跟Windows一样，直接创建出来的单选框其实是不会互斥的，除非你把他们放进同一个group里面。界面是左右各一个group box，使用table来保证两边的尺寸都一样大。每一个group box里面放三个按钮，而且每一个group box的最小尺寸都取决于两边所有6按钮中最长的那个按钮。每一边的三个按钮使用stack来排列成像一个列表一样。左边是多选框，右边是单选框。现在先上图：

    第一张是刚打开的时候，窗口的尺寸自动变化到能显示所有内容的最小的尺寸。尽管因为文字的关系，左边的按钮比右边的短，但是table可以控制两个group box一样大，并且共享最小尺寸。

    然后改变窗口的尺寸，按钮始终靠左上角，两个group box则保持一样大。

    大家已经看了前面的三个demo，所以有些东西其实已经不需要重复解释了。先上代码：

#include "..\..\Public\Source\GacUIIncludes.h"
#include <Windows.h>

int CALLBACK WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int CmdShow)
{
    return SetupWindowsDirect2DRenderer();
}

class CheckAndRadioWindow : public GuiWindow
{
private:

    GuiCellComposition* CreateButtons(const WString& groupName, const WString& buttonName, bool checkBox, GuiSelectableButton::GroupController* groupController)
    {
        GuiCellComposition* cell=new GuiCellComposition;

        GuiControl* groupBox=g::NewGroupBox();
        groupBox->GetBoundsComposition()->SetMinSizeLimitation(GuiGraphicsComposition::LimitToElementAndChildren);
        groupBox->GetContainerComposition()->SetMinSizeLimitation(GuiGraphicsComposition::LimitToElementAndChildren);
        // all child controls should at least 10 pixels away from the group box
        groupBox->GetContainerComposition()->SetInternalMargin(Margin(10, 10, 10, 10));
        // dock the group box to fill the cell
        groupBox->GetBoundsComposition()->SetAlignmentToParent(Margin(0, 0, 0, 0));
        groupBox->SetText(groupName);
        // add the button to the cell
        cell->AddChild(groupBox->GetBoundsComposition());

        // create a stack to layout the 3 buttons from top to bottom shown like a list
        GuiStackComposition* stack=new GuiStackComposition;
        stack->SetMinSizeLimitation(GuiGraphicsComposition::LimitToElementAndChildren);
        stack->SetDirection(GuiStackComposition::Vertical);
        stack->SetAlignmentToParent(Margin(0, 0, 0, 0));
        stack->SetPadding(6);
        groupBox->GetContainerComposition()->AddChild(stack);

        // create buttons
        for(int i=0;i<3;i++)
        {
            GuiSelectableButton* button=checkBox?g::NewCheckBox():g::NewRadioButton();
            button->SetText(buttonName+itow(i+1));
            button->GetBoundsComposition()->SetAlignmentToParent(Margin(0, 0, 0, 0));
            if(groupController)
            {
                button->SetGroupController(groupController);
            }

            GuiStackItemComposition* stackItem=new GuiStackItemComposition;
            stack->AddChild(stackItem);
            stackItem->AddChild(button->GetBoundsComposition());
        }

        return cell;
    }
public:
    CheckAndRadioWindow()
        :GuiWindow(GetCurrentTheme()->CreateWindowStyle())
    {
        this->SetText(L"Controls.Button.CheckAndRadio");
        // limit the size that the window should always show the whole content without cliping it
        this->GetContainerComposition()->SetMinSizeLimitation(GuiGraphicsComposition::LimitToElementAndChildren);

        // create a table to layout the 2 group boxes
        GuiTableComposition* table=new GuiTableComposition;
        // make the table to have 2 rows
        table->SetRowsAndColumns(1, 2);
        table->SetRowOption(0, GuiCellOption::MinSizeOption());
        table->SetColumnOption(0, GuiCellOption::PercentageOption(0.5));
        table->SetColumnOption(1, GuiCellOption::PercentageOption(0.5));
        // dock the table to fill the window
        table->SetAlignmentToParent(Margin(4, 4, 4, 4));
        table->SetCellPadding(6);
        // add the table to the window;
        this->GetContainerComposition()->AddChild(table);

        // add group box for check boxes
        {
            GuiCellComposition* cell=CreateButtons(L"Check Boxes", L"This is a check box ", true, 0);
            table->AddChild(cell);
            // this cell is the left cell
            cell->SetSite(0, 0, 1, 1);
        }

        // add group box for radio buttons
        {
            // create a group controller to group those radio buttons together
            // so that select a radio button will unselect the previous one automatically
            GuiSelectableButton::GroupController* groupController=new GuiSelectableButton::MutexGroupController;
            this->AddComponent(groupController);

            GuiCellComposition* cell=CreateButtons(L"Radio buttons", L"This is a radio button ", false, groupController);
            table->AddChild(cell);
            // this cell is the right cell
            cell->SetSite(0, 1, 1, 1);
        }

        // call this to calculate the size immediately if any indirect content in the table changes
        // so that the window can calcaulte its correct size before calling the MoveToScreenCenter()
        this->ForceCalculateSizeImmediately();
        // move to the screen center
        this->MoveToScreenCenter();
    }

    ~CheckAndRadioWindow()
    {
    }
};

void GuiMain()
{
    GuiWindow* window=new CheckAndRadioWindow();
    GetApplication()->Run(window);
    delete window;
}

需要关心的就是第二次调用CreateButtons函数，用来构造单选按钮的时候，穿进去的最后一个参数。GuiSelectableButton::GroupController类是一个虚类，用来控制选中状况。而预定义的MutexGroupController则可以控制连接到的所有GuiSelectionButton并保证他们互斥。如果需要更加复杂的情况，譬如说“最多只能选中N个按钮”这样的，则自己集成一个group controller就可以了。在创建了一个group controller，要调用GuiWindow::AddComponent保持他的生命周期，然后使用GuiSelectableButton::SetGroupController来帮顶一个按钮和一个group controller。

这个demo就介绍到这里了，下一个将是关于tab控件和文本框的demo。

陈梓瀚(vczh) 2012-04-27 22:02 发表评论

GacUI新Demo：按钮和排版

陈梓瀚(vczh) — Wed, 25 Apr 2012 10:46:00 GMT

    今天为GacUI写了一个新的Demo，展示了一些可以自动排版的按钮。主要的设想就是在窗口上放一个表格，分成两行两列。上面的按钮占满一整行，下面两个单元格放两个按钮。然后就可以设置每个行和列占整个表格的比例，在这个Demo里面都设置成50%。这样每当窗口缩放的时候，按钮的位置也会随之重新排版。然后设置表格充满整个窗口，这样窗口的最小值就会被表格的内容所限定，这样试图把窗口缩小的时候，就会有一个最小的尺寸限制着，至始至终保证所有的东西都可以显示出来，不会因为窗口太小而只显示一半。按钮也是同样，可以设置它必须显示所有的文字。所有的过程一旦配置好之后，计算尺寸的时候所有的操作都会自动做，程序员不需要为窗口的Resize事件写任何代码。

    下面先放图。

    第一个图是窗口刚刚打开的时候的样子。因为Demo里面没有设置窗口的尺寸，所以一上来就自动变成了最小的尺寸——并且刚好可以显示所有的内容。

    第二个图是窗口放大之后的样子。Disable按钮被按下了，所以上面的按钮就变灰。

    这个Demo使用了Direct2D渲染器，所有的绘制过程都十分高速。而且表格的尺寸计算也是经过优化的，在拖放窗口的时候十分流畅。事实上按钮的渐变啊、边框啊、文字等等也是借助表格排版的。由于尺寸计算过于复杂，除了表格之外整个框架都不保存控件的尺寸，所有的东西都在需要的时候——譬如说渲染的时候，譬如说计算鼠标点中的位置——的那一刻才开始算。因此无论是鼠标滑过，或者是窗口拖放，都拼命地执行很多虚函数。可见C++的虚函数的性能之高，几乎永远都不会成为程序的瓶颈。下面来看代码：

#include "..\..\Public\Source\GacUIIncludes.h"
#include <Windows.h>

int CALLBACK WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int CmdShow)
{
    return SetupWindowsDirect2DRenderer();
}

class EnableDisableWindow : public GuiWindow
{
private:
    GuiButton*            buttonTarget;
    GuiButton*            buttonEnable;
    GuiButton*            buttonDisable;

    void buttonEnable_OnClick(GuiGraphicsComposition* sender, GuiEventArgs& arguments)
    {
        buttonTarget->SetEnabled(true);
    }

    void buttonDisable_OnClick(GuiGraphicsComposition* sender, GuiEventArgs& arguments)
    {
        buttonTarget->SetEnabled(false);
    }
public:
    EnableDisableWindow()
        :GuiWindow(GetCurrentTheme()->CreateWindowStyle())
    {
        this->SetText(L"Controls.Button.EnableDisable");
        // limit the size that the window should always show the whole content without cliping it
        this->GetContainerComposition()->SetMinSizeLimitation(GuiGraphicsComposition::LimitToElementAndChildren);

        // create a table to layout the 3 buttons
        GuiTableComposition* table=new GuiTableComposition;
        // make the table to have 2 rows
        table->SetRowsAndColumns(2, 2);
        table->SetRowOption(0, GuiCellOption::PercentageOption(0.5));
        table->SetRowOption(1, GuiCellOption::PercentageOption(0.5));
        table->SetColumnOption(0, GuiCellOption::PercentageOption(0.5));
        table->SetColumnOption(1, GuiCellOption::PercentageOption(0.5));
        // dock the table to fill the window
        table->SetAlignmentToParent(Margin(10, 10, 10, 10));
        // add the table to the window;
        this->GetContainerComposition()->AddChild(table);

        // add the target button
        {
            GuiCellComposition* cell=new GuiCellComposition;
            table->AddChild(cell);
            // this cell is the top cell
            cell->SetSite(0, 0, 1, 2);

            buttonTarget=g::NewButton();
            buttonTarget->SetText(L"Enable or disable me using the buttons below!");
            // ensure that the buttonTarget display the whole text
            buttonTarget->GetBoundsComposition()->SetMinSizeLimitation(GuiGraphicsComposition::LimitToElementAndChildren);
            // dock the button to fill the cell
            buttonTarget->GetBoundsComposition()->SetAlignmentToParent(Margin(0, 0, 0, 3));
            // add the button to the cell
            cell->AddChild(buttonTarget->GetBoundsComposition());
        }

        // add the enable button
        {
            GuiCellComposition* cell=new GuiCellComposition;
            table->AddChild(cell);
            // this cell is the bottom left cell
            cell->SetSite(1, 0, 1, 1);

            buttonEnable=g::NewButton();
            buttonEnable->SetText(L"Enable");
            buttonEnable->GetBoundsComposition()->SetMinSizeLimitation(GuiGraphicsComposition::LimitToElementAndChildren);
            buttonEnable->GetBoundsComposition()->SetAlignmentToParent(Margin(0, 3, 3, 0));
            buttonEnable->Clicked.AttachMethod(this, &EnableDisableWindow::buttonEnable_OnClick);
            cell->AddChild(buttonEnable->GetBoundsComposition());
        }

        // add the disable button
        {
            GuiCellComposition* cell=new GuiCellComposition;
            table->AddChild(cell);
            // this cell is the bottom right cell
            cell->SetSite(1, 1, 1, 1);

            buttonDisable=g::NewButton();
            buttonDisable->SetText(L"Disable");
            buttonDisable->GetBoundsComposition()->SetMinSizeLimitation(GuiGraphicsComposition::LimitToElementAndChildren);
            buttonDisable->GetBoundsComposition()->SetAlignmentToParent(Margin(3, 3, 0, 0));
            buttonDisable->Clicked.AttachMethod(this, &EnableDisableWindow::buttonDisable_OnClick);
            cell->AddChild(buttonDisable->GetBoundsComposition());
        }

        // change the button font
        {
            FontProperties font;

            font=buttonTarget->GetFont();
            font.size=20;
            buttonTarget->SetFont(font);
            buttonEnable->SetFont(font);
            buttonDisable->SetFont(font);
        }

        // call this to calculate the size immediately if any indirect content in the table changes
        // so that the window can calcaulte its correct size before calling the MoveToScreenCenter()
        table->UpdateCellBounds();
        // update the size
        this->SetBounds(Rect());
        // move to the screen center
        this->MoveToScreenCenter();
    }

    ~EnableDisableWindow()
    {
    }
};

void GuiMain()
{
    GuiWindow* window=new EnableDisableWindow();
    GetApplication()->Run(window);
    delete window;
}

代码里面充满了注释，而且主要的内容也在上面介绍了，在这里我就不罗嗦了。所有的代码都可以在http://gac.codeplex.com中，下载最新的代码，然后在Libraries\GacUI\GacUIDemo\GacUIDemo.sln下面找到。

陈梓瀚(vczh) 2012-04-25 18:46 发表评论

GacUI Demo：使用Label控件模仿超链接

陈梓瀚(vczh) — Tue, 24 Apr 2012 10:37:00 GMT

    今天我给GacUI添加了一个新Demo。我发现写Demo也是一个测试的过程，可以用来检验类库提供的API是否够完整。前面这两个Demo都促使我往类库里面加入了新的函数。这次的Demo是用Label控件来模仿超链接。下载最新代码之后，可以在“Libraries\GacUI\GacUIDemo\GacUIDemo.sln”下面找到最新的Demo代码。

    为了模仿超链接，我们要做两件事情。第一件事情就是鼠标悬浮在Label上的时候需要显示出手的光标图，第二件事情就是在鼠标进入Label的时候显示下划线，离开的时候去掉下划线。因此我们需要监听三个事件，分别是MouseEnter，MouseLeave和LeftButtonDown。下面是Demo的图：

    上图：鼠标在Label外。下图：鼠标在Label内。单击Label的时候会打开浏览器。

    代码如下：

#include "..\..\Public\Source\GacUIIncludes.h"
#include <Windows.h>

int CALLBACK WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int CmdShow)
{
    return SetupWindowsDirect2DRenderer();
}

class HyperlinkWindow : public GuiWindow
{
private:
    GuiLabel*                labelHyperlink;

    void labelHyperlink_OnMouseEnter(GuiGraphicsComposition* sender, GuiEventArgs& arguments)
    {
        FontProperties font=labelHyperlink->GetFont();
        font.underline=true;
        labelHyperlink->SetFont(font);
    }

    void labelHyperlink_OnMouseLeave(GuiGraphicsComposition* sender, GuiEventArgs& arguments)
    {
        FontProperties font=labelHyperlink->GetFont();
        font.underline=false;
        labelHyperlink->SetFont(font);
    }

    void labelHyperlink_OnLeftButtonDown(GuiGraphicsComposition* sender, GuiMouseEventArgs& arguments)
    {
        ShellExecute(NULL, L"OPEN", L"http://www.cppblog.com/vczh", NULL, NULL, SW_SHOWNORMAL);
    }
public:
    HyperlinkWindow()
        :GuiWindow(GetCurrentTheme()->CreateWindowStyle())
    {
        SetText(L"Controls.Label.Hyperlink");
        SetClientSize(Size(300, 200));
        MoveToScreenCenter();

        labelHyperlink=g::NewLabel();
        labelHyperlink->SetText(L"http://www.cppblog.com/vczh");
        labelHyperlink->SetTextColor(Color(0, 0, 255));
        {
            FontProperties font;
            font.fontFamily=L"Segoe UI";
            font.size=18;
            font.antialias=true;
            labelHyperlink->SetFont(font);
        }
        {
            INativeCursor* hand=GetCurrentController()->ResourceService()->GetSystemCursor(INativeCursor::Hand);
            labelHyperlink->GetBoundsComposition()->SetAssociatedCursor(hand);
        }
        labelHyperlink->GetEventReceiver()->mouseEnter.AttachMethod(this, &HyperlinkWindow::labelHyperlink_OnMouseEnter);
        labelHyperlink->GetEventReceiver()->mouseLeave.AttachMethod(this, &HyperlinkWindow::labelHyperlink_OnMouseLeave);
        labelHyperlink->GetEventReceiver()->leftButtonDown.AttachMethod(this, &HyperlinkWindow::labelHyperlink_OnLeftButtonDown);
        AddChild(labelHyperlink);
    }

    ~HyperlinkWindow()
    {
    }
};

void GuiMain()
{
    GuiWindow* window=new HyperlinkWindow();
    GetApplication()->Run(window);
    delete window;
}

这里展示的主要是监听事件的方法。在使用control->GetEventReceiver()->event的时候，可以使用Attach、AttachMethod、AttachFunction和AttachLambda。AttachLambda传入一个functor，在C++11里面可以直接使用lambda表达式。在这里使用AttachMethod给一个事件绑定类成员函数。C++运行类成员函数的时候，不仅需要参数，还需要一个this对象，所以AttachMethod有两个参数，使用方法在Demo里面已经展现出来了。

在这里还引入了GetCurrentController函数。GetCurrentController返回的INativeController对象抽象了所有需要的操作系统的功能，其中获得一个光标的对象就封装在了ResourceService里面。INativeController还包含了很多其他的Service，这个留在以后的Demo展示。

陈梓瀚(vczh) 2012-04-24 18:37 发表评论

GacUI文档已经全部写完，进入制作Demo阶段

陈梓瀚(vczh) — Mon, 23 Apr 2012 15:37:00 GMT

今晚终于把GacUI所有该加上的XML注释都加上了，开始做起了Demo。需要做的Demo大概有几十个，除了每个控件要那么几个以外，还有一些其他功能，譬如换皮肤换风格啊，使用不同的渲染器啊，移植到Direct3D上什么的，好多啊，即将写到手软。今天写了第一个Demo，是一个helloworld程序。创建一个GacUI程序是一件很容易的事情，首先下载 GacUI的最新代码（在有了Release之后会有更好的文件组织和html文档），然后将“Libraries\GacUI\Public\Source”下面的5个文件添加进建好的Visual C++的Windows工程里面，然后开始写main函数：

#include "..\..\Public\Source\GacUIIncludes.h"
#include <Windows.h>

int CALLBACK WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int CmdShow)
{
    return SetupWindowsDirect2DRenderer();
}

void GuiMain()
{
    GuiWindow* window=g::NewWindow();
    window->SetText(L"Hello, world!");
    window->SetClientSize(Size(640, 480));
    window->MoveToScreenCenter();

    GuiControl* label=g::NewLabel();
    label->SetText(L"Welcome to GacUI Library!");
    {
        FontProperties font;
        font.fontFamily=L"Segoe UI";
        font.size=40;
        font.antialias=true;
        label->SetFont(font);
    }
    window->AddChild(label);

    GetApplication()->Run(window);
    delete window;
}

    Main函数里面需要选择渲染器，这里选的是Direct2D。如果要选择GDI，则调用SetupWindowsGDIRenderer。至于void GuiMain(void)函数则是类库自己的要求，一定要有那么一个，因为SetupWindowsDirect2DRenderer（或GDI）最终会进行一大段初始化工作之后调用一个声明了却没有实现的void GuiMain(void)函数，所以一个合法的GacUI工程需要包含void GuiMain(void)的实现，也就是上面这样。

    然后接下来的就是普通的工作了，创建一个GuiWindow，加点东西，Run一下当主窗口。当主窗口被关掉的时候Run函数就会结束，这个时候进行一下必要的清理，程序就可以结束了。运行之后就是下面这个样子：

    至此HelloWorld的Demo就结束了。

陈梓瀚(vczh) 2012-04-23 23:37 发表评论

成功从VC++的XML注释生成静态html文档

陈梓瀚(vczh) — Sun, 01 Apr 2012 08:43:00 GMT

    GacUI的类库说明文档已经可以生成了！利用了之前的这篇博客描述的pdb信息抽取并和XML注释合并的技术，成功写了一系列工具来从这些信息里面生成静态html文档。现在的XML注释只写了1/3，所以生成的文档还不全。

    之所以做这个工具，而不用Doxygen，是因为Visual C++对XML注释有着良好的支持。如果你为你的代码写了XML注释，那么在智能提示里面还可以看到成员的文档。但是这个形式的注释并不是Doxygen所接受的，而微软或其它开源工具对XML注释生成文档的工具仅限于.net程序（包括C++/CLI）。本来GacUI的release所提供的代码是几个压缩过的cpp和h文件，所以可以用一个C++/CLI工程去编译这个代码从而使用那些软件来产生文档的。不过本着造福大众兼磨练自己的精神，就写了一个专门针对VC++的Native C++工程编译产生的xml注释文件和pdb文件抽取数据合成文档的工具。

    下面是文档的截图：

文档生成工具的代码已经提交到了Gac Library（http://gac.codeplex.com）上面。目前的话，只需要打开\Libraries\GacUI\GacUISrc\GacUISrc.sln，使用debug编译之后，运行\Libraries\GacUI\Public\Release.bat，就会在Temp\StaticHtmpDoc\目录下面产生一系列的html文件。目前这个文档的根节点是reference_gacui.html文件。

在Release.bat里面可以看出，我使用了\Common\Tools\下面的几个exe程序来读pdb、读xml注释并生成静态html文档。在与exe同名的目录下面，有这些工具的源代码。目前这个工具还不能处理模板类的xml注释，这个功能不久之后就会加上去。

陈梓瀚(vczh) 2012-04-01 16:43 发表评论

GacUI开源了！

陈梓瀚(vczh) — Sat, 24 Mar 2012 10:31:00 GMT

    我最终还是给GacUI专门申请了一个codeplex的项目主页：http://gac.codeplex.com。Vczh Library++ 3.0上面上传的代码大多是实验产品，相比把GacUI也放在上面发布不太合适，所以开了一个新项目。新的项目使用MS-PL协议。MS-PL的协议跟BSD、MIT和Apache等协议几乎是一样的，除了“他人不得用MS-PL协议的代码申请专利”。这是一个避免纠纷的好方法。

    GacUI现在还没全部完成。目前正在制作文档和教程。文档应该要么是html要么是pdf，教程会跟文档合并到一起去。GacUI大体上还是能用，不过目前处于alpha状态。
    已经完成的功能有：
        1、GDI和Direct2D渲染器
        2、皮肤系统
        3、各种基于MVVM模式设计的控件
        4、可切换的窗口系统。我目前只提供了一个用Windows窗口做窗口骨架的provider，如果你们高兴的话也可以去写一个虚拟的，然后就可以选择Direct2D渲染器，最后合并到游戏里面。
    还没完成的功能有：
        1、按键操作。目前只有文本框接受按键，列表和菜单什么的还没有，快捷键功能也还没有。
        2、基本对话框的支持。这个我应该不会自己做，而是使用API提供的打开保存文件对话框什么的。
        3、更加高级的控件，譬如Ribbon、VisualStudio那样子的Docking等等。
        4、其它。
    在这次完成基本的文档和教程之后，将会继续开发GacUI剩余的部分。

    之前的实验，让我最终采用代码方式来发布GacUI，并且用抓取PDB地方法，结合Visual C++提供的XML注释来生成文档的reference部分。GacUI虽然文件上百，不过我已经写了一个代码生成器，将他们合并成了3个h文件和2个cpp：Vczh Library++3.0的公共部分一个cpp；GacUI的部分一个cpp。这有利于我将来继续提供脚本引擎或者其他东西，可以共享代码一起编译。现在使用GacUI，只需要将这5个文件添加进工程就好了。而且cpp只有两个，所以如果项目使用预编译头（precompiled header）的话，给这两个cpp分别加上#include "stdafx.h"也将十分简单。

陈梓瀚(vczh) 2012-03-24 18:31 发表评论

合并Visual Studio本地C++XML注释文档和PDB的符号内容

陈梓瀚(vczh) — Sat, 10 Mar 2012 01:04:00 GMT

摘要: 终于到了激动人心的时刻了。今天的博客内容将永远消除Visual Studio的本地C++XML注释编译出来的XML文档没有办法生成可读文档的根本原因。

首先介绍一下C++的XML注释。在启用注释之前，我们必须先去工程属性里面，把[C/C++ -> Output Files -> Generate Xml Documentation Files]设置成Yes。这样我们就可以在C++的类啊函数上面写XML注释，然后被编译成一份带有符号链接的XML注释集合。这里先给一个GacUI的XML注释的例子：阅读全文

陈梓瀚(vczh) 2012-03-10 09:04 发表评论