Difference between revisions of "Porting to TDE"

From Trinity Desktop Project Wiki
Jump to navigation Jump to search
m (→‎Widget styles: added bit about porting from readme)
(→‎Widget styles: Added notes about important changes)
Line 12: Line 12:
   
 
The TQt Style API has [https://mirror.git.trinitydesktop.org/gitea/TDE/tqt3/src/branch/master/changes-3.5 undergone] [https://mirror.git.trinitydesktop.org/cgit/qt3/commit/?id=0008bc5bcd95694b38b0d0322aac2ea6fdb21298 some important changes], so porting a widget style to TDE will entail a little more than just running scripts.
 
The TQt Style API has [https://mirror.git.trinitydesktop.org/gitea/TDE/tqt3/src/branch/master/changes-3.5 undergone] [https://mirror.git.trinitydesktop.org/cgit/qt3/commit/?id=0008bc5bcd95694b38b0d0322aac2ea6fdb21298 some important changes], so porting a widget style to TDE will entail a little more than just running scripts.
  +
  +
Keep the following changes in mind:
  +
* Most functions' definitions have changed;
  +
* The usage of the <tt>widget</tt> argument is deprecated in favor of specifying widget parameters via <tt>ceData</tt> and <tt>elementFlags</tt>;
  +
* <tt>SH_UnderlineAccelerator</tt> has been extended with a new style hint, <tt>SH_HideUnderlineAcceleratorWhenAltUp</tt>.
   
 
Porting an existing style to the new API is relatively straightforward; simply update the function definitions in the existing style with the new definition prototypes and cast the passed pointer to TQWidget or TQObject where appropriate.
 
Porting an existing style to the new API is relatively straightforward; simply update the function definitions in the existing style with the new definition prototypes and cast the passed pointer to TQWidget or TQObject where appropriate.
  +
  +
{{WarningBox|text=The '''TQt API docs''' do not currently seem to reflect these changes.}}
   
 
== Window decorations ==
 
== Window decorations ==

Revision as of 15:59, 16 February 2022

Konqi.png
To-do
This section has not been written/completed yet. You can contribute to Trinity by writing or finalizing this section.

This page is intended to provide generic instructions for porting old KDE3 software to the Trinity libraries.

Build system

Software

Widget styles

The TQt Style API has undergone some important changes, so porting a widget style to TDE will entail a little more than just running scripts.

Keep the following changes in mind:

  • Most functions' definitions have changed;
  • The usage of the widget argument is deprecated in favor of specifying widget parameters via ceData and elementFlags;
  • SH_UnderlineAccelerator has been extended with a new style hint, SH_HideUnderlineAcceleratorWhenAltUp.

Porting an existing style to the new API is relatively straightforward; simply update the function definitions in the existing style with the new definition prototypes and cast the passed pointer to TQWidget or TQObject where appropriate.

Messagebox warning.png
Warning!
The TQt API docs do not currently seem to reflect these changes.

Window decorations