====== gwAttributeWidget funzioni esposte ======

Il gwAttributeWidget rappresenta il widget che rappresenta nel gwClassDetail il gwAttribute. Il gwAttributeWidget espone tutta una serie di function di utilità, che servono per interagire con esso o conoscerne lo stato corrente.

  * [[:custom:api_js_gw_attribute_widget_exposed_fx#gwGetValue|gwGetValue()]]
  * [[:custom:api_js_gw_attribute_widget_exposed_fx#gwSetValue|gwSetValue()]]
  * [[:custom:api_js_gw_attribute_widget_exposed_fx#gwGetHidden|gwGetHidden()]]
  * [[:custom:api_js_gw_attribute_widget_exposed_fx#gwIsHidden|gwIsHidden()]]
  * [[:custom:api_js_gw_attribute_widget_exposed_fx#gwSetHidden|gwSetHidden()]]
  * [[:custom:api_js_gw_attribute_widget_exposed_fx#gwHide|gwHide()]]
  * [[:custom:api_js_gw_attribute_widget_exposed_fx#gwShow|gwShow()]]
  * [[:custom:api_js_gw_attribute_widget_exposed_fx#gwToggleHidden|gwToggleHidden()]]
  * [[:custom:api_js_gw_attribute_widget_exposed_fx#gwGetReadonly|gwGetReadonly()]]
  * [[:custom:api_js_gw_attribute_widget_exposed_fx#gwSetReadonly|gwSetReadonly()]]
  * [[:custom:api_js_gw_attribute_widget_exposed_fx#gwGetRequired|gwGetRequired()]]
  * [[:custom:api_js_gw_attribute_widget_exposed_fx#gwSetRequired|gwSetRequired()]]
  * [[:custom:api_js_gw_attribute_widget_exposed_fx#gwGetDisabled|gwGetDisabled()]]
  * [[:custom:api_js_gw_attribute_widget_exposed_fx#gwSetDisabled|gwSetDisabled()]]

==== Note ====
Nei metodi .gwSet*() è opzionalmente contemplato l'utilizzo del parametro //eventChain//. Esso è si opzionale, ma va specificato in particolari contesti, come il codice js scritto negli handler degli Eventi Attributi (EventAttributes, [ndr: permettono di eseguire codice in risposta all'accadere di determinati eventi legati al widget dell'attributo]). Questo è utilizzato per permettere al sistema di evitare eventuali cicli infiniti che l'utente configuratore potrebbe creare mettendo insieme più Eventi Attributi. Negli handler degli Eventi Attributi, il parametro //eventChain// è sempre reso disponibile nel contesto di esecuzione della function. Quando un ciclo è rilevato, un messaggio di warning è loggato ed il ciclo è interrotto. In certe situazioni l'utente configuratore potrebbe intenzionalmente creare cicli che coinvolgono due o più widgtes, con logiche che legano in varia maniera: questa è una possibilità segnalata, ma ammessa.


===== gwGetValue() =====

Ritorna il valore corrente della proprietà 'value' del widget.
Nel caso il widget gestisca valueToStore/valueToShow, ad essere ritornato è il valueToStore.

=== Parametri ===
Nessuno

=== Esempi ===
<code javascript>
var value = gwAttributeWidget.gwGetValue();
</code>


===== gwSetValue() =====

Imposta il valore della proprietà 'value' per il widget.
Nel caso il widget gestisca valueToStore/valueToShow, ad essere ritornato è il valueToStore.

=== Parametri ===
  * **value**: Object, required, null è un valore ammesso. A seconda della tipologia del widget esso potrebbe essere di tipo string, number, Date, object
  * **eventChain**: Object, optional, default null. Questa parametro dovrebbe essere fornito solo quando questa function è utilizzata nel codice js degli Eventi Attributi (EventAttribute). In quell'ambito il nome di questa variabile è esattamente //eventChain//, e va semplicemente riversata nell'utilizzo della js api, al fine di evitare cicli

=== Esempi ===
<code javascript>
var newValue = 'new value';
gwAttributeWidget.gwSetValue(newValue);
</code>


===== gwGetHidden() =====

Ritorna il valore corrente della proprietà 'hidden' del widget.
Nel caso il widget gestisca valueToStore/valueToShow, ad essere ritornato è il valueToStore.

=== Parametri ===
Nessuno

=== Esempi ===
<code javascript>
var hidden = gwAttributeWidget.gwGetHidden();
</code>


===== gwIsHidden() =====

Lavora come gwGetHidden().
Ritorna il valore corrente della proprietà 'hidden' del widget.
Nel caso il widget gestisca valueToStore/valueToShow, ad essere ritornato è il valueToStore.

=== Parametri ===
Nessuno

=== Esempi ===
<code javascript>
var hidden = gwAttributeWidget.gwIsHidden();
</code>


===== gwSetHidden() =====

Imposta il valore della proprietà 'hidden' per il widget.
'hidden' true ha l'effetto di nascondere il widget.
Il widget di fatto esiste ancora e risponde all'invocazione di tutte le altre function esposte.
Può essere reso di nuovo visibile con le apposite function esposte.


=== Parametri ===
  * **hidden**: Boolean, required. Se posto a true il widget viene nascosto.
  * **eventChain**: Object, optional, default null. Questa parametro dovrebbe essere fornito solo quando questa function è utilizzata nel codice js degli Eventi Attributi (EventAttribute). In quell'ambito il nome di questa variabile è esattamente //eventChain//, e va semplicemente riversata nell'utilizzo della js api, al fine di evitare cicli

=== Esempi ===
<code javascript>
var hidden = true;
gwAttributeWidget.gwSetHidden(hidden);
</code>


===== gwHide() =====

Nasconde il widget. Il widget di fatto esiste ancora e risponde all'invocazione di tutte le altre function esposte.
Può essere reso di nuovo visibile con le apposite function esposte.

=== Parametri ===
Nessuno

=== Esempi ===
<code javascript>
gwAttributeWidget.gwHide();
</code>


===== gwShow() =====

Mostra il widget.
Può essere di nuovo nascosto con le apposite function esposte.

=== Parametri ===
Nessuno

=== Esempi ===
<code javascript>
gwAttributeWidget.gwShow();
</code>


===== gwToggleHidden() =====

Mostra il widget se è attualmente nascondo.
Nasconde il widget se è attualmente visibile.

=== Parametri ===
Nessuno

=== Esempi ===
<code javascript>
gwAttributeWidget.gwToggleHidden();
</code>


===== gwGetReadonly() =====

Ritorna il valore corrente della proprietà 'readonly ' del widget.

=== Parametri ===
Nessuno

=== Esempi ===
<code javascript>
var readonly = gwAttributeWidget.gwGetReadonly();
</code>


===== gwSetReadonly() =====

Imposta il valore della proprietà 'readonly' per il widget.
'readonly' a true ha l'effetto di porre il widget in sola lettura.
'readonly' a false ha l'effetto di rendere il widget editabile.


=== Parametri ===
  * **readonly**: Boolean, required. Se posto a true il widget viene posto in sola lettura.
  * **eventChain**: Object, optional, default null. Questa parametro dovrebbe essere fornito solo quando questa function è utilizzata nel codice js degli Eventi Attributi (EventAttribute). In quell'ambito il nome di questa variabile è esattamente //eventChain//, e va semplicemente riversata nell'utilizzo della js api, al fine di evitare cicli

=== Esempi ===
<code javascript>
var readonly = true;
gwAttributeWidget.gwSetReadonly(readonly);
</code>


===== gwGetRequired() =====

Ritorna il valore corrente della proprietà 'required' del widget.

=== Parametri ===
Nessuno

=== Esempi ===
<code javascript>
var required = gwAttributeWidget.gwGetRequired();
</code>


===== gwSetRequired() =====

Imposta il valore della proprietà 'required' per il widget.
'required' a true ha l'effetto che widget non permetterà il salvataggio in assenza di un valore impostato.


=== Parametri ===
  * **required**: Boolean, required. Se posto a true il widget non permetterà il salvataggio in assenza di un valore impostato.
  * **eventChain**: Object, optional, default null. Questa parametro dovrebbe essere fornito solo quando questa function è utilizzata nel codice js degli Eventi Attributi (EventAttribute). In quell'ambito il nome di questa variabile è esattamente //eventChain//, e va semplicemente riversata nell'utilizzo della js api, al fine di evitare cicli

=== Esempi ===
<code javascript>
var required = true;
gwAttributeWidget.gwSetRequired(required);
</code>


===== gwGetDisabled() =====

Ritorna il valore corrente della proprietà 'disabled' del widget.

=== Parametri ===
Nessuno

=== Esempi ===
<code javascript>
var disabled = gwAttributeWidget.gwGetDisabled();
</code>


===== gwSetDisabled() =====

Imposta il valore della proprietà 'required' per il widget.
'required' a true ha l'effetto di rendere il widget non utilizzabile, seppur ancora visibile.


=== Parametri ===
  * **disabled**: Boolean, required. Se posto a true il widget verrà disabilitato. Cioè non utilizzabile, seppur ancora visibile.
  * **eventChain**: Object, optional, default null. Questa parametro dovrebbe essere fornito solo quando questa function è utilizzata nel codice js degli Eventi Attributi (EventAttribute). In quell'ambito il nome di questa variabile è esattamente //eventChain//, e va semplicemente riversata nell'utilizzo della js api, al fine di evitare cicli

=== Esempi ===
<code javascript>
var disabled= true;
gwAttributeWidget.gwSetDisabled(disabled);
</code>