X-Git-Url: https://git.distorted.org.uk/u/mdw/putty/blobdiff_plain/8eed910da111b888ec363493ee55c6057eb61acf..f160b7b8908cac4a7ca37b49928b7855fe0a11fe:/dialog.h

diff --git a/dialog.h b/dialog.h
index 8daa3320..0cabb3d3 100644
--- a/dialog.h
+++ b/dialog.h
@@ -209,6 +209,10 @@ union control {
 	 * has a drop-down list built in. (Note that a _non_-
 	 * editable drop-down list is done as a special case of a
 	 * list box.)
+	 * 
+	 * Don't try setting has_list and password on the same
+	 * control; front ends are not required to support that
+	 * combination.
 	 */
 	int has_list;
 	/*
@@ -333,6 +337,11 @@ union control {
 	 * the respective widths of `ncols' columns, which together
 	 * will exactly fit the width of the list box. Otherwise
 	 * `percentages' must be NULL.
+	 * 
+	 * There should never be more than one column in a
+	 * drop-down list (one with height==0), because front ends
+	 * may have to implement it as a special case of an
+	 * editable combo box.
 	 */
 	int ncols;		       /* number of columns */
 	int *percentages;	       /* % width of each column */
@@ -611,6 +620,10 @@ void dlg_update_done(union control *ctrl, void *dlg);
  */
 void dlg_set_focus(union control *ctrl, void *dlg);
 /*
+ * Change the label text on a control.
+ */
+void dlg_label_change(union control *ctrl, void *dlg, char const *text);
+/*
  * Return the `ctrl' structure for the most recent control that had
  * the input focus apart from the one mentioned. This is NOT
  * GUARANTEED to work on all platforms, so don't base any critical