Skip to main content

TdxRenderMode Enum

Enumerates render modes available for DevExpress controls.

Declaration

TdxRenderMode = (
    rmDefault,
    rmGDI,
    rmDirectX,
    rmGDIPlus
);

Members

Name Description
rmDefault

A control imports a render mode setting from the parent or global level.

If the global render mode is also rmDefault, the control uses the cxDefaultLookAndFeelRenderMode global constant value to determine the active render mode.

rmGDI

The GDI render mode is active. A control uses a combination of GDI and GDI+ API-based canvases to render content and UI elements.

All DevExpress controls support this render mode.

rmDirectX

The DirectX® render mode is active. A control that supports the DirectX® render mode uses a Direct2D-based canvas instead of a GDI-based canvas.

In this mode, an opaque Direct3D device context overlaps an existing GDI canvas, and the control’s Transparent property has no effect. All GDI and GDI+ draw routines accessible through the control’s Canvas and ActiveCanvas properties have no effect in DirectX® render mode.

Important

  • The DirectX® render mode is available only under Microsoft Windows® 7 Platform Update (with DirectX11®) and newer operating systems.

  • This mode is not supported at design time and has no effect on controls that cannot use a Direct2D-based canvas. A control with support for the DirectX® render mode uses GDI as a fallback render mode when it fails to create a Direct3D device context for any reason.

  • This mode is not supported if an application is in GDI Scaled mode because it draws DirectX-rendered controls unscaled at their original (unscaled) positions.

rmGDIPlus

The GDI+ render mode is active. A control that supports the GDI+ render mode creates a GDI+ API-based canvas instead of a GDI-based canvas.

The GDI+ render mode increases performance for all controls that display multiple semitransparent primitives (TdxChartControl or TdxTileControl, for instance). Unlike the GDI render mode, controls can also apply antialiasing to geometric primitives.

Remarks

The TcxLookAndFeel.RenderMode and TcxLookAndFeelController.RenderMode properties reference the TdxRenderMode type.

See Also