Poshboard permet de lier des évènements à différents types de contrôles qui permettent de transformer des éléments Silverlight de votre page grâce au résultat de scripts Powershell.

Les évènements permettent d'invoquer un script quand l'utilisateur intéragit avec le portail. Pour le moment, 3 contrôles proposent des évènements (ceci sera étendu dans les prochaines mises à jour)

Les contrôles avec des évènements sont :

• Button > Click
• ComboBox > SelectionChanged
• ListBox > SelectionChanged

• Source : Le nom de l'objet auquel est rattaché l'évènement. Ceci est automatiquement renseigné quand vous liez un évènement à un contrôle avec le cmdlet Add-PBEvent
• Name : Le nom de l'évènement (click, SelectionChanged, etc...)
• Target: Le PBElement qui sera la cible de la mise à jour par le script de l'évènement.
• Script: Le script ou la référence de script qui sera éxecuté par l'évènement.
• References: une liste de PBElements qui pourront mettre à jour le script avant son exécution.

Exemple 1 : création basique d'évènement

Dans cette exemple nous allons créer une mise en forme basique composée d'une grid contenant un bouton et une textbox. Quand nous allons cliquer sur le bouton, un script "Get-Process" va être invoqué et son résultat affiché dans la textbox.

$outputbox = New-PBTextbox -Row 0 -Name output
$button = new-pbbutton -row 1 -text "Press Me" -fontsize 14
add-pbevent -input $button -name click -script "Get-Process" -target $outputbox
 
$grid = new-pbgrid -columns ("1*") -Rows ("1*",50)
add-pbitem $grid ($outputbox,$button)
 
$grid

add-pbevent -input $button -name click -script "Get-Process" -target $outputbox

Nous faisons référence ici à l'évènement "click" du bouton. J'ai ensuite ajouté le script "Get-Process" en tant qu'attribut pour le paramètre -Script, et j'ai spécifié que l'objet $outputbox est la cible du résultat du script.

Le résultat dépend donc de la cible du script. PoshBoard analyse le contrôle proposé en cible et adapte le résultat du script en conséquence : si je propose une textbox, il va soit prendre la propriété "Text" de l'objet retourné par le script si celui ci est un PBElement (une textbox par exemple), ou convertir la sortie du script en texte brut si celle ci n'est pas un PBElement.

Si la cible était un graphique, PoshBoard aurait analyser le PBElement fournis par la sortie du script et pris les informations liées à un graphique (propriétés titre, legendes, etc...,) et la propriété "ChartSeries". Voyons cela dans un nouvel exemple.

Exemple 2 : cible graph avec un évènement multi-ligne.

Voici un nouvel exemple avec la technique de base d'implémentation de script d'évènement. Ici, mon script est sur plusieurs ligne. Nous pouvons utiliser une chaine de texte en tant qu'attribut pour le paramètre -Script :

$script = @'
$files = dir C:\windows|sort length|select -first 10
$files|out-pbchart length -dpnames Name -RenderAs bar -Name "FileSize" -Title "Files Size"
'@
 
$grid = New-PBGrid -Columns ("1*") -Rows ("1*",50)
$chart = New-PBChart -Name "OutChart"
$button = new-pbbutton -row 1 -text "Press Me" -fontsize 14
 
add-pbevent -inputobject $button -name click -script $script -target $chart
add-pbitem $grid ($chart,$button)
$grid

Comme vous pouvez le voir, PoshBoard utilise a présent la variable $script en tant que paramètre de -Script.

J'ai juste définis mon objet chart ($chart) à la place de la textbox en cible. PoshBoard sait que ce script va retourner un PBElement de type chart et va récupérer son contenu pour mettre à jour la cible. Bien entendu, si votre script ne retourne pas un objet PBElement de type chart, une erreur va se produire.

Dans le prochain article, nous allons voir des techniques plus avancées de création d'évènement, notamment la modification dynamique de script et d'autre moyens d'utiliser/réutiliser le code du script principal dans les évènements.