It’s a low-level object, used to implement high-level objects
such as GtkWindow.
The surfaces you see in practice are either gdk.toplevel.Toplevel or
gdk.popup.Popup, and those interfaces provide much of the required
API to interact with these surfaces. Other, more specialized surface
types exist, but you will rarely interact with them directly.
A gdk.surface.Surface is a rectangular region on the screen.
It’s a low-level object, used to implement high-level objects such as GtkWindow.
The surfaces you see in practice are either gdk.toplevel.Toplevel or gdk.popup.Popup, and those interfaces provide much of the required API to interact with these surfaces. Other, more specialized surface types exist, but you will rarely interact with them directly.