Medium contactWizardFinishRequest

From TrillWiki

The medium_contactWizardFinishRequest notification is set to request from the medium plugin if they are done with a particular import or adding screen.

Compatibility: 2.0 and higher

Contents 1 Syntax 2 Parameters 3 Return Value 4 Remarks

Syntax

callback(int window_id, char *icontrol, "medium_contactWizardFinishRequest", contact_wizard_t *data, void *userData);

Note that all Trillian functions and notifications begin with a lower-case letter, despite the Wiki requirement that all pages start with a capital letter.

Parameters

Medium contactWizardFinishRequest utilitizes the contact_wizard_t structure.

struct contact_wizard_t { 
 	unsigned int	   		struct_size; 
 
 	int   				show; //1 shows, 0 hides 
 	int				flags; 
 
 	char 				*medium; 
 	char 				*type; //contact, import 
 	 
 	HWND  				hwnd; 
 
 	int   				x; 
 	int   				y; 
 
 	char				*section; 
 	struct group_entry_t		*group; 
 
 	struct contact_wizard_info_t 	wizard_info; 
 };

medium

The medium selected in the wizard.

type

The type of screen. The current options are : import, contact

Return Value

Must return 1 if finished, 0 if not.

Remarks

The purpose of this function is to allow the user to finish adding something if they are in the middle. Such as if they have typed a name into the add wizard, but have yet to click the add button, they will receive a notification asking if they meant to not add this contact.

See also: medium_contactWizardFinish