diff src/request.h @ 8285:d335cc7bca54

[gaim-migrate @ 9009] Added a type hint to GaimRequestField. This will be used for neat stuff I'm planning on. committer: Tailor Script <[e-mail]>

--- a/src/request.h	Tue Feb 17 20:08:45 2004 +0000
+++ b/src/request.h	Wed Feb 18 02:39:47 2004 +0000
@@ -65,6 +65,7 @@
 
 	char *id;
 	char *label;
+	char *type_hint;
 
 	gboolean visible;
 
@@ -364,12 +365,24 @@
 /**
  * Sets whether or not a field is visible.
  *
- * @param field  The field.
+ * @param field   The field.
  * @param visible TRUE if visible, or FALSE if not.
  */
 void gaim_request_field_set_visible(GaimRequestField *field, gboolean visible);
 
 /**
+ * Sets the type hint for the field.
+ *
+ * This is optionally used by the UIs to provide such features as
+ * auto-completion for type hints like "screenname."
+ *
+ * @param field     The field.
+ * @param type_hint The type hint.
+ */
+void gaim_request_field_set_type_hint(GaimRequestField *field,
+									  const char *type_hint);
+
+/**
  * Returns the type of a field.
  *
  * @param field The field.
@@ -405,6 +418,15 @@
  */
 gboolean gaim_request_field_is_visible(const GaimRequestField *field);
 
+/**
+ * Returns the field's type hint.
+ *
+ * @param field The field.
+ *
+ * @return The field's type hint.
+ */
+const char *gaim_request_field_get_type_hint(const GaimRequestField *field);
+
 /*@}*/
 
 /**************************************************************************/