Gtk4.Extensions

General

Working with .NET and GTK 4 is done via GirCore.

GirCore has it's own build of cairo, but that cairo-wrapper

• misses some features in the cairo API-surface
• isn't documented
• misses some convenience methods

Thus these extensions package for GTK 4 uses CairoSharp.

MSBuild properties

These properties are optional, and by default (false) they do nothing.

<PropertyGroup> <GtkWinNativeDir>C:\Program Files\msys64\ucrt64\bin</GtkWinNativeDir> <GtkWinCopyNativeLibs>false</GtkWinCopyNativeLibs> </PropertyGroup>

When GtkWinCopyNativeLibs is set to true, then the native binaries are copied from the directory given by GtkWinNativeDir to the output directory.

This is for convenience when you want to package the application.

Extensions

ActionExtensions

Help with registering actions in the form of

public sealed class MainWindow : ApplicationWindow { public MainWindow(/* ... */) { this.AddAction("saveAsPng", this.SaveAsPng); } private void SaveAsPng() { // ... } }

DrawingAreaExtensions

• setting the DrawingArea.SetDrawFunc for CairoSharp (instead of the GirCore cairo wrapper)
• SaveAsPng to save the drawing area as PNG file
• SaveAsPngWithFileDialog similar to the previous, just with a file dialog to choose the filename
• AddContextMenuForFontChooser adds a context menu ("right-click menu") to allow choosing a (Pango) font

DropDownExtensions

• OnNotifySelected registers a signal the is triggered when the selected properrty is changed
• SetExpression set an expression with a Func<IntPtr, string> propertyAccessor

Gtk4Constants

Provides some constants for GTK 4. See Gtk4Constants for the values.

WindowExtensions

• HintAlignToParent tries to dock the windows to a parent on the given side (note: this won't work on Wayland, as there's no such functionality)
• GetSurface gets the surface associated with the window