Метод IDCompositionVisual::SetBorderMode (dcomp.h)

Задает свойство BorderMode, указывающее способ создания краев растровых изображений и клипов, связанных с этим визуальным элементом или с визуальными элементами в поддереве, корнями которых является данный визуальный элемент.

Синтаксис

HRESULT SetBorderMode(
  [in] DCOMPOSITION_BORDER_MODE borderMode
);

Параметры

[in] borderMode

Тип: DCOMPOSITION_BORDER_MODE

Используемый режим границы.

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

Тип: HRESULT

Если функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT . Список кодов ошибок см. в разделе Коды ошибок DirectComposition .

Комментарии

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

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

Если параметр borderMode имеет значение, отличное от DCOMPOSITION_BORDER_MODE_INHERIT, то растровое изображение и клип этого визуального элемента состоят из указанного режима границы. Кроме того, этот режим границы становится новым значением по умолчанию для дочерних элементов текущего визуального элемента. То есть, если режим границ дочерних элементов этого визуального элемента не изменяется или явно задан в DCOMPOSITION_BORDER_MODE_INHERIT, то растровые изображения и клипы дочерних визуальных элементов создаются с помощью режима границ этого визуального элемента.

Требования

См. также раздел

IDCompositionVisual