TN029: Разделитель окон Windows

2023-10-12

В этой заметке описывается класс MFC CSplitterWnd, который обеспечивает разделение окон и управление изменением размера других окон панели.

Стили разделения

A CSplitterWnd поддерживает два разных стиля разбиения окон.

В категории "статические разделители" окно разделителя создаёт панели в момент создания. Порядок и количество панелей никогда не изменяются. Полосы разделения используются для изменения размера разных панелей. Этот стиль можно использовать для отображения другого класса представления на каждой панели. Графический редактор Visual C++ и диспетчер файлов Windows являются примерами программ, использующих этот стиль разделения. Этот стиль окна разделения не использует поля разделения.

В "динамических разделителях" дополнительные панели создаются и уничтожаются по мере того, как пользователь разделяет и отменяет разделение новых представлений. Этот разделитель имеет одно представление и предоставляет пользователю разделительные рамки для начала процесса разделения. Окно разбиения динамически создает новый объект представления, если представление разделено в одном направлении. Этот новый объект представления представляет новую панель. Если представление разделено в двух направлениях с помощью интерфейса клавиатуры, окно разделения создает три новых объекта представления для трех новых областей. Хотя разделение активно, Windows отображает поле разбиения в виде полосы разделения между панелями. Windows уничтожает дополнительные объекты представления, когда пользователь удаляет разделение, но исходное представление остается до тех пор, пока окно разделения не будет уничтожено. Microsoft Excel и Microsoft Word — это примеры приложений, использующих динамический стиль разделения.

При создании любого типа окна разбиения необходимо указать максимальное количество строк и столбцов, которыми будет управлять разделитель. Статический разделитель создаст панели для заполнения всех строк и столбцов. Динамический разделитель создаст только первую панель при создании CSplitterWnd.

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

1 строка x 2 столбца: обычно с разнородными панелями
2 строки x 1 столбца: обычно с разнородными панелями
2 строки x 2 столбца: обычно с аналогичными панелями

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

1 строка x 2 столбца: для табличных данных
2 строки x 1 столбца: для текстовых или других данных
2 строки x 2 столбца: для сетки или табличных данных

Примеры сплиттера

Многие примеры программ MFC используют окна разделения напрямую или косвенно. В примере MFC VIEWEX показано несколько способов использования статических разделителей, включая размещение разделителя внутри другого разделителя.

Вы также можете использовать ClassWizard для создания нового класса дочернего окна фрейма множественного интерфейса документов (MDI), содержащего окно разделителя. Дополнительные сведения о окнах разбиения см. в разделе "Несколько типов документов", "Представления" и "Кадры".

Терминология, используемая реализацией

Ниже приведен список терминов, характерных для разделителей окон:

CSplitterWnd: окно, включающее элементы управления разделением области и полосы прокрутки, которые совместно используются между всеми панелями в строке или столбце. Строки и столбцы отсчитываются от нуля (первая ячейка: строка = 0 и столбец = 0).

Область: окно, специфичное для приложения, которое управляет CSplitterWnd. Область обычно является объектом, производным от класса CView, но может быть любым объектом CWnd , который имеет соответствующий идентификатор дочернего окна.

Чтобы использовать производный CWndобъект, передайте RUNTIME_CLASS объекта в CreateView функцию, как было бы, если бы вы использовали производный CViewкласс. Класс должен использовать DECLARE_DYNCREATE и IMPLEMENT_DYNCREATE, так как платформа использует динамическое создание во время выполнения. Хотя в CSplitterWnd много кода, специфичного для класса CView, CObject::IsKindOf всегда используется перед выполнением указанных операций.

Разделитель панели: элемент управления, расположенный между строками и столбцами панелей. Его можно использовать для настройки размеров строк или столбцов панелей.

Splitter Box: элемент управления в динамическом CSplitterWnd объекте, который можно использовать для создания новых строк или столбцов панелей. Он расположен в верхней части вертикальных полос прокрутки или слева от горизонтальных полос прокрутки.

Пересечение разбиения: пересечение вертикальной полосы разбиения и горизонтальной полосы разбиения. Вы можете перетащить его, чтобы изменить размер строки и столбца панелей одновременно.

Общие полосы прокрутки

Класс CSplitterWnd также поддерживает общие полосы прокрутки. Эти элементы управления полосой прокрутки являются дочерними элементами CSplitterWnd и совместно используются различными панелями в разделителе.

Например, в окне размером 1 строка x 2 столбца можно указать WS_VSCROLL при создании CSplitterWnd. Windows создает специальный элемент управления полосой прокрутки, совместно используемый между двумя панелями.

[      ][      ][^]
[pane00][pane01][|]
[      ][      ][v]

Когда пользователь перемещает полосу прокрутки, сообщения WM_VSCROLL будут отправляться в оба представления. Если любое представление задает позицию полосы прокрутки, будет задана общая полоса прокрутки.

Обратите внимание, что общие полосы прокрутки наиболее полезны для аналогичных объектов представления. Если вы смешиваете виды представлений разных типов в разделителе, может потребоваться написать специальный код для координации их позиций прокрутки. Любой CView производный класс, использующий API CWnd полосы прокрутки, будет использовать обобщённую полосу прокрутки, если она существует. Реализация CScrollView является одним из примеров CView класса, который поддерживает общие полосы прокрутки. Классы, не производные от CView, классы, полагающиеся на элементы управления, не относящиеся к полосам прокрутки, или классы, использующие стандартные реализации Windows (например, CEditView), не будут работать с функцией общей полосы прокрутки в CSplitterWnd.

Минимальные размеры

Для каждой строки имеется минимальная высота строки, а для каждого столбца — минимальная ширина столбца. Это минимальное пороговое значение гарантирует, что панель не слишком мала, чтобы отображаться в полном объёме.

Для окна статического разбиения начальная минимальная высота строки и ширина столбца равна 0. Для динамического окна разделения начальная минимальная высота строки и ширина столбца задаются параметром CSplitterWnd::Create функции.

Эти минимальные размеры можно изменить с помощью функций CSplitterWnd::SetRowInfo и CSplitterWnd::SetColumnInfo .

Фактические и идеальные размеры

Макет панелей в окне разделителя зависит от размера кадра, содержащего их. Когда пользователь изменяет размер вмещающей рамки, CSplitterWnd изменяет положение и размер панелей так, чтобы они максимально подходили.

Пользователь может вручную задать размеры строк и ширины столбцов, или программа может задать идеальный размер с помощью CSplitterWnd класса. Фактический размер может быть меньше или больше идеала. Windows настраивает фактический размер, если недостаточно места для отображения идеального размера или если в правой или нижней части окна разбиения слишком много пустого места.

Пользовательские элементы управления

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

virtual void OnDrawSpltter(CDC* pDC, ESplitType nType, const CRect& rect);
virtual void OnInvertTracker(const CRect& rect);

Эта функция вызывается для создания общего элемента управления полосой прокрутки. Вы можете переопределить его, чтобы создать дополнительные элементы управления рядом с полосой прокрутки.

virtual BOOL CreateScrollBarCtrl(DWORD dwStyle, UINT nID);

Эти функции реализуют логику окна динамического разделения. Их можно переопределить, чтобы обеспечить более расширенную логику разделения.

virtual void DeleteView(int row, int col);
virtual BOOL SplitRow(int cyBefore);
virtual BOOL SplitColumn(int cxBefore);
virtual void DeleteRow(int rowDelete);
virtual void DeleteColumn(int colDelete);

Функции CView

Класс CView использует следующие команды высокого уровня для делегирования реализации CSplitterWnd. Так как эти команды являются виртуальными, стандартная CView реализация не требует, чтобы вся CSplitterWnd реализация была связана. Для приложений, которые используют CView, но не CSplitterWnd, реализация CSplitterWnd не будет связана с приложением.

virtual BOOL CanActivateNext(BOOL bPrev = FALSE);

Проверяет, можно ли в данный момент использовать ID_NEXT_PANE или ID_PREV_PANE.
virtual void ActivateNext(BOOL bPrev = FALSE);

Выполняет команду "Следующая область" или "Предыдущая область".
virtual BOOL DoKeyboardSplit();

Выполняет команду разделения клавиатуры, обычно "Разделение окна".

См. также

Технические примечания по номеру
Технические заметки по категориям