TdxCustomRibbon.DefaultUseGlobalSkin Property

Specifies if all Ribbon controls in the application automatically update their appearance from the skin and palette defined application-wide.

Declaration

class property DefaultUseGlobalSkin: TdxDefaultBoolean read; write; default bDefault;

Property Value

Type	Default	Description
TdxDefaultBoolean	bDefault	bDefault The cxDefaultUseGlobalSkin global constant specifies if Ribbon controls automatically import the global skin and palette and use them instead of their color ColorSchemeName and ColorSchemeAccent properties. bTrue All Ribbon controls whose UseGlobalSkin property is set to bDefault automatically import the global skin and palette defined through a TdxSkinController component. The ColorSchemeName property automatically synchronizes with SkinName property of a TdxSkinController component, and the ColorSchemeAccent property has no effect. This option is useful if you need to ensure visual consistency of your application. bFalse All Ribbon controls whose UseGlobalSkin property is set to bDefault use their ColorSchemeName and ColorSchemeAccent properties as skin settings. The active skin and palette defined through a TdxSkinController component have no effect on these Ribbon controls. This option is useful if you need to apply individual appearance settings to Ribbon controls.

Remarks

A TdxRibbon control can have individual look & feel settings or synchronize with the active skin and palette specified through a TdxSkinController component (recommended).

You can set the DefaultUseGlobalSkin class property to bTrue or bFalse at application startup to explicitly enable or disable synchronization with global skin settings for all Ribbon controls in the application. The UseGlobalSkin property allows you to override the DefaultUseGlobalSkin setting at the level of individual Ribbon controls.

Code Example

The following code example changes the DefaultUseGlobalSkin class property value to bFalse in the initialization section of the main application unit:

Delphi

uses
  Forms,
  dxRibbon, // Declares the TdxCustomRibbon.DefaultUseGlobalSkin class property
// ...
begin
  TdxCustomRibbon.DefaultUseGlobalSkin := bFalse;
  Application.Initialize;
  Application.MainFormOnTaskbar := True;
  Application.CreateForm(TMyForm, MyForm);
  Application.Run;
end.

C++

#include <vcl.h>
#include "dxRibbon.hpp"  // Declares the TdxCustomRibbon::DefaultUseGlobalSkin class property
#pragma hdrstop
#include <tchar.h>
//---------------------------------------------------------------------------
USEFORM("Unit1.cpp", Form1);
//---------------------------------------------------------------------------
int WINAPI _tWinMain(HINSTANCE, HINSTANCE, LPTSTR, int)
{
      TdxCustomRibbon::DefaultUseGlobalSkin = bFalse;          
      Application->Initialize();
      Application->MainFormOnTaskBar = true;
      Application->CreateForm(__classid(TMyForm), &MyForm);
      Application->Run();
    }
}
    // ...

Default Value

The DefaultUseGlobalSkin property’s default value is bDefault.

The default property value indicates that the cxDefaultUseGlobalSkin global constant specifies if Ribbon controls automatically import global skin and palette settings.