X-Git-Url: https://vcs.maemo.org/git/?a=blobdiff_plain;f=hildon%2Fhildon-gtk.h;h=49b3d46e3d191476f0bae37a13ae60fce8cac261;hb=e221fe1830a33be57ec2c772c77ff283c17a22eb;hp=7d7e9eb76b2a2c8c62455fd2d29e227c5ba55378;hpb=69a11338fe0cc36a868e5812b590f5437622988a;p=hildon

diff --git a/hildon/hildon-gtk.h b/hildon/hildon-gtk.h
index 7d7e9eb..49b3d46 100644
--- a/hildon/hildon-gtk.h
+++ b/hildon/hildon-gtk.h
@@ -1,7 +1,7 @@
 /*
  * This file is a part of hildon
  *
- * Copyright (C) 2008 Nokia Corporation, all rights reserved.
+ * Copyright (C) 2008, 2009 Nokia Corporation, all rights reserved.
  *
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU Lesser Public License as published by
@@ -63,22 +63,45 @@ hildon_gtk_icon_view_set_ui_mode                (GtkIconView  *iconview,
 #endif /* MAEMO_GTK */
 
 void
-hildon_gtk_window_set_progress_indicator        (GtkWindow    *window,
-                                                 guint        state);
+hildon_gtk_window_set_progress_indicator        (GtkWindow *window,
+                                                 guint      state);
 
 void
 hildon_gtk_window_set_do_not_disturb            (GtkWindow *window,
                                                  gboolean   dndflag);
 
+/**
+ * HildonPortraitFlags:
+ *
+ * These flags are used to tell the window manager whether the current
+ * window needs to be in portrait or landscape mode.
+ *
+ * If no flags are set then the window is meant to be used in
+ * landscape mode only.
+ *
+ * If %HILDON_PORTRAIT_MODE_REQUEST is set then the window is meant to
+ * be used in portrait mode only.
+ *
+ * If only %HILDON_PORTRAIT_MODE_SUPPORT is set then the current
+ * orientation will be kept, no matter if it's portrait or landscape.
+ *
+ * It is important to note that, while these flags can be used to
+ * change between portrait and landscape according to the physical
+ * orientation of the display, Hildon does not provide any method to
+ * obtain this information.
+ **/
 typedef enum {
     HILDON_PORTRAIT_MODE_REQUEST = 1 << 0,
     HILDON_PORTRAIT_MODE_SUPPORT = 1 << 1
 } HildonPortraitFlags;
 
 void
-hildon_gtk_window_set_portrait_flags             (GtkWindow *window,
-                                                  HildonPortraitFlags portrait_flags);
+hildon_gtk_window_set_portrait_flags            (GtkWindow           *window,
+                                                 HildonPortraitFlags  portrait_flags);
 
+void
+hildon_gtk_window_take_screenshot               (GtkWindow *window,
+                                                 gboolean   take);
 GtkWidget*
 hildon_gtk_hscale_new                           (void);