▶ PPPTools Dokumentation
📚 Bibliothek
DE EN
Contents

Custom Colors

Created: 2026-05-30 · Updated: 2026-05-30

Custom Colors allow an administrator to define a company-specific color palette that is pre-loaded into the color picker dialogs of parameterized snippets. This way, the organization's corporate design colors are immediately available in the dialog — without users having to search for or manually enter color codes.

Why Custom Colors?

The Windows color picker provides 16 freely configurable "Custom Color" slots. PPPTools uses these slots to store the administrator-defined corporate colors.

Result for users: When opening the color picker in a @param color dialog (→ Parameterized Snippets), they immediately see the 16 corporate design colors in the bottom row of the dialog — quick access without entering any color codes.

Color picker with Custom Colors

16 colors

The Windows color picker provides exactly 16 custom color slots. A typical corporate design assignment: primary and secondary colors, accent colors, grays, white and black.

For Administrators — Defining Colors

Colors are configured in the Admin tab under Settings → Custom Colors.

Requirement: Admin mode active (→ Admin Guide).

Steps

  1. Open the Admin tab → Settings → Custom Colors
  2. Click on one of the 16 color fields → the Windows color picker opens
  3. Select the desired color → OK
  4. After adjusting all fields: click Save

Saving writes the colors to admin_config.xml in the shared network path (Public Share). At the next sync, all users automatically receive the updated colors.

Color Field Layout

The 16 fields are arranged in 2 rows of 8 colors each. A recommended assignment:

Row Recommendation
Row 1 Primary color, secondary color, 2–3 accent colors, 2–3 grays, black
Row 2 Lighter tones, backgrounds, complementary colors, white

Reset

The Reset button sets all 16 fields back to white (the Windows color picker default). The change must then be confirmed by clicking Save.

For Users — Viewing Colors

Under Settings → Custom Colors, PPPTools displays the 16 administrator-defined colors in a read-only table:

Column Content
Color Visual color swatch
Hex Hexadecimal color code, e.g. #FF5733
RGB RGB values, e.g. R: 255 G: 87 B: 51

Managed by administrator

Custom Colors are maintained by the administrator and automatically distributed via sync. Users cannot change the colors directly.

Usage in Snippet Dialogs

Custom Colors apply wherever the Windows color picker is opened — specifically for the @param color type in parameterized snippets:

// @param color Background "Background color" default=#003366
// @param color Border     "Border color"      default=#FF9900

When a user clicks the color button in the parameter dialog, the Windows color picker opens with the predefined corporate colors in the custom slots.

Synchronization

Action Who When
Define colors Administrator Manually in the Admin tab
Save colors PPPTools Immediately to admin_config.xml in the Share
Receive colors All users Automatically at the next sync

Sync runs at startup and periodically in the background. After receipt, the colors are immediately available in the next @param color dialog.