LCL Defines

From Free Pascal wiki
Jump to navigationJump to search

Les documents de cette page définit les options qui peuvent être utilisés pour recompiler les différents widgetsets de la LCL. Ce n'est pas une liste compréhensive, mais peut en devenir une si plus de définition sont ajouté.

Pourquoi employer des définitions ?

Les Définition permette d'ajouter des fonctionnalités non standard à la LCL, les dispositifs d'essai expérimentaux ou pour ajouter une sortie de déboguage qui aide à examiner les widgetsets.

Recompiler la LCL avec une définition

Pour recompiler la LCL avec une définition spécial allez dans le menu de Lazarus Outils -> Configurer "build Lazarus"

Là s'ajoutent -d<DEFINE_NAME> dans la boite d'options.

Ainsi si vous souhaitez ajouter la définition PassWin32MessagesToLCL, vous ajouterez -dPassWin32MessagesToLCL dans cette boite.


Définition Win32

  • PassWin32MessagesToLCL - Permet l'utilisation des messages utilisateur, c.-à-d. messages plus grands que WM_USER + 32


  • WindowsUnicodeSupport - Bascule sur l'appui expérimental Unicode sur Windows.

WinCE defines

Gtk defines

DebugLCLComponents

This activates saving information on every creation or destruction of LCL components, device contexts, gdi objects (pen, brush, font, ...) and main widgets. It will spot mem leaks and double frees with stacktraces.

TraceGDICalls

This activates saving information on every creation or destruction of gdi objects (pen, brush, font, ...). It will spot mem leaks and double frees with stacktraces.

Qt defines

You can use the following defines while building LCL to configure your Qt Interface:

  • USE_QT_4_3 - The default Qt version utilized by the interface is 4.2 or superior. By setting this define you allow the interface to use 4.3+ features, like MDI Forms.
  • VerboseQt - Writes extensive debug information about the creation and deletion of Qt objects and LCL Objects to the StdOut.
  • VerboseQtWinAPI - Writes extensive debug information about the Qt implementation of the functions on the LCLIntf unit to StdOut.
  • QT_HIDDEN_BUTTON_WORKAROUND - This activates a work around for a LCL miss-behavior which makes it create a hidden button to overcome some Gtk problem. This should be removed after LCL is fixed. Link for the bug: http://www.freepascal.org/mantis/view.php?id=9152

Carbon defines

List of Carbon defines used to show debug info when tracing:

  • DebugEventLoop
  • VerboseObject - Carbon interface application
  • VerboseTimer
  • VerboseWinAPI
  • VerboseLCLIntf
  • VerboseMouse
  • VerboseCursor
  • VerboseKeyboard
  • VerbosePaint
  • VerboseCanvas
  • VerboseMenu
  • VerboseScroll
  • VerboseWidget - TCarbonWidget class
  • VerboseAppEvent - Carbon application event handlers
  • VerboseControlEvent - Carbon control event handlers
  • VerboseWindowEvent - Carbon window event handlers
  • VerboseCommonEvent - Carbon common event handlers
  • VerboseWSClass - TCarbonWS classes