Стили статических элементов управления

Чтобы создать статический элемент управления с помощью функции CreateWindow или CreateWindowEx, укажите статический класс, соответствующие константы стиля окна и сочетание следующих стилей статических элементов управления.

Константа Description
SS_BITMAP
Растровое изображение должно отображаться в статическом элементе управления. Текст — это имя растрового изображения (а не имени файла), определенного в другом месте файла ресурса. Стиль игнорирует параметры nWidth и nHeight. Элемент управления автоматически масштабирует себя для размещения растрового изображения.
SS_BLACKFRAME
Поле с кадром, нарисованным в том же цвете, что и рамки окна. Этот цвет черный в цветовой схеме по умолчанию.
SS_BLACKRECT
Прямоугольник, заполненный текущим цветом рамки окна. Этот цвет черный в цветовой схеме по умолчанию.
SS_CENTER
Простой прямоугольник и центрируется текст в прямоугольнике. Текст отформатирован перед отображением. Слова, расширяющие конец строки, автоматически упаковываются в начало следующей по центру строки. Слова, длиннее ширины элемента управления, усечены.
SS_CENTERIMAGE
Растровое изображение по центру находится в статическом элементе управления, который содержит его. Элемент управления не изменяется, поэтому растровое изображение слишком большое для элемента управления будет обрезано. Если статический элемент управления содержит одну строку текста, текст находится в центре в клиентской области элемента управления.
SS_EDITCONTROL
Статический элемент управления дублирует характеристики отображения текста многострочного элемента управления редактирования. В частности, средняя ширина символов вычисляется так же, как и с элементом управления редактированием, а функция не отображает частично видимую последнюю строку.
SS_ENDELпакет интерфейса пользователя SIS
Если конец строки не помещается в прямоугольник, он усечен и многоточие добавляются. Если слово, которое не находится в конце строки, выходит за пределы прямоугольника, оно усечено без многоточия. При использовании этого стиля текст элемента управления будет находиться в одной строке без оболочки слова. Сравнение с SS_PATHELпакет интерфейса пользователя SIS и SS_WORDELпакет интерфейса пользователя SIS.
SS_ENHMETAFILE
Расширенный метафайл должен отображаться в статическом элементе управления. Текст — это имя метафайла. Расширенный статический элемент управления метафайла имеет фиксированный размер; Метафайл масштабируется для соответствия клиентской области статического элемента управления.
SS_ETCHEDFRAME
Рисует кадр статического элемента управления с помощью стиля EDGE_ETCHED края. Дополнительные сведения см. в функции DrawEdge.
SS_ETCHEDHORZ
Рисует верхние и нижние края статического элемента управления с помощью стиля EDGE_ETCHED края. Дополнительные сведения см. в функции DrawEdge.
SS_ETCHEDVERT
Рисует левые и правые края статического элемента управления с помощью стиля EDGE_ETCHED края. Дополнительные сведения см. в функции DrawEdge.
SS_GRAYFRAME
Поле с кадром, нарисованным с тем же цветом, что и фон экрана (рабочий стол). Этот цвет серый в цветовой схеме по умолчанию.
SS_GRAYRECT
Прямоугольник, заполненный текущим цветом фона экрана. Этот цвет серый в цветовой схеме по умолчанию.
SS_ICON
Значок, отображаемый в диалоговом окне. Если элемент управления создается как часть диалогового окна, текст — это имя значка (а не имени файла), определенного в другом месте файла ресурса. Если элемент управления создается с помощью CreateWindow или связанной функции, текст — это имя значка (а не имени файла), определенного в файле ресурсов, связанном с модулем, указанным параметром hInstance для CreateWindow.
Значок может быть анимированным курсором.
Стиль игнорирует параметры CreateWindow nWidth и nHeight; элемент управления автоматически размеров для размещения значка. Так как она использует функцию LoadIcon, стиль SS_ICON может загружать только значки измерений SM_CXICON и SM_CYICON. Это ограничение можно обойти с помощью стиля SS_REALSIZEIMAGE в дополнение к SS_ICON.
Если значок не может быть загружен через LoadIcon, попытка загрузить указанный ресурс в качестве курсора с помощью LoadCursor. Если это тоже завершается ошибкой, попытка загрузить из драйвера устройства с помощью LoadImage.
SS_LEFT
Простой прямоугольник и левый выравнивает текст в прямоугольнике. Текст отформатирован перед отображением. Слова, расширяющие конец строки, автоматически упаковываются в начало следующей левой линии. Слова, длиннее ширины элемента управления, усечены.
SS_LEFTNOWORDWRAP
Простой прямоугольник и левый выравнивает текст в прямоугольнике. Вкладки развернуты, но слова не упаковываются. Текст, расширяющийся до конца строки, обрезается.
SS_NOPREFIX
Запрещает интерпретацию любых амперсанд (&) символов в тексте элемента управления в виде префиксов акселератора. Они отображаются с амперсандом, а следующий символ в строке подчеркнут. Этот стиль статического элемента управления может быть включен в любой из определенных статических элементов управления. Вы можете объединить SS_NOPREFIX с другими стилями. Это может быть полезно при отображении имен файлов или других строк, которые могут содержать амперсанд (&) в статическом элементе управления в диалоговом окне.
SS_NOTIFY
Отправляет родительское окно STN_CLICKED, STN_DBLCLK, STN_DISABLE и коды уведомлений STN_ENABLE, когда пользователь щелкает элемент управления или дважды щелкает элемент управления.
SS_OWNERDRAW
Владелец статического элемента управления отвечает за рисование элемента управления. Окно владельца получает сообщение WM_DRAWITEM всякий раз, когда элемент управления должен быть нарисован.
SS_PATHELпакет интерфейса пользователя SIS
Заменяет символы в середине строки многоточием, чтобы результат соответствовал указанному прямоугольнику. Если строка содержит символы обратной косой черты (\), SS_PATHELпакет интерфейса пользователя SIS сохраняет как можно больше текста после последней обратной косой черты. При использовании этого стиля текст элемента управления будет находиться в одной строке без оболочки слова. Сравнение с SS_ENDELпакет интерфейса пользователя SIS и SS_WORDELпакет интерфейса пользователя SIS.
SS_REALSIZECONTROL
Настраивает растровое изображение в соответствии с размером статического элемента управления. Например, изменение языкового стандарта может изменить системный шрифт, поэтому элементы управления могут быть изменены. Если статический элемент управления имеет растровое изображение, то растровое изображение больше не будет соответствовать элементу управления. Этот бит стиля определяет автоматическое переименовывание растровых изображений для соответствия их элементам управления.
Если указан SS_CENTERIMAGE , по центру отображается растровое изображение или значок (и при необходимости обрезается). Если SS_CENTERIMAGE не задано, растровое изображение или значок растягивается или сужается.
Обратите внимание, что переименовывание в двух осях независимы, а результат может иметь измененное соотношение аспектов.
Сравнение с SS_REALSIZEIMAGE.
SS_REALSIZEIMAGE
Указывает, что используется фактическая ширина ресурса, а значок загружается с помощью LoadImage. SS_REALSIZEIMAGE всегда используется в сочетании с SS_ICON.
SS_REALSIZEIMAGE использует LoadImage, переопределяя процесс, который обычно следует за SS_ICON. Он не загружает курсоры; Если LoadImage завершается сбоем, никакие дальнейшие попытки загрузки не выполняются. В нем используется фактическая ширина ресурса. Статический элемент управления изменяется соответствующим образом, но значок остается выровненным по исходному левому краю и верхним краям элемента управления.
Обратите внимание, что если SS_CENTERIMAGE также указан, значок находится в пространстве элемента управления, который был указан с помощью параметров CreateWindow nWidth и nHeight.
Сравнение с SS_REALSIZECONTROL.
SS_RIGHT
Простой прямоугольник и правый выравнивание текста в прямоугольнике. Текст отформатирован перед отображением. Слова, расширяющие конец строки, автоматически упаковываются в начало следующей выровненной по правому краю строки. Слова, длиннее ширины элемента управления, усечены.
SS_RIGHTJUST
Правый нижний угол статического элемента управления со стилем SS_BITMAP или SS_ICON должен оставаться фиксированным при изменении размера элемента управления. Только верхние и левые стороны корректируются для размещения новой растровой карты или значка.
SS_SIMPLE
Простой прямоугольник и отображает одну строку выровненного по левому краю текста в прямоугольнике. Текстовая строка не может быть сокращена или изменена каким-либо образом. Кроме того, если элемент управления отключен, элемент управления не серит его текст.
SS_SUNKEN
Рисует полузащитную границу вокруг статического элемента управления.
SS_TYPEMASK
Бит составного стиля, который приводит к использованию оператора OR в битах стиля SS_*. Можно использовать для маскирования допустимых SS_* битов из заданной битовой маски. Обратите внимание, что это устарело и не правильно включает все допустимые стили. Таким образом, этот стиль не следует использовать.
SS_WHITEFRAME
Поле с кадром, нарисованным с тем же цветом, что и фон окна. Этот цвет является белым в цветовой схеме по умолчанию.
SS_WHITERECT
Прямоугольник, заполненный текущим цветом фона окна. Этот цвет является белым в цветовой схеме по умолчанию.
SS_WORDELпакет интерфейса пользователя SIS
Усечение любого слова, которое не помещается в прямоугольник и добавляет многоточие. При использовании этого стиля текст элемента управления будет находиться в одной строке без оболочки слова.
Сравнение с SS_ENDELпакет интерфейса пользователя SIS и SS_PATHELпакет интерфейса пользователя SIS.

Замечания

Чтобы использовать стиль, который усечение слов или строк с многострочного текста, DrawThemeText или DrawText можно использовать в элементе управления "Рисование владельца" с флагами форматирования DT_WORDBREAK и набором DT_ENDELпакет интерфейса пользователя SIS.

Requirements

Требование Значение
Минимальная версия клиента
Windows Vista [только классические приложения]
Минимальная версия сервера
Windows Server 2003 [только классические приложения]
Верхний колонтитул
Winuser.h (включая Windows.h)