TdxCustomNavBar.DefaultUseGlobalSkin Property

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

Declaration

class property DefaultUseGlobalSkin: TdxDefaultBoolean read; write;

Property Value

Type

Description

TdxDefaultBoolean

bDefault The cxDefaultUseGlobalSkin global constant specifies if supported Navigation Bar Views automatically import global skin and palette settings and use them instead of corresponding View-specific settings. bTrue All supported Navigation Bar Views automatically import global skin and palette settings defined using a TdxSkinController or the Project Settings dialog. bFalse Supported Navigation Bar Views use individual skin settings.

Remarks

A supported Navigation Bar View can have individual look & feel settings or synchronize (recommended) with the active skin and palette specified using a TdxSkinController component or the Project Settings dialog.

Supported Navigation Bar Views

Only the following Navigation Bar Views support skins:

• Accordion
• Hamburger
• Skin Explorer Bar
• Skin Navigation Pane

Note

All other Navigation bar Views rely on their own draw routines.

Individual View Skin Settings

If one of the supported Navigation Bar Views is selected using the ViewStyle property, the TdxNavBar control uses global skin and palette settings.

You can expand the ViewStyle node and use the SkinName property to select an individual skin for the TdxNavBar control. If a vector skin is selected, it uses the color palette defined at the global level.

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.

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.

C++

#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

TdxBarManager.DefaultUseGlobalSkin

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

TdxCustomRibbon.DefaultUseGlobalSkin

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

TdxCustomStatusBar.DefaultUseGlobalSkin

Specifies if all status bar controls in the application automatically update their appearance from application-wide skin and palette settings.

TdxCustomLayoutControl.DefaultUseGlobalSkin

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

Default Value

The DefaultUseGlobalSkin property’s default value is bDefault.

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