Поделиться через

Общие справочники по элементу управления

В этом разделе содержатся справочные сведения о элементах программирования, которые применяются к нескольким элементам управления, а не только к конкретному элементу управления. Существуют функции, макросы, сообщения, уведомления и структуры, которые поддерживают большинство элементов управления. Например, большинство элементов управления используют уведомления NM_HOVER для обработки щелчков мыши.

Общие сведения

Тема Содержание
Общие элементы управления Общие элементы управления — это набор окон, реализованных общей библиотекой элементов управления, которая является библиотекой DLL, включенной в операционную систему Windows.
Часто задаваемые вопросы о распространенных элементах управления В этой статье приведены ответы на некоторые распространенные вопросы об общих элементах управления.

Functions

Тема Содержание
DoReaderMode Включает режим чтения в окне.
DPA_Clone Дублирует динамический массив указателей (DPA).
DPA_Create Создает DPA.
DPA_CreateEx Создает DPA с помощью заданного размера и расположения кучи.
DPA_DeleteAllPtrs Удаляет все элементы из DPA и сжимает DPA соответствующим образом.
DPA_DeletePtr Удаляет элемент из DPA. DPA сжимается при необходимости, чтобы разместить удаленный элемент.
DPA_Destroy Освобождает динамический массив указателей (DPA).
DPA_DestroyCallback Вызывает pfnCB на каждом элементе DPA, а затем освобождает DPA.
DPA_EnumCallback Выполняет итерацию по массиву динамических указателей (DPA) и вызывает pfnCB для каждого элемента.
DPA_GetPtr Возвращает элемент из DPA.
DPA_GetPtrIndex Возвращает индекс соответствующего элемента, найденного в DPA.
DPA_GetSize Возвращает размер DPA.
DPA_Grow Изменяет количество указателей в DPA.
DPA_InsertPtr Вставляет новый элемент в указанное положение в DPA. При необходимости DPA расширяется для размещения нового элемента.
DPA_LoadStream Загружает DPA из потока, вызвав указанную функцию обратного вызова для чтения каждого элемента.
DPA_Merge Объединяет содержимое двух ЦП.
DPA_SaveStream Сохраняет DPA в поток, записывая заголовок, а затем вызывая указанную функцию обратного вызова для записи каждого элемента.
DPA_Search Находит элемент в DPA.
DPA_SetPtr Назначает значение элементу в DPA.
DPA_Sort Сортирует элементы в динамическом массиве указателей (DPA).
DrawShadowText Рисует текст с тенью.
DrawTextExPrivWrap Рисует форматированный текст в указанном прямоугольнике. Эта функция выполняет оболочку вызова в DrawTextEx.
DrawTextWrap Рисует форматированный текст в указанном прямоугольнике. Он форматирует текст в соответствии с указанным методом (расширяющие вкладки, оправдывающие символы, критические строки и т. д.). Эта функция упаковывает вызов в DrawText.
DSA_Clone Дублирует динамический массив структур (DSA).
DSA_Create Создает DSA.
DSA_DeleteAllItems Удаляет все элементы из DSA.
DSA_DeleteItem Удаляет элемент из DSA.
DSA_Destroy Освобождает DSA.
DSA_DestroyCallback Выполняет итерацию через DSA, вызывая указанную функцию обратного вызова для каждого элемента. После достижения конца массива dsA освобождается.
DSA_EnumCallback Выполняет итерацию по DSA и вызывает pfnCB для каждого элемента.
DSA_GetItem Возвращает элемент из DSA.
DSA_GetItemPtr Возвращает указатель на элемент из DSA.
DSA_GetSize Возвращает размер DSA.
DSA_InsertItem Вставляет новый элемент в DSA. При необходимости DSA расширяется для размещения нового элемента.
DSA_SetItem Задает содержимое элемента в DSA.
DSA_Sort Сортирует элементы в DSA.
ExtTextOutWrap Рисует текст с помощью выбранного в данный момент шрифта, цвета фона и цвета текста. При необходимости можно указать измерения, используемые для обрезки, непрозрачности или обоих. Эта функция выполняет оболочку вызова extTextOut.
GetEffectiveClientRect Вычисляет размеры прямоугольника в клиентской области, содержащей все указанные элементы управления.
GetMUILanguage Получает язык, используемый общими элементами управления для определенного процесса.
GetTextExtentPoint32Wrap Вычисляет ширину и высоту указанной строки текста. Эта функция выполняет оболочку вызова GetTextExtentPoint.
InitCommonControls Регистрирует и инициализирует некоторые распространенные классы окна управления. Эта функция устарела. Новые приложения должны использовать функцию InitCommonControlsEx .
InitCommonControlsEx Регистрирует определенные общие классы элементов управления из библиотеки DLL общего элемента управления.
InitMUILanguage Позволяет приложению указывать язык для использования с общими элементами управления, отличающимися от системного языка.
LoadIconMetric Загружает указанный ресурс значка с помощью заданной клиентом системной метрики.
LoadIconWithScaleDown Загружает значок. Если значок не является стандартным, эта функция масштабирует более крупный образ, а не масштабирует меньшее изображение.
MirrorIcon Отменяет (зеркальные) значки, чтобы они отображались правильно в контексте зеркального устройства.
PFNDACOMPARE Определяет прототип функции сравнения, используемой DSA_Sort.
PFNDACOMPARECONST Определяет прототип функции сравнения, используемой DSA_Sort при сравнении элементов являются константными объектами.
PFNDAENUMCALLBACK Определяет прототип функции обратного вызова, используемой функциями DSA и DPA.
PFNDAENUMCALLBACKCONST Определяет прототип функции обратного вызова, используемой функциями DSA и DPA, когда элементы, участвующие в них, являются указателями на константные данные.
PFNDPACOMPARE Определяет прототип функции сравнения, используемой DPA_Sort и DPA_Search.
PFNDPACOMPARECONST Определяет прототип функции сравнения, используемой DPA_Sort или DPA_Search при сравнении элементов являются константными объектами.
PFNDPAENUMCALLBACK Определяет прототип функции обратного вызова, используемой DPA_EnumCallback.
PFNDPAMERGE Определяет прототип функции слияния, используемой DPA_Merge.
PFNDPAMERGECONST Определяет прототип функции слияния, используемой DPA_Merge с помощью константных значений.
PFNDPASTREAM Определяет прототип функции обратного вызова, используемой DPA_LoadStream и DPA_SaveStream.
PFNDSAENUMCALLBACK Определяет прототип функции обратного вызова, используемой DSA_DestroyCallback.
ЧитательScroll Определяемая приложением функция обратного вызова, используемая при перемещении указателя мыши в пределах части окна режима чтения, объявленного в качестве активной области прокрутки.
ShowHideMenuCtl Задает или удаляет атрибут флажка указанного элемента меню и отображает или скрывает соответствующий элемент управления. Функция добавляет флажок в указанный пункт меню, если он не имеет одного, а затем отображает соответствующий элемент управления. Если элемент меню уже имеет флажок, функция удаляет флажок и скрывает соответствующий элемент управления.
Str_GetPtr Копирует строку из одного буфера в другой.
Str_SetPtrW При необходимости задает ppszCurrent копию pszNew и освобождает предыдущее значение.
ПереводDispatch Используется клиентом функции DoReaderMode для перехвата и явного обработки сообщений Windows, предназначенных для области прокрутки окна режима чтения. Это определяемая приложением функция обратного вызова.

Macros

Тема Содержание
DPA_AppendPtr Вставляет новый элемент в конец DPA.
DPA_FastDeleteLastPtr Удаляет последний указатель из DPA.
DPA_FastGetPtr Возвращает значение указанного указателя в DPA.
DPA_GetPtrCount Возвращает количество указателей в DPA.
DPA_GetPtrPtr Возвращает указатель на внутренний массив указателя DPA.
DPA_SetPtrCount Задает количество указателей в DPA.
DPA_SortedInsertPtr Вставляет новый элемент до или после указанного существующего элемента.
DSA_AppendItem Добавляет новый элемент в конец DSA.
DSA_GetItemCount Возвращает количество элементов в DSA.
FORWARD_WM_NOTIFY Отправляет или публикует сообщение WM_NOTIFY .
HANDLE_WM_NOTIFY Вызывает функцию, обрабатывающую сообщение WM_NOTIFY .
INDEXTOSTATEIMAGEMASK Подготавливает индекс изображения состояния, чтобы элемент управления представления дерева или элемента управления представлением списка можно использовать индекс для получения образа состояния для элемента.

Messages

Тема Содержание
CCM_DPISCALE Включает автоматическое масштабирование с высокими точками на дюйм в элементах управленияTree-View, List-View элементов управления, элементы управления ComboBoxEx, элементы управления заголовка, кнопки, элементы управления панели инструментов, элементы управленияанимацией и списки изображений.
CCM_GETUNICODEFORMAT Возвращает флаг формата символов Юникода для элемента управления.
CCM_GETVERSION Возвращает номер версии для элемента управления, заданного последним сообщением CCM_SETVERSION .
CCM_SETUNICODEFORMAT Задает флаг формата символов Юникода для элемента управления. Это сообщение позволяет изменить набор символов, используемый элементом управления во время выполнения, а не повторно создать элемент управления.
CCM_SETVERSION Это сообщение используется для информирования элемента управления о том, что ожидается поведение, связанное с определенной версией.
CCM_SETWINDOWTHEME Задает визуальный стиль элемента управления.
WM_NOTIFY Отправляемый общим элементом управления в родительское окно, когда произошло событие или элемент управления требует некоторых сведений.
WM_NOTIFYFORMAT Определяет, принимает ли окно структуры ANSI или Юникода в сообщении WM_NOTIFY уведомления. WM_NOTIFYFORMAT сообщения отправляются из общего элемента управления в родительское окно и из родительского окна в общий элемент управления.

Notifications

Тема Содержание
NM_CHAR Код уведомления NM_CHAR отправляется элементом управления при обработке символьного ключа. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_CUSTOMDRAW Уведомляет родительское окно элемента управления о пользовательских операциях рисования. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_CUSTOMTEXT Уведомляет родительское окно элемента управления о пользовательских текстовых операциях. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_FONTCHANGED Отправляется элементом управления представления списка при изменении шрифта элемента управления. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_GETCUSTOMSPLITRECT Отправляется элементом управления кнопки в родительский элемент управления, чтобы получить измерения для двух прямоугольников, составляющих кнопку разделения. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_HOVER Отправляется элементом управления при наведении указателя мыши на элемент. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_KEYDOWN Отправляется элементом управления, когда элемент управления имеет фокус клавиатуры, и пользователь нажимает клавишу. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_KILLFOCUS Уведомляет родительское окно элемента управления о том, что элемент управления потерял фокус ввода. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_LDOWN Уведомляет родительское окно элемента управления о нажатии левой кнопки мыши. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_NCHITTEST Отправляется элементом управления перенаправки, когда элемент управления получает сообщение WM_NCHITTEST . Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_OUTOFMEMORY Уведомляет родительское окно элемента управления о том, что элемент управления не мог завершить операцию, так как недостаточно памяти. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_RDOWN Не поддерживается в текущей версии.
NM_RELEASEDCAPTURE Уведомляет родительское окно элемента управления о том, что элемент управления освобождает запись мыши. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_RETURN Уведомляет родительское окно элемента управления о том, что элемент управления имеет фокус ввода и что пользователь нажимал клавишу ВВОД. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_SETCURSOR Уведомляет родительское окно элемента управления о том, что элемент управления задает курсор в ответ на сообщение NM_SETCURSOR . Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_SETFOCUS Уведомляет родительское окно элемента управления о том, что элемент управления получил фокус ввода. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_THEMECHANGED Уведомляет родительское окно элемента управления о том, что тема изменилась. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_TOOLTIPSCREATED Уведомляет родительское окно элемента управления о том, что элемент управления создал подсказку. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .
NM_TVSTATEIMAGECHANGING Отправляется элементом управления "Дерево- представление" в родительское окно, в которое изменяется изображение состояния. Этот код уведомления отправляется в виде сообщения WM_NOTIFY .

Структуры

Тема Содержание
COLORSCHEME Содержит сведения о рисовании кнопок на панели инструментов или панели.
DPASTREAMINFO Содержит элемент потока, используемый функцией обратного вызова PFNDPASTREAM .
INITCOMMONCONTROLSEX Содержит сведения, используемые для загрузки общих классов элементов управления из библиотеки динамических ссылок (DLL). Эта структура используется с функцией InitCommonControlsEx .
NMCHAR Содержит сведения, используемые с сообщениями уведомления о символах.
NMCUSTOMSPLITRECTINFO Содержит сведения о двух прямоугольниках разделенной кнопки. Отправлено с уведомлением NM_GETCUSTOMSPLITRECT .
NMCUSTOMTEXT Содержит сведения, используемые с пользовательским текстовым уведомлением.
NMHDR Содержит сведения о сообщении уведомления.
NMKEY Содержит сведения, используемые с сообщениями с ключевыми уведомлениями.
NMMOUSE Содержит сведения, используемые с сообщениями уведомления мыши.
NMOBJECTNOTIFY Содержит сведения, используемые с кодами уведомлений TBN_GETOBJECT, TCN_GETOBJECT и PSN_GETOBJECT .
NMTOOLTIPSCREATED Содержит сведения, используемые с кодом уведомлений NM_TOOLTIPSCREATED .
READERMODEINFO Содержит сведения, необходимые для инициализации функции DoReaderMode .

Constants

Тема Содержание
Константы CDRF Эти константы используются в качестве возвращаемых значений элементом управления в ответ на код уведомления NM_CUSTOMDRAW .
Стили В этом разделе перечислены распространенные стили элементов управления. За исключением отмеченных, эти стили применяются к элементам управления заголовкам, элементам управления панели инструментов и окнам состояния.
Классы окон В этом разделе перечислены имена классов окон, предоставляемые общей библиотекой элементов управления.
  • Last updated on