Na każdym ekranie rysuje się okno WE_PAINT 'window event'.

Otwieranie okna

Utworzenie nowej struktury okna otwiera nowe okno. Powinien być opatrzony komentarzem doxygen wyjaśniającym funkcję.

Przykład:

/**
 * Opens a new instance of a MyNew window.
 * @param void Any parameters required by window
 */
void ShowMyNewWindow(void)
{
	DeleteWindowByClass(window class);
	new MyNewWindow(void);
}

Opis okna

Skonfiguruj WindowDesc z podaną nazwą this->CreateNestedTree() i this->FinishInitNested().

Składnia:

/** Window description for my new window. */
static const WindowDesc _mywindow_desc(
	window positioning,
        default width,
        default height,
        window class,
        parent window class,
        window flags
        widget parts,
        lengthof(widget parts)
);

Będziesz także potrzebował struktury opisującej Możesz znaleźć wiele przykładów w kodzie źródłowym, spójrz w plik *_gui.cpp .

Pozycjonowanie okna

Pozycjonowanie okna jest jedną z wartości WindowPosition enum zdefiniowane w src/window_gui.h.

Klasy okien

Klasa okna to unikalny numer reprezentujący (zestaw) okien, na przykład okno wyświetlające miasto ma klasę WC_TOWN_VIEW . Aby odróżnić miasto wyświetlane przez rzeczywiste okno, to drugie ma dodatkowy numer okna.

Lista dostępnych klas okien jest zdefiniowana przez WindowClass enum, w src/window_type.h.

Konfigurowanie widżetów

Składnia:

static const NWidgetPart _nested_mywindow_widgets[] = {
        NWidget(nwid),
                 NWidget(wwt, colour, wid), SetDataTip(STR_NULL, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
        EndContainer(),
};

Przykład:

static const NWidgetPart _nested_mywindow_widgets[] = {
	NWidget(NWID_HORIZONTAL),
		NWidget(WWT_TEXT, COLOUR_MAUVE), SetDataTip(STR_NEWGRF_SETTINGS_SELECT_PRESET, STR_NULL),
				SetPadding(0, WD_FRAMETEXT_RIGHT, 0, 0),
		NWidget(WWT_DROPDOWN, COLOUR_YELLOW, WID_NS_PRESET_LIST), SetFill(1, 0), SetResize(1, 0),
				SetDataTip(STR_JUST_STRING, STR_NEWGRF_SETTINGS_PRESET_LIST_TOOLTIP),
	EndContainer(),
};

Typy widżetów

WWT_EMPTY

Do poprawki
- Dołącz wyjaśnienie.

WWT_PANEL

Prosty wciśnięty panel.

WWT_INSET

Wciśnięty panel, najczęściej używany jako pole tekstowe pola kombi.

WWT_IMGBTN

Przycisk obrazu.

WWT_IMGBTN_2

Przycisk obrazu. Obraz zmienia się po naciśnięciu przycisku.

WWT_TEXTBTN

Przycisk tekstowy.

WWT_TEXTBTN_2

Przycisk tekstowy. Tekst zmienia się po naciśnięciu przycisku.

WWT_LABEL

Wyśrodkowana etykieta.

WWT_MATRIX

Do poprawki
- Dołącz wyjaśnienie.

WWT_SCROLLBAR

Do poprawki
- Dołącz wyjaśnienie.

WWT_FRAME

Do poprawki
- Dołącz wyjaśnienie.

WWT_CAPTION

Do poprawki
- Dołącz wyjaśnienie.

WWT_HSCROLLBAR

Do poprawki
- Dołącz wyjaśnienie.

WWT_STICKYBOX

Przycisk do 'przyklejenia' okna.

WWT_SCROLL2BAR

Do poprawki
- Dołącz wyjaśnienie.

WWT_RESIZEBOX

Przycisk zmiany rozmiaru okna.

WWT_CLOSEBOX

Przycisk zamknięcia okna.

WWT_PUSHBTN

Do poprawki
- Dołącz wyjaśnienie.

WWT_PUSHTXTBTN

Do poprawki
- Dołącz wyjaśnienie.

WWT_PUSHIMGBTN

Do poprawki
- Dołącz wyjaśnienie.

Kolory

Aby uzyskać listę dostępnych kolorów, zobacz Zabarwienia.

Utrzymanie okna

Zdefiniuj, co zrobić z oknem w strukturze, za pomocą konstruktora

Przykład:

struct MyNewWindow {
        MyNewWindow()
        {
        }
        ....
}