Skip to content

CLabel Examples

A Label which supports aligned text and/or an image and different border styles.

Image Budget Snippet

CLabel Image Budget Snippet

A collapsible-section header built the way applications build one: a CLabel carrying the

title text plus a small state icon, given LEFT alignment and no horizontal grab, so the

GridLayout hands it exactly its computeSize.

That makes the header a strict test of the image budget: CLabelSizes reserves

imageData.width for the icon, so the icon must render within that width or the leftover is

taken out of the text, which then ellipsizes.

CLabelImageBudgetSnippet.java 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
package dev.equo;

import dev.equo.swt.Config;
import org.eclipse.swt.SWT;
import org.eclipse.swt.custom.CLabel;
import org.eclipse.swt.graphics.Font;
import org.eclipse.swt.graphics.FontData;
import org.eclipse.swt.graphics.Image;
import org.eclipse.swt.graphics.ImageData;
import org.eclipse.swt.graphics.PaletteData;
import org.eclipse.swt.graphics.Point;
import org.eclipse.swt.graphics.RGB;
import org.eclipse.swt.layout.GridData;
import org.eclipse.swt.layout.GridLayout;
import org.eclipse.swt.widgets.Composite;
import org.eclipse.swt.widgets.Display;
import org.eclipse.swt.widgets.Label;
import org.eclipse.swt.widgets.Shell;

/**
 * A collapsible-section header built the way applications build one: a CLabel carrying the
 * title text plus a small state icon, given LEFT alignment and no horizontal grab, so the
 * GridLayout hands it exactly its computeSize.
 *
 * That makes the header a strict test of the image budget: CLabelSizes reserves
 * imageData.width for the icon, so the icon must render within that width or the leftover is
 * taken out of the text, which then ellipsizes.
 */
public class CLabelImageBudgetSnippet {

    private static final int ICON_SIZE = 16;
    private static final String TITLE = "Query Parameters";

    public static void main(String[] args) {
        Config.useEquo(CLabel.class);

        Display display = new Display();
        Shell shell = new Shell(display);
        shell.setText("CLabel image budget");
        shell.setLayout(new GridLayout(1, false));
        shell.setSize(520, 260);

        FontData systemFont = display.getSystemFont().getFontData()[0];
        Font boldFont = new Font(display, systemFont.getName(), systemFont.getHeight(), SWT.BOLD);
        Image collapsedIcon = arrowIcon(display);

        Composite section = new Composite(shell, SWT.NONE);
        GridLayout sectionLayout = new GridLayout();
        sectionLayout.verticalSpacing = 0;
        sectionLayout.horizontalSpacing = 0;
        sectionLayout.marginWidth = 0;
        sectionLayout.marginHeight = 0;
        section.setLayout(sectionLayout);
        section.setLayoutData(new GridData(SWT.FILL, SWT.TOP, true, false));

        CLabel header = new CLabel(section, SWT.NONE);
        header.setCursor(display.getSystemCursor(SWT.CURSOR_HAND));
        header.setLayoutData(new GridData(SWT.LEFT, SWT.CENTER, false, false));
        header.setText(TITLE);
        header.setFont(boldFont);
        header.setImage(collapsedIcon);

        Label reference = new Label(shell, SWT.NONE);
        reference.setFont(boldFont);
        reference.setText("expected: " + TITLE);

        Point headerSize = header.computeSize(SWT.DEFAULT, SWT.DEFAULT);
        System.out.println("[budget] header computeSize=" + headerSize.x + "x" + headerSize.y
                + " icon=" + collapsedIcon.getImageData().width + "x" + collapsedIcon.getImageData().height);

        shell.open();
        while (!shell.isDisposed()) {
            if (!display.readAndDispatch()) display.sleep();
        }
        collapsedIcon.dispose();
        boldFont.dispose();
        display.dispose();
    }

    /** A right-pointing arrow drawn into a plain ICON_SIZE bitmap, so no image file is needed. */
    private static Image arrowIcon(Display display) {
        PaletteData palette = new PaletteData(new RGB[] { new RGB(255, 255, 255), new RGB(90, 96, 110) });
        ImageData data = new ImageData(ICON_SIZE, ICON_SIZE, 1, palette);
        data.transparentPixel = 0;
        for (int x = 5; x <= 9; x++) {
            for (int y = 8 - (9 - x); y <= 8 + (9 - x); y++) {
                data.setPixel(x, y, 1);
            }
        }
        return new Image(display, data);
    }
}

View on GitHub

Snippet

CLabel Snippet

Demonstrates CLabel (Custom Label) widget with Equo Flutter rendering.

CLabel supports:

  • Text and/or image display

  • Custom alignment (LEFT, CENTER, RIGHT)

  • Custom colors and fonts

  • Margins (top, bottom, left, right)

  • Tooltips

CLabelSnippet.java 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
package dev.equo;

import dev.equo.swt.Config;
import dev.equo.swt.ConfigFlags;
import org.eclipse.swt.SWT;
import org.eclipse.swt.custom.CLabel;
import org.eclipse.swt.graphics.Image;
import org.eclipse.swt.layout.GridData;
import org.eclipse.swt.layout.GridLayout;
import org.eclipse.swt.widgets.Display;
import org.eclipse.swt.widgets.Shell;

/**
 * Demonstrates CLabel (Custom Label) widget with Equo Flutter rendering.
 * CLabel supports:
 * - Text and/or image display
 * - Custom alignment (LEFT, CENTER, RIGHT)
 * - Custom colors and fonts
 * - Margins (top, bottom, left, right)
 * - Tooltips
 */
public class CLabelSnippet {

    public static void main(String[] args) {
        // Enable Equo Flutter rendering for CLabel
        Config.useEquo(CLabel.class);
        ConfigFlags.use_swt_fonts(true);

        Display display = new Display();
        Shell shell = new Shell(display);
        shell.setText("CLabel Snippet");
        shell.setLayout(new GridLayout(1, false));
        shell.setSize(500, 400);

        // CLabel with text only
        CLabel textLabel = new CLabel(shell, SWT.BORDER);
        textLabel.setText("Text Only CLabel");
        textLabel.setLayoutData(new GridData(SWT.FILL, SWT.CENTER, true, false));
        textLabel.setAlignment(SWT.CENTER);
        textLabel.setForeground(display.getSystemColor(SWT.COLOR_BLUE));

        // CLabel with text and image (if img.png exists)
        CLabel imageLabel = new CLabel(shell, SWT.BORDER);
        imageLabel.setText("Label with Image");
        try {
            Image image = new Image(display, CLabelSnippet.class.getClassLoader().getResourceAsStream("img.png"));
            imageLabel.setImage(image);
        } catch (Exception e) {
            // Image not available, continue with text only
        }
        imageLabel.setLayoutData(new GridData(SWT.FILL, SWT.CENTER, true, false));

        // CLabel with margins
        CLabel marginLabel = new CLabel(shell, SWT.BORDER);
        marginLabel.setText("CLabel with Margins (10px)");
        marginLabel.setLayoutData(new GridData(SWT.FILL, SWT.CENTER, true, false));
        marginLabel.setTopMargin(10);
        marginLabel.setBottomMargin(10);
        marginLabel.setLeftMargin(10);
        marginLabel.setRightMargin(10);
        marginLabel.setForeground(display.getSystemColor(SWT.COLOR_DARK_GREEN));

        // CLabel with tooltip
        CLabel tooltipLabel = new CLabel(shell, SWT.BORDER);
        tooltipLabel.setText("Hover for Tooltip");
        tooltipLabel.setToolTipText("This is a CLabel tooltip!");
        tooltipLabel.setLayoutData(new GridData(SWT.FILL, SWT.CENTER, true, false));

        // CLabel right aligned
        CLabel rightLabel = new CLabel(shell, SWT.BORDER);
        rightLabel.setText("Right Aligned");
        rightLabel.setLayoutData(new GridData(SWT.FILL, SWT.CENTER, true, false));
        rightLabel.setAlignment(SWT.RIGHT);
        rightLabel.setForeground(display.getSystemColor(SWT.COLOR_RED));

        shell.open();
        while (!shell.isDisposed()) {
            if (!display.readAndDispatch()) display.sleep();
        }
        display.dispose();
    }
}

View on GitHub