/*
   *@@ WIDGETSETTINGSDLGDATA:
   *      blocco di dati passato a una funzione "mostra
   *      dialog di impostazioni" (WGTSHOWSETTINGSDLG), se
   *      l'elemento ha specificato una tal cosa.
   *
   *      le dialog di impostazioni dello &xcenter; basilarmente
   *      lavorano come di seguito:
   *
   *      1.  Ô necessaria una funzione che mostri una dialog
   *          modal. Tale funzione deve avere il seguente
   *          prototipo:
   *
   +              VOID EXPENTRY ShowSettingsDlg(PWIDGETSETTINGSDLGDATA pData)
   *
   *      2.  Si memorizzi la funzione nel campo
   *          XCENTERWIDGETCLASS.pShowSettingsDlg per la
   *          propria classe elemento.
   *
   *          Ci• abiliter… la voce di menu "Properties"
   *          per l'elemento.
   *
   *      3.  La funzione viene chiamata quando l'utente seleziona
   *          "Properties". Non importa cosa questa funzione
   *          faccia... In ogni caso dovrebbe mostrare una dialog
   *          modal e modificare la stringa di impostazioni dell'elemento,
   *          e chiamare ctrSetSetupString con lo handle "hSettings"
   *          che le era stato passato nella struttura
   *          WIDGETSETTINGSDLGDATA. Ci• fornir… all'elemento
   *          le nuove impostazioni.
   *
   *          L'indirizzo dell'helper ctrSetSetupString viene fornito
   *          in questa struttura, cosŤ che non Š necessario
   *          importarlo da XFLDR.DLL.
   *
   *      Se una classe elemento supporta le dialog di impostazioni,
   *      deve specificarlo nella sua XCENTERWIDGETCLASS.
   *
   *@@added V0.9.7 (2000-12-07) [umoeller]
   *@@changed V0.9.9 (2001-02-06) [umoeller]: added pctrSetSetupString
   */

  typedef struct _WIDGETSETTINGSDLGDATA
  {
      HWND                    hwndOwner;
                  // titolare proposto per la dialog di impostazioni

      const char              *pcszSetupString;
                  // stringa di impostazioni corrente (non cambiare)

      const LHANDLE           hSettings;
                  // handle alle impostazioni dell'elemento; deve
                  // essere passato a ctrSetSetupString;
                  // NON MODIFICARE

      PXCENTERGLOBALS         pGlobals;
                  // se != NULL, Š lo &xcenter; attualmente aperto
                  // per il cui elemento i dati vengono cambiati.
                  // Se NULL, lo &xcenter; non Š correntemente
                  // aperto.

      PXCENTERWIDGET          pView;
                  // se != NULL, Š la vista attualmente aperta
                  // dell'elemento. Se NULL, l'elemento
                  // attualmente non Š aperto.

      PVOID                   pUser;
                  // spazio per dati addizionali che
                  // potrebbero servire alla dialog

      PCTRSETSETUPSTRING      pctrSetSetupString;
                  // puntatore alla funzione ctrSetSetupString in
                  // src\shared\center.c; deve essere chiamata
                  // dalla dialog di impostazioni per cambiare
                  // la stringa di impostazioni dell'elemento.
                  // Tale puntatore Š stato aggiunto dalla V0.9.9
                  // per poter usare le dialog di impostazioni senza
                  // dover importare la funzione da XFLDR.DLL.

  } WIDGETSETTINGSDLGDATA, *PWIDGETSETTINGSDLGDATA;