CFrameWnd::Create

BOOL Create( LPCTSTR lpszClassName, LPCTSTR lpszWindowName, DWORD dwStyle = WS_OVERLAPPEDWINDOW, const RECT& rect = rectDefault, CWnd* pParentWnd = NULL, LPCTSTR lpszMenuName = NULL, DWORD dwExStyle = 0, CCreateContext* pContext = NULL );

Возвращаемое значение

Ненулевое, если инициализация прошла успешно, и нулевое в противном случае.

Аргументы

0. lpszClassName — указатель на завершающуюся нулём символьную строку, содержащую имя класса Windows. Имя класса может представлять собой любое имя, зарегистрированное в глобальной функции AfxRegisterWndClass или в функции Windows RegisterClass. Если этот параметр равен нулю, то используются атрибуты, установленные по умолчанию для класса CFrameWnd.

1. lpszWindowName — указатель на кончающуюся нулём символьную строку, содержащую имя окна. Используется для вывода заголовка окна.

2. dwStyle — определяет атрибуты стиля окна. . Чтобы иметь возможность автоматически выводить в заголовок окна имя отображаемого в нём документа, установите стиль FWS_ADDTOTITLE.

3. rect — определяет размер и положение окна на экране. Использование переменной rectDefault позволяет Windows определить размер и положение нового окна.

4. pParentWnd — определяет родительское окно. Для главного окна программы этот аргумент равен нулю.

5. lpszMenuName — определяет имя ресурса меню, используемого совместно с данным окном. Чтобы использовать целочисленный идентификатор ресурса вместо строки текста, используйте макрос MAKEINTRESOURCE. Данный аргумент может принимать нулевое значение.

6. dwExStyle — определяет атрибуты расширенного стиля окна.

7. pContext — указатель на объект структуры CCreateContext. Данный аргумент может принимать нулевое значение.

Примечание

Создание объекта класса, производного от CFrameWnd производится в два этапа. Сначала вызывается конструктор, создающий объект класса CFrameWnd, а затем вызывается функция Create, загружающая главное окно приложения и связанные с ним ресурсы и ассоциирует загруженное окно объекту, производному от класса CMainFrame. Данная функция позволяет определить имя класса окна, заголовок окна, определить параметры стиля окна, его родительское окно и связанный с ним ресурс меню.

Использование функции LoadFrame вместо Create позволяет загрузить окно, используя файл ресурсов вместо непосредственного задания соответствующих аргументов.

CFrameWnd::DockControlBar

void DockControlBar( CControlBar * pBar, UINT nDockBarID = 0, LPCRECT lpRect = NULL );

Аргументы

0. pBar — указатель на объект класса CControlBar, панель которого необходимо фиксировать.

1. nDockBarID — определяет сторону рабочей области окна, на которой будет произведена фиксация. Данный аргумент может принимать одно из перечисленных ниже значений:

• AFX_IDW_DOCKBAR_TOP — фиксирует панель управления на верхней стороне главного окна приложения.

• AFX_IDW_DOCKBAR_BOTTOM — фиксирует панель управления на нижней стороне главного окна приложения.

• AFX_IDW_DOCKBAR_LEFT — фиксирует панель управления на левой стороне главного окна приложения.

• AFX_IDW_DOCKBAR_RIGHT — фиксирует панель управления на правой стороне главного окна приложения.

• 0 — панель управления может быть зафиксирована на любой стороне, разрешённой для фиксации в данном окне.

0. lpRect — определяет в экранных координатах положение, в котором панель управления будет зафиксирована в служебной области данного окна.

Примечание

Фиксирует указанную панель управления в главном окне приложения. Панель управления может быть зафиксирована на любой стороне главного окна приложения, определённой для этой цели как в соответствующей функции CControlBar::EnableDocking, так и в соответствующей функции CFrameWnd::EnableDocking. Сторона, на которой производится фиксация, определяется аргументом nDockBarID.