Skip to main content
A newer version of this page is available. .

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

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 mode.

rmDirectX

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

In this mode, an opaque Direct3D device context overlaps an existing GDI canvas, and the control’s Transparent property value is ignored as a result. All GDI and GDI+ draw routines accessible from the control’s Canvas and ActiveCanvas properties have no effect in DirectX render mode.

Note

  • DirectX render mode is available since Microsoft Windows® 7 Platform Update (with DirectX11).

  • 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 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

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

GDI+ render mode increases performance for all controls that display multiple semitransparent primitives (TdxTileControl and TdxTileBar, for instance). Unlike 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