IDCompositionVisual::SetBorderMode-Methode (dcomp.h)

Legt die BorderMode-Eigenschaft fest, die angibt, wie die Kanten von Bitmaps und Clips, die diesem Visual zugeordnet sind, oder mit Visuals in der Unterstruktur, die in diesem Visual verwurzelt sind, erstellt werden.

Syntax

HRESULT SetBorderMode(
  [in] DCOMPOSITION_BORDER_MODE borderMode
);

Parameter

[in] borderMode

Typ: DCOMPOSITION_BORDER_MODE

Der zu verwendende Rahmenmodus.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter DirectComposition-Fehlercodes .

Hinweise

Der Rahmenmodus wirkt sich darauf aus, wie die Kanten einer Bitmap zusammengesetzt werden, wenn die Bitmap transformiert wird, sodass die Kanten nicht genau achsenbündig und an präzisen Pixelgrenzen liegen. Es wirkt sich auch darauf aus, wie Inhalte an den Ecken eines Clips mit abgerundeten Ecken und am Rand eines Clips abgeschnitten werden, der so transformiert wird, dass die Kanten nicht genau achsenbündig und an präzisen Pixelgrenzen liegen.

Standardmäßig erbt ein Visual den Rahmenmodus des übergeordneten Visuals, das den Rahmenmodus des übergeordneten Visuals erben kann usw. Ein Visual verwendet den Standardrahmenmodus, wenn diese Methode nie für das Visual aufgerufen wird oder wenn diese Methode mit DCOMPOSITION_BORDER_MODE_INHERIT aufgerufen wird. Wenn keine Visuals den Rahmenmodus festlegen, ist die Standardeinstellung für die gesamte visuelle Struktur das Aliasrendering, das die niedrigste visuelle Qualität, aber die höchste Leistung bietet.

Wenn der borderMode-Parameter etwas anderes als DCOMPOSITION_BORDER_MODE_INHERIT ist, werden Bitmap und Clip dieses Visuals mit dem angegebenen Rahmenmodus zusammengesetzt. Darüber hinaus wird dieser Rahmenmodus zum neuen Standard für die untergeordneten Elemente des aktuellen Visuals. Das heißt, wenn der Rahmenmodus der untergeordneten Elemente dieses Visuals unverändert oder explizit auf DCOMPOSITION_BORDER_MODE_INHERIT festgelegt ist, werden die Bitmaps und Clips der untergeordneten Visuals im Rahmenmodus dieses Visuals erstellt.

Anforderungen

Weitere Informationen

IDCompositionVisual