The Nana Programmer's Guide

Nana - a C++ framework project

The Programmer's Guide
                nana::gui::frame

                Description

                A frame widget is a container for the system native windows, it provides an approach
                of displaying a control that is not written with Nana.GUI in a Nana.GUI window.

                Model
                of

                Frame Window 

                Public base classes

                class widget_object<frame_tag>: public
                widget

                Members

                            frame()
                        
                            The construction.
                    
                            frame(window wd, bool visible)
                        
                            Creates a frame.
                    
                            frame(window wd, const rectangle& r = rectangle(), bool visible = true)
                        
                            Ditto.
                    
                            bool insert(nana::gui::native_window_type wnd)
                        
                            Inserts a platform native window.
                    
                            nana::gui::native_window_type element(unsigned index)
                        
                            Returns the child window through index.
                    
                            nana::gui::native_window_type container() const
                        
                            Returns the frame container native window handle.
                    
                File

                nana/gui/widgets/frame.hpp

                Notes

                1. nana::gui::native_window_type is a type of system handle of windows.

                2. all the children windows of a nana::gui::frame is topmost to Nana.GUI windows.

                3. a simple example. Displaying a Windows Edit Control.

                    nana::gui::frame frame(parent, 0, 0 200, 100);

                    HWND frame_handle = reinterpret_cast<HWND>(frame.container());

                    HWND edit = ::CreateWindowExW(WS_EX_CLIENTEDGE, L"EDIT", L"Test",

                        WS_CHILD | WS_VISIBLE | WS_BORDER, 0, 0, 200, 100,
                
                        frame_handle, 0, ::GetModuleHandle(0), 0);
                
                    if(edit)

                        frame.insert(edit);

                See also

                frame

                Move to The Nana Programmer's Guide Main Page