Dialog components

Indice

• Components
• Button
• Check
• Text
• Group
• Icon
• Edit
• Scroll
• Link
• Menu
• Radio
• Tab
• List
• Combo

I Dialog Components sono elementi individuali di dialogo che possono essere aggiunti alla finestra principale del dialog. Qui sotto trovi un elenco dei componenti forniti nativamente da mIRC.

Components

Button

Il controllo button è un controllo di interfaccia utente che risponde agli eventi di click.

Synopsis

button "<text>", <id>, <x> <y> <width> <height>[, <style>]

Styles

/did

• -f - imposta il focus sul button
• -t - imposta il button come pulsante predefinito
• -e - abilita il button
• -b - disabilita il button
• -v - rende visibile il button
• -h - nasconde il button
• -r - cancella il testo, caption, del button
• -a - aggiunge testo al caption del button

$did

$did(<name>,<id>)[.property]

Senza proprietà, restituisce il testo, caption, del button, come la proprietà .text.

• .text - restituisce il testo del button, caption
• .len - restituisce la lunghezza del testo del button
• .next - restituisce l’id del controllo successivo nell’ordine del tasto Tab
• .prev - restituisce l’id del controllo precedente nell’ordine del tasto Tab
• .visible - restituisce $true se il button è visibile, altrimenti $false
• .enabled - restituisce $true se il button è abilitato, altrimenti $false

Events

Example

; init alias
alias example { dialog -m example example }

; dialog structure
dialog example {
  title "Example"
  size -1 -1 100 50
  option dbu
  button "Example 1", 1, 4 10 40 12
  button "Example 2", 2, 50 10 40 12
  button "Example A", 3, 4 30 40 12
  button "Example B", 4, 50 30 40 12, ok
}

; event
on *:dialog:example:sclick:1-4:{
  echo -a $did($dname,$did).text is clicked.
}

Check

Il controllo checkbox è un elemento di interfaccia che consente all’utente di selezionare o deselezionare un’opzione. Il controllo check di mIRC ha tre stati: Checked, Unchecked e Indeterminate.

Synopsis

check "<text>", <id>, <x> <y> <width> <height>[, <style>]

Styles

/did

• -f - imposta il focus sul checkbox
• -t - imposta il checkbox come controllo predefinito
• -e - abilita il checkbox
• -b - disabilita il checkbox
• -v - rende visibile il checkbox
• -h - nasconde il checkbox
• -c - marca il checkbox come checked
• -u - marca il checkbox come unchecked; usando -cu su un 3state lo imposta come indeterminate
• -r - cancella il testo del checkbox
• -a - aggiunge testo al caption del checkbox

$did

$did(<name>,<id>)[.property]

Senza proprietà, restituisce il caption del checkbox, come .text.

• .text - restituisce il testo del checkbox
• .len - restituisce la lunghezza del testo del checkbox
• .state - restituisce lo stato: 0 = unchecked, 1 = checked, 2 = indeterminate
• .next - restituisce l’id del controllo successivo
• .prev - restituisce l’id del controllo precedente
• .visible - restituisce $true se il checkbox è visibile
• .enabled - restituisce $true se il checkbox è abilitato

Events

Example

alias example { dialog -m example example }

dialog example {
  title "Example"
  size -1 -1 100 50
  option dbu
  check "Example 1", 1, 4 10 40 12, 3state
  check "Example 2", 2, 50 10 40 12
  check "Example 3", 3, 4 30 40 12
  button "Done", 4, 50 30 40 12, ok
}

on *:dialog:example:init:0:{
  did -cu $dname 1
  did -c $dname 2
}

on *:dialog:example:sclick:1-3:{
  echo -a $did($dname,$did).text is clicked. State: $dstate $+ .
}

alias -l dstate {
  var %s UnChecked Checked Indeterminate
  return $gettok(%s,$calc($did($dname,$did).state + 1),32)
}

Text

Un controllo text è semplicemente una label GUI progettata per mostrare informazioni senza input da parte dell’utente. Per impostazione predefinita, il testo va a capo se necessario.

Synopsis

text "<text>", <id>, <x> <y> <width> <height>[, <style>]

Styles

/did

• -f - imposta il focus sul text control
• -e - abilita il text control
• -b - disabilita il text control
• -v - rende visibile il text control
• -h - nasconde il text control
• -r - cancella il testo del text control
• -a - aggiunge testo al text control

$did

$did(<name>,<id>)[.property]

• .text - restituisce il testo del text control
• .len - restituisce la lunghezza del testo
• .next - restituisce l’id del controllo successivo
• .prev - restituisce l’id del controllo precedente
• .visible - restituisce $true se visibile
• .enabled - restituisce $true se abilitato

Events

Example

alias example { dialog -m example example }

dialog example {
  title "Example"
  size -1 -1 100 70
  option dbu
  text "This label does not wrap.", 1, 4 10 40 15, nowrap
  text "This is a simple label.", 2, 4 30 40 15
  text "I am right-aligned.", 3, 4 50 40 15, right
  button "Done", 4, 50 30 40 12, ok
}

Group

Questo è un controllo statico con cornice di gruppo e un titolo opzionale mostrato nella parte alta.

Synopsis

box "<title>", <id>, <x> <y> <width> <height>[, <style>]

Styles

/did

• -f - imposta il focus sul box
• -e - abilita il box
• -b - disabilita il box
• -v - rende visibile il box
• -h - nasconde il box
• -r - cancella il caption del box
• -a - aggiunge testo al caption del box

$did

$did(<name>,<id>)[.property]

• .text - restituisce il testo del box
• .len - restituisce la lunghezza del testo del box
• .next - restituisce l’id successivo
• .prev - restituisce l’id precedente
• .visible - restituisce $true se il box è visibile
• .enabled - restituisce $true se il box è abilitato

Events

Questo controllo non ha eventi.

Example

alias example { dialog -m example example }

dialog example {
  title "Example"
  size -1 -1 90 120
  option dbu
  box "A Settings", 1, 4 4 80 40
  box "B Settings", 2, 4 50 80 40
  button "Done", 4, 40 100 40 12, ok
}

Icon

Un controllo icon è un contenitore semplice che ospita immagini e icone. Non puoi creare un controllo icon vuoto: devi fornire un filename.

Synopsis

icon <id>, <x> <y> <width> <height>[, <filename>[, <index>]], <style>

Styles

/did

• -f - imposta il focus sull’icon
• -e - abilita l’icon
• -b - disabilita l’icon
• -v - rende visibile l’icon
• -h - nasconde l’icon
• -g - imposta una nuova icon o bmp nel controllo icon, /did -g <name> <id> [n] <filename>

$did

$did(<name>,<id>)[.property]

• .next - restituisce l’id successivo
• .prev - restituisce l’id precedente
• .visible - restituisce $true se visibile
• .enabled - restituisce $true se abilitato

Events

Example

alias example { dialog -m example example }

dialog example {
  title "Example"
  size -1 -1 100 110
  option dbu
  icon 1, 10 10 80 80, "C:\Users\Public\Pictures\Sample Pictures\Penguins.jpg", actual
  button "Done", 7, 10 95 40 12, ok
}

Edit

Il controllo edit può comportarsi come una normale text box oppure come un rich text control.

Synopsis

edit "<text>", <id>, <x> <y> <width> <height>[, <style>]

Styles

/did

• -f - imposta il focus sull’editbox
• -e - abilita l’editbox
• -b - disabilita l’editbox
• -v - rende visibile l’editbox
• -h - nasconde l’editbox
• -r - cancella il testo dell’edit
• -a - aggiunge testo all’editbox; con stile multi puoi usare $crlf
• -n - abilita l’editbox
• -m - disabilita l’editbox
• -c - imposta il testo selezionato nell’editbox
• -d - se usi multi, elimina la riga N-esima
• -i - inserisce testo alla riga N-esima
• -o - sovrascrive la riga N-esima
• -j - resetta lo stato edited dell’editbox

$did

$did(<name>,<id>,[N])[.property]

• .text - restituisce il testo dell’editbox o la riga N-esima
• .len - restituisce la lunghezza del testo
• .lines - restituisce il numero di righe
• .sel - restituisce la riga iniziale della selezione
• .seltext - restituisce il testo selezionato
• .selstart - restituisce la posizione iniziale della selezione
• .selend - restituisce la posizione finale della selezione
• .edited - restituisce $true se il contenuto è stato modificato
• .next - restituisce l’id successivo
• .prev - restituisce l’id precedente
• .visible - restituisce $true se visibile
• .enabled - restituisce $true se abilitato

Events

Example

alias example { dialog -m example example }

dialog example {
  title "Example"
  size -1 -1 100 110
  option dbu
  edit "Left", 1, 10 10 80 20
  edit "Center", 2, 10 40 80 20, center
  edit "Right", 3, 10 70 80 20, right
  button "Done", 7, 10 95 40 12, ok
}

Scroll

Una scrollbar è un semplice componente di dialogo che può essere usato per scorrere qualcosa. Opera entro un intervallo definito.

Synopsis

scroll "<text>", <id>, <x> <y> <width> <height>, <style>

Styles

/did

• -f - imposta il focus sulla scrollbar
• -e - abilita la scrollbar
• -b - disabilita la scrollbar
• -v - rende visibile la scrollbar
• -h - nasconde la scrollbar
• -z - imposta il range della scrollbar

$did

$did(<name>,<id>)[.property]

• .sel - restituisce il valore della posizione corrente
• .lines - restituisce il valore massimo corrente del range
• .next - restituisce l’id successivo
• .prev - restituisce l’id precedente
• .visible - restituisce $true se visibile
• .enabled - restituisce $true se abilitata

Events

Example

alias example { dialog -m example example }

dialog example {
  title "Example"
  size -1 -1 90 65
  option dbu
  text "0%", 1, 30 20 20 20
  scroll "", 2, 60 5 5 40, range 0 100
  button "Done", 13, 25 50 40 12, ok
}

on *:dialog:example:scroll:2:{
  did -ra example 1 $did(example,2).sel $+ %
}

Link

Un controllo link, come una label, è un controllo statico con il comportamento aggiuntivo di diventare interattivo al passaggio del mouse, in genere per aprire un URL.

Synopsis

link "text", <id>, <x> <y> <width> <height>[, <style>]

Styles

/did

• -f - imposta il focus sul link
• -e - abilita il link
• -b - disabilita il link
• -v - rende visibile il link
• -h - nasconde il link
• -a - aggiunge testo al caption del link
• -r - elimina il testo del link

$did

$did(<name>,<id>)[.property]

• .text - restituisce il testo del link
• .next - restituisce l’id successivo
• .prev - restituisce l’id precedente
• .visible - restituisce $true se visibile
• .enabled - restituisce $true se abilitato

Events

Example

alias example { dialog -m example example }

dialog example {
  title "Example"
  size -1 -1 100 50
  option dbu
  link "http://www.wikichip.org/", 1, 4 10 80 12
  button "Done", 4, 50 30 40 12, ok
}

Menu

Un controllo menu consente un’organizzazione gerarchica di elementi chiamati menu items.

Synopsis

menu "<text>", <menuid> [, <menuid>]
item "<text>", <id> [, <menuid>]
item break, <id> [, <menuid>]

I menu item possono essere annidati sotto altri menu semplicemente specificando l’ID del menu padre.

Styles

Questo elemento non ha stili disponibili.

Events

/did

• -e - abilita il menu o item
• -b - disabilita il menu o item
• -v - rende visibile il menu o item
• -h - nasconde il menu o item
• -a - aggiunge un item a un menu
• -i - inserisce un item prima di uno specifico id
• -d - elimina l’item dal menu

$did

Non esiste supporto $did per un menu o un item.

Example

alias example { dialog -m example example }

dialog example {
  title "Example"
  size -1 -1 100 110
  option dbu
  menu "&File", 1
  item "&New", 11, 1
  item "&Open...", 12, 1
  item "&Save", 13, 1
  item "Save &As...", 14, 1
  menu "&Edit", 2
  item "Some Item1", 21, 2
  item break, 22, 2
  item "Some Item2", 23, 2
  menu "&View", 3
  item "Some Item3", 31, 3
  item break, 32, 3
  item "Some Item4", 33, 3
  menu "&Help", 4
  item "Some Item5", 41, 4
  item break, 42, 4
  item "Some Item6", 43, 4
  button "Done", 7, 10 95 40 12, ok
}

Radio

I radio buttons sono un gruppo di controlli configurabili per permettere all’utente di scegliere una sola opzione tra un insieme predefinito.

Synopsis

radio "<text>", <id>, <x> <y> <width> <height>[, <style> [group]]

Styles

/did

• -f - imposta il focus sul radio
• -t - imposta il radio come controllo predefinito
• -e - abilita il radio
• -b - disabilita il radio
• -v - rende visibile il radio
• -h - nasconde il radio
• -c - marca il radio come checked
• -u - marca il radio come unchecked
• -r - cancella il caption del radio
• -a - aggiunge testo al caption del radio

$did

$did(<name>,<id>)[.property]

• .text - restituisce il testo del radio
• .len - restituisce la lunghezza del testo
• .state - restituisce lo stato: 0 unchecked, 1 checked
• .next - restituisce l’id successivo
• .prev - restituisce l’id precedente
• .visible - restituisce $true se visibile
• .enabled - restituisce $true se abilitato

Events

Example

alias example { dialog -m example example }

dialog example {
  title "Example"
  size -1 -1 90 80
  option dbu

  ; 1st group
  text "Sex:", 1, 4 4 10 10
  radio "Male", 2, 4 13 20 10, group
  radio "Female", 3, 30 13 30 10

  ; 2nd group
  text "Marital Status:", 4, 4 25 50 10
  radio "Single", 5, 4 33 22 10, group left
  radio "Married", 6, 30 33 25 10, left
  radio "Other", 7, 60 33 22 10, left

  ; 3rd group
  text "Favorite Color:", 8, 4 45 50 10
  radio "Red", 9, 4 55 20 10, group push
  radio "Green", 10, 25 55 20 10, push
  radio "Blue", 11, 46 55 20 10, push
  radio "Other", 12, 67 55 20 10, push

  button "Done", 13, 40 68 40 12, ok
}

Tab

Un controllo tab è un componente contenitore capace di ospitare tutti gli altri componenti. Può avere più tab e ciascuna può contenere un diverso insieme di controlli.

Nota: in mIRC non puoi avere più di un tab control per dialog.

Synopsis

tab "<text>", <id>, <x> <y> <width> <height>, <style>
tab "<text>", <id>, <style>

La prima definizione specifica il controllo tab principale e la sua dimensione, mentre l’altra aggiunge un item alla tab. Per aggiungere un controllo a un item, specifica lo stile tab <id> sul controllo.

Styles

/did

• -fu - imposta il focus sulla tab
• -e - abilita la tab
• -b - disabilita la tab
• -v - rende visibile la tab
• -h - nasconde la tab
• -r - cancella il caption della tab item
• -a - aggiunge testo alla tab item

$did

$did(<name>,<id>)[.property]

• .text - restituisce il testo della tab item
• .len - restituisce la lunghezza del testo
• .next - restituisce l’id successivo
• .prev - restituisce l’id precedente
• .visible - restituisce $true se visibile
• .enabled - restituisce $true se abilitata

$dialog

Puoi usare $dialog(<name>).tab per sapere quale tab è selezionata al momento.

Events

Example

alias example { dialog -m example example }

dialog example {
  title "Example"
  size -1 -1 100 110
  option dbu
  tab "Tab 1", 1, 10 10 80 80
  tab "Tab 2", 2
  tab "Tab 3", 3
  button "111", 4, 20 30 40 40, tab 1
  button "222", 5, 20 30 40 40, tab 2
  button "333", 6, 20 30 40 40, tab 3
  button "Done", 7, 10 95 40 12, ok
}

List

Il controllo list fornisce un modo per visualizzare una lista di elementi.

Synopsis

list <id>, <x> <y> <width> <height>[, <style>]

Styles

/did

• -f - imposta il focus sulla list
• -e - abilita la list
• -b - disabilita la list
• -v - rende visibile la list
• -h - nasconde la list
• -c - seleziona la riga N-esima
• -u - deseleziona la riga N-esima
• -k - mantiene la selezione delle altre righe
• -s - con stili check o radio, marca checked la riga N-esima
• -l - con stili check o radio, marca unchecked la riga N-esima
• -r - svuota la list
• -a - aggiunge una riga alla fine
• -d - elimina la riga N-esima
• -i - inserisce una riga alla posizione N
• -o - sovrascrive la riga N-esima
• -z - resetta la larghezza della scrollbar orizzontale

$did

$did(<name>,<id>,[N])[.property]

• .text - restituisce la riga N-esima
• .len - restituisce la lunghezza della riga N-esima
• .lines - restituisce il numero di righe
• .sel - restituisce il numero di riga della N-esima riga selezionata, oppure il totale se N = 0
• .seltext - restituisce la prima riga selezionata
• .next - restituisce l’id successivo
• .prev - restituisce l’id precedente
• .visible - restituisce $true se visibile
• .enabled - restituisce $true se abilitata
• .csel - con radio o check, restituisce la N-esima riga checked o il totale se N = 0
• .cstate - con radio o check, restituisce lo stato checked della riga N: 1 checked, 0 unchecked

Events

Example

alias example { dialog -m example example }

dialog example {
  title "Example"
  size -1 -1 100 110
  option dbu
  list 1, 10 10 80 20, multsel
  list 2, 10 40 80 20, radio
  list 3, 10 70 80 20, check
  button "Done", 7, 10 95 40 12, ok
}

on 1:dialog:example:init:*:{
  did -a example 1 Item A
  did -a example 1 Item B
  did -a example 1 Item C
  did -a example 2 Item A
  did -a example 2 Item B
  did -a example 2 Item C
  did -a example 3 Item A
  did -a example 3 Item B
  did -a example 3 Item C
}

Combo

Il controllo combo permette di scegliere un elemento da una selezione, come lista o menu a discesa.

Synopsis

combo <id>, <x> <y> <width> <height>[, <style>]

Styles

/did

• -f - imposta il focus sul combo
• -e - abilita il combo
• -b - disabilita il combo
• -v - rende visibile il combo
• -h - nasconde il combo
• -c - seleziona la riga N-esima
• -r - svuota il combo; usa N = 0 per pulire l’editbox editabile
• -a - aggiunge una riga al combo; usa N = 0 per aggiungere all’editbox editabile
• -d - elimina la riga N-esima
• -i - inserisce una riga alla posizione N
• -o - sovrascrive la riga N-esima

$did

$did(<name>,<id>,[N])[.property]

• .text - restituisce la riga N-esima; usa N = 0 per il testo dell’editbox del combo editabile
• .len - restituisce la lunghezza della riga N-esima
• .lines - restituisce il numero di righe
• .sel - restituisce il numero della riga selezionata
• .seltext - restituisce la prima riga selezionata
• .next - restituisce l’id successivo
• .prev - restituisce l’id precedente
• .visible - restituisce $true se visibile
• .enabled - restituisce $true se abilitato

Events

Example

alias example { dialog -m example example }

dialog example {
  title "Example"
  size -1 -1 100 110
  option dbu
  combo 1, 10 10 80 50, drop
  combo 2, 10 50 80 50
  button "Done", 7, 10 95 40 12, ok
}

on 1:dialog:example:init:*:{
  did -a example 1 Item A
  did -a example 1 Item B
  did -a example 1 Item C
  did -a example 2 Item A
  did -a example 2 Item B
  did -a example 2 Item C
}

La pagina originale allegata sembra includere anche l’elenco completo dei componenti nativi, ma nel contenuto leggibile recuperato qui sopra le sezioni dettagliate disponibili arrivano fino a Combo.