mpdclient: implement password for asynchronous connect

[ncmpc.git] / src / list_window.h

diff --git a/src/list_window.h b/src/list_window.h
index ed241432a2ebae6cd1854a7c885802a92134bbe2..697e1e0e163af938e337bf1773111bde68b79523 100644 (file)
--- a/src/list_window.h
+++ b/src/list_window.h
@@ -1,21 +1,21 @@
 /* ncmpc (Ncurses MPD Client)
- * (c) 2004-2010 The Music Player Daemon Project
+ * (c) 2004-2017 The Music Player Daemon Project
  * Project homepage: http://musicpd.org
-
+ *
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version.
-
+ *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
-
+ *
  * You should have received a copy of the GNU General Public License along
  * with this program; if not, write to the Free Software Foundation, Inc.,
  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
-*/
+ */
 
 #ifndef LIST_WINDOW_H
 #define LIST_WINDOW_H
@@ -23,16 +23,11 @@
 #include "config.h"
 #include "command.h"
 #include "colors.h"
+#include "ncmpc_curses.h"
 
 #include <glib.h>
 #include <stdbool.h>
 
-#ifdef HAVE_NCURSESW_NCURSES_H
-#include <ncursesw/ncurses.h>
-#else
-#include <ncurses.h>
-#endif
-
 typedef const char *
 (*list_window_callback_fn_t)(unsigned i, void *data);
 
@@ -40,7 +35,7 @@ typedef void
 (*list_window_paint_callback_t)(WINDOW *w, unsigned i,
                                unsigned y, unsigned width,
                                bool selected,
-                               void *data);
+                               const void *data);
 
 struct list_window {
        WINDOW *w;
@@ -53,8 +48,16 @@ struct list_window {
 
        unsigned start;
        unsigned selected;
-       unsigned range_base;        /* represents the base item. */
-       bool range_selection;       /* range selection activated */
+
+       /**
+        * Represents the base item.
+        */
+       unsigned range_base;
+
+       /**
+        * Range selection activated?
+        */
+       bool range_selection;
 
        bool hide_cursor;
 };
@@ -79,7 +82,7 @@ struct list_window_range {
 struct list_window *list_window_init(WINDOW *w,
                                     unsigned width, unsigned height);
 
-/* destroy a list window (returns NULL) */
+/* destroy a list window */
 void list_window_free(struct list_window *lw);
 
 /* reset a list window (selected=0, start=0) */
@@ -99,14 +102,14 @@ void list_window_paint(const struct list_window *lw,
 void
 list_window_paint2(const struct list_window *lw,
                   list_window_paint_callback_t paint_callback,
-                  void *callback_data);
+                  const void *callback_data);
 
 /* perform basic list window commands (movement) */
 bool
 list_window_cmd(struct list_window *lw, command_t cmd);
 
 /**
- * Scroll the window.  Returns non-zero if the command has been
+ * Scroll the window.  Returns true if the command has been
  * consumed.
  */
 bool
@@ -127,6 +130,13 @@ list_window_mouse(struct list_window *lw, unsigned long bstate, int y);
 void
 list_window_center(struct list_window *lw, unsigned n);
 
+/**
+ * Scrolls the view to item n, as if the cursor would have been moved
+ * to the position.
+ */
+void
+list_window_scroll_to(struct list_window *lw, unsigned n);
+
 /**
  * Sets the position of the cursor.  Disables range selection.
  */