TdxDiacriticStringOptions.NormalizationMode Property

Specifies the string normalization algorithm used for string comparison in diacritic-insensitive mode.

Declaration

class property NormalizationMode: TdxDiacriticStringNormalizationMode read; write; default TdxDiacriticStringNormalizationMode.Fast;

Property Value

Type	Default	Description
TdxDiacriticStringNormalizationMode	Fast	The active string normalization mode.

Remarks

Diacritic-insensitive string comparison in all data controllers^[1] and text field-based editors^[2] relies on the fast DevExpress Unicode string normalization algorithm.

You can set the NormalizationMode property to TdxDiacriticStringNormalizationMode.Fast or TdxDiacriticStringNormalizationMode.System to switch between DevExpress and system string normalization modes for diacritic mark-insensitive comparison operations.

Tip

We recommend that you configure string comparison settings in the initialization section of the main application as demonstrated in the code example below. If you need to change these settings while the application is running, refresh all data controllers to apply your changes.

Code Example: Customize Global Diacritic Mark Settings at Startup

The following code example configures global diacritic mark-related settings at application startup:

Delphi

uses
  dxCore;
// ...
begin
  TdxDiacriticStringOptions.ComparisonMode := TdxDiacriticStringComparisonMode.Insensitive;
  TdxDiacriticStringOptions.NormalizationMode := TdxDiacriticStringNormalizationMode.System;
  // ...
  Application.Initialize;
  Application.MainFormOnTaskBar := True;
  Application.CreateForm(TMyForm, MyForm);
  Application.Run;
end.

C++

#include <vcl.h>
#include "dxCore.hpp"
#pragma hdrstop
#include <tchar.h>
//-------------------------------------------------------------------------------
USEFORM("Unit1.cpp", TMyForm);
//-------------------------------------------------------------------------------
int WINAPI _tWinMain(HINSTANCE, HINSTANCE, LPTSTR, int)
{
  try
  {
    TdxDiacriticStringOptions::ComparisonMode = TdxDiacriticStringComparisonMode::Insensitive;
    TdxDiacriticStringOptions::NormalizationMode = TdxDiacriticStringNormalizationMode::System;
    // ...
    Application->Initialize();
    Application->MainFormOnTaskBar = true;
    Application->CreateForm(__classid(TMyForm), &MyForm);
    Application->Run();
  }
  // ...
}

Default Value

The NormalizationMode property’s default value is TdxDiacriticStringNormalizationMode.Fast.

Footnotes

1. Except for server mode-based data controllers.

2. Except for lookup editors.