summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMarc-André Lureau <marcandre.lureau@redhat.com>2022-08-23 16:25:30 +0400
committerMarc-André Lureau <marcandre.lureau@redhat.com>2022-08-23 16:25:33 +0400
commit3cbf6c9d6e05ad3e89daabab1e51eba1f1072926 (patch)
tree157d70da5a669d3f12510a6df36fc0bd08493b12
parenta75de5fb909b613f4e00fc3c026350bdbe90be06 (diff)
downloadgtk+-3cbf6c9d6e05ad3e89daabab1e51eba1f1072926.tar.gz
gdk/win32: annotate gdk_win32_surface_get_handle
And adjust the argument precondition check. Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
-rw-r--r--gdk/win32/gdksurface-win32.c18
-rw-r--r--gdk/win32/gdkwin32misc.h2
2 files changed, 12 insertions, 8 deletions
diff --git a/gdk/win32/gdksurface-win32.c b/gdk/win32/gdksurface-win32.c
index bd4183eb0b..79f2b9dd05 100644
--- a/gdk/win32/gdksurface-win32.c
+++ b/gdk/win32/gdksurface-win32.c
@@ -4621,16 +4621,20 @@ gdk_win32_surface_class_init (GdkWin32SurfaceClass *klass)
impl_class->compute_size = _gdk_win32_surface_compute_size;
}
+/**
+ * gdk_win32_surface_get_handle:
+ * @surface: (type GdkWin32Surface): a native `GdkSurface`.
+ *
+ * Returns the HWND handle belonging to @surface.
+ *
+ * Returns: the associated HWND handle.
+ */
HWND
-gdk_win32_surface_get_handle (GdkSurface *window)
+gdk_win32_surface_get_handle (GdkSurface *surface)
{
- if (!GDK_IS_WIN32_SURFACE (window))
- {
- g_warning (G_STRLOC " window is not a native Win32 window");
- return NULL;
- }
+ g_return_val_if_fail (GDK_IS_WIN32_SURFACE (surface), NULL);
- return GDK_SURFACE_HWND (window);
+ return GDK_SURFACE_HWND (surface);
}
#define LAST_PROP 1
diff --git a/gdk/win32/gdkwin32misc.h b/gdk/win32/gdkwin32misc.h
index 1bab4ec404..7497ee593e 100644
--- a/gdk/win32/gdkwin32misc.h
+++ b/gdk/win32/gdkwin32misc.h
@@ -78,7 +78,7 @@ GDK_AVAILABLE_IN_ALL
gpointer gdk_win32_handle_table_lookup (HWND handle);
/* Translate from window to Windows handle */
GDK_AVAILABLE_IN_ALL
-HWND gdk_win32_surface_get_handle (GdkSurface *window);
+HWND gdk_win32_surface_get_handle (GdkSurface *surface);
GDK_AVAILABLE_IN_ALL
GdkSurface * gdk_win32_surface_lookup_for_display (GdkDisplay *display,