Skip to content

Commit

Permalink
Add the Italian version docs for the form control
Browse files Browse the repository at this point in the history
  • Loading branch information
xuri committed May 4, 2024
1 parent 46eb399 commit dc6a760
Show file tree
Hide file tree
Showing 2 changed files with 151 additions and 0 deletions.
4 changes: 4 additions & 0 deletions it/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -147,6 +147,10 @@
* [Crea tabella pivot](pivot.md#AddPivotTable)
* [Ottieni tabelle pivot](pivot.md#GetPivotTables)
* [Elimina la tabella pivot](pivot.md#DeletePivotTable)
* [Controlli del modulo](formControl.md)
* [Aggiungi il controllo del modulo](formControl.md#AddFormControl)
* [Ottieni i controlli del modulo](formControl.md#GetFormControls)
* [Elimina il controllo del modulo](formControl.md#DeleteFormControl)
* [Utilità](utils.md)
* [Aggiungi tabella](utils.md#AddTable)
* [Ottieni tavoli](utils.md#GetTables)
Expand Down
147 changes: 147 additions & 0 deletions it/formControl.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,147 @@
# Controlli del modulo

FormControl mappa direttamente le informazioni sui controlli del modulo.

```go
type FormControl struct {
Cell string
Macro string
Width uint
Height uint
Checked bool
CurrentVal uint
MinVal uint
MaxVal uint
IncChange uint
PageChange uint
Horizontally bool
CellLink string
Text string
Paragraph []RichTextRun
Type FormControlType
Format GraphicOptions
}
```

## Aggiungi il controllo del modulo {#AddFormControl}

```go
func (f *File) AddFormControl(sheet string, opts FormControl) error
```

AddFormControl fornisce il metodo per aggiungere il pulsante di controllo del modulo in un foglio di lavoro in base al nome del foglio di lavoro e alle opzioni di controllo del modulo. Tipo di controllo modulo supportato: pulsante, casella di controllo, casella di gruppo, etichetta, pulsante di opzione, barra di scorrimento e casella di selezione. Se viene impostata una macro per il controllo del modulo, l'estensione della cartella di lavoro dovrebbe essere `.xlsm` o `.xltm`. Il valore di scorrimento deve essere compreso tra 0 e 30000.

Esempio 1, aggiungi il controllo del modulo del pulsante con macro, rich-text, dimensione del pulsante personalizzata, proprietà di stampa su `Foglio1!A2` e lascia che il pulsante non si sposti o non si ridimensioni con le celle:

<p align="center"><img width="180" src="./images/form_ctrl_button.gif" alt="aggiungi il controllo del modulo del pulsante con Excelize"></p>

```go
enable := true
err := f.AddFormControl("Foglio1", excelize.FormControl{
Cell: "A2",
Type: excelize.FormControlButton,
Macro: "Button1_Click",
Width: 140,
Height: 60,
Text: "Pulsante 1\r\n",
Paragraph: []excelize.RichTextRun{
{
Font: &excelize.Font{
Bold: true,
Italic: true,
Underline: "single",
Family: "Times New Roman",
Size: 14,
Color: "777777",
},
Text: "C1=A1+B1",
},
},
Format: excelize.GraphicOptions{
PrintObject: &enable,
Positioning: "absolute",
},
})
```

Esempio 2, aggiungi i controlli del modulo del pulsante di opzione con stato selezionato e testo su `Foglio1!A1` e `Foglio1!A2`:

<p align="center"><img width="152" src="./images/form_ctrl_option_button.gif" alt="aggiungere controlli del modulo del pulsante di opzione con Excelize"></p>

```go
if err := f.AddFormControl("Foglio1", excelize.FormControl{
Cell: "A1",
Type: excelize.FormControlOptionButton,
Text: "Pulsante di opzione 1",
Checked: true,
Height: 20,
}); err != nil {
fmt.Println(err)
}
if err := f.AddFormControl("Foglio1", excelize.FormControl{
Cell: "A2",
Type: excelize.FormControlOptionButton,
Text: "Pulsante di opzione 2",
Height: 20,
}); err != nil {
fmt.Println(err)
}
```

Esempio 3, aggiungi il controllo del modulo del pulsante di selezione su `Foglio1!B1` per aumentare o diminuire il valore di `Foglio1!A1`:

<p align="center"><img width="126" src="./images/form_ctrl_spin_button.gif" alt="aggiungi il controllo del modulo del pulsante di selezione con Excelize"></p>

```go
err := f.AddFormControl("Foglio1", excelize.FormControl{
Cell: "B1",
Type: excelize.FormControlSpinButton,
Width: 15,
Height: 40,
CurrentVal: 7,
MinVal: 5,
MaxVal: 10,
IncChange: 1,
CellLink: "A1",
})
```

Esempio 4, aggiungi il controllo del modulo con barra di scorrimento orizzontale su `Foglio1!A2` per modificare il valore di `Foglio1!A1` facendo clic sulle frecce di scorrimento o trascinando la casella di scorrimento:

<p align="center"><img width="180" src="./images/form_ctrl_scroll_bar.gif" alt="aggiungi il controllo del modulo della barra di scorrimento orizzontale con Excelize"></p>

```go
err := f.AddFormControl("Foglio1", excelize.FormControl{
Cell: "A2",
Type: excelize.FormControlScrollBar,
Width: 140,
Height: 20,
CurrentVal: 50,
MinVal: 10,
MaxVal: 100,
IncChange: 1,
PageChange: 1,
CellLink: "A1",
Horizontally: true,
})
```

## Ottieni i controlli del modulo {#GetFormControls}

```go
func (f *File) GetFormControls(sheet string) ([]FormControl, error)
```

GetFormControls recupera tutti i controlli del modulo in un foglio di lavoro in base a un determinato nome del foglio di lavoro. Tieni presente che questa funzione al momento non supporta l'ottenimento della larghezza e dell'altezza dei controlli del modulo.

## Elimina il controllo del modulo {#DeleteFormControl}

```go
func (f *File) DeleteFormControl(sheet, cell string) error
```

DeleteFormControl fornisce il metodo per eliminare il controllo del modulo in un foglio di lavoro in base al nome del foglio di lavoro e al riferimento alla cella. Ad esempio, elimina il controllo del modulo in `Foglio1!$A$1`:

```go
err := f.DeleteFormControl("Foglio1", "A1")
```

0 comments on commit dc6a760

Please sign in to comment.