Back to Devexpress

TdxBarManager.DefaultUseGlobalSkin Property

vcl-dxbar-dot-tdxbarmanager-a33d8c9a.md

latest6.6 KB
Original Source

TdxBarManager.DefaultUseGlobalSkin Property

Specifies if all Bar Manager components in the application automatically update their appearance from application-wide skin and palette settings.

Declaration

delphi
class property DefaultUseGlobalSkin: TdxDefaultBoolean read; write;

Property Value

TypeDescription
TdxDefaultBooleanbDefaultThe cxDefaultUseGlobalSkin global constant specifies if Bar Manager components automatically import global skin and palette settings and use them instead of the current Style.bTrue

All Bar Manager components automatically import global skin and palette settings defined using a TdxSkinController component or the Project Settings dialog.

This option is useful if you need to ensure visual consistency of your application.

bFalseAll Bar Manager components use global appearance settings only if their Style property is set to bmsUseLookAndFeel. |

Remarks

You can set the DefaultUseGlobalSkin property to bTrue or bFalse at application startup to explicitly enable or disable synchronization with global skin and palette settings for all toolbar UIs in the application.

Code Example: Disable Default Global Skin Usage Flags at Startup

The code example in this section changes the DefaultUseGlobalSkin class property value to bFalse in the initialization section of the main application unit for the following components: TdxBarManager, TdxRibbon, TdxStatusBar, TdxLayoutControl, and TdxNavBar.

Open the Project Source to Edit the Main Function

To open the main application unit of your project, you can use one of the following options:

  • Select ProjectView Source in the main menu of your RAD Studio IDE.

  • Select the target project in the Projects Window and press Ctrl + V (alternatively, you can display the context menu and select the View Source option).

  • Delphi

  • C++

delphi
uses
  Forms,
  dxBar, // Declares the TdxBarManager.DefaultUseGlobalSkin class property
  dxRibbon, // Declares the TdxCustomRibbon.DefaultUseGlobalSkin class property
  dxStatusBar, // Declares the TdxCustomStatusBar.DefaultUseGlobalSkin class property
  dxLayoutControl, // Declares the TdxCustomLayoutControl.DefaultUseGlobalSkin class property
  dxNavBar, // Declares the TdxCustomNavBar.DefaultUseGlobalSkin class property
// ...
begin
  TdxBarManager.DefaultUseGlobalSkin := bFalse;
  TdxCustomRibbon.DefaultUseGlobalSkin := bFalse;
  TdxCustomStatusBar.DefaultUseGlobalSkin := bFalse;
  TdxCustomLayoutControl.DefaultUseGlobalSkin := bFalse;
  TdxCustomNavBar.DefaultUseGlobalSkin := bFalse;
  Application.Initialize;
  Application.MainFormOnTaskBar := True;
  Application.CreateForm(TMyForm, MyForm);
  Application.Run;
end.
cpp
#include <vcl.h>
#include "dxBar.hpp" // Declares the TdxBarManager::DefaultUseGlobalSkin class property
#include "dxRibbon.hpp" // Declares the TdxCustomRibbon::DefaultUseGlobalSkin class property
#include "dxStatusBar.hpp" // Declares the TdxCustomStatusBar::DefaultUseGlobalSkin class property
#include "dxLayoutControl.hpp" // Declares the TdxCustomLayoutControl::DefaultUseGlobalSkin class property
#include "dxNavBar.hpp" // Declares the TdxCustomNavBar::DefaultUseGlobalSkin class property
#pragma hdrstop
#include <tchar.h>
//---------------------------------------------------------------------------
USEFORM("Unit1.cpp", Form1);
//---------------------------------------------------------------------------
int WINAPI _tWinMain(HINSTANCE, HINSTANCE, LPTSTR, int)
{
      TdxBarManager::DefaultUseGlobalSkin = bFalse;
      TdxCustomRibbon::DefaultUseGlobalSkin = bFalse;
      TdxCustomStatusBar::DefaultUseGlobalSkin = bFalse;
      TdxCustomLayoutControl::DefaultUseGlobalSkin = bFalse;
      TdxCustomNavBar::DefaultUseGlobalSkin = bFalse;
      Application->Initialize();
      Application->MainFormOnTaskBar = true;
      Application->CreateForm(__classid(TMyForm), &MyForm);
      Application->Run();
}
    // ...

Default Skin Usage Flags in Other Components

TdxCustomRibbon.DefaultUseGlobalSkinSpecifies if all Ribbon controls in the application automatically update their appearance from application-wide skin and palette settings.TdxCustomStatusBar.DefaultUseGlobalSkinSpecifies if all status bar controls in the application automatically update their appearance from application-wide skin and palette settings.TdxCustomLayoutControl.DefaultUseGlobalSkinSpecifies if all Layout controls in the application automatically update their appearance from application-wide skin and palette settings.TdxCustomNavBar.DefaultUseGlobalSkinSpecifies if all Navigation Bar controls in the application automatically update their appearance from application-wide skin and palette settings. See Also

TdxBarManager Class

TdxBarManager Members

dxBar Unit