LabVIEW 6 OK bis_7:LabVIEW_05

06
SCUOLA DI LABVIEW
Training per esperti
RICHIAMARE OGGETTI
IN LABVIEW
a cura di Matteo Foini
LabVIEW permette di accedere ad altre applicazioni Windows utilizzando le tecnologie .NET o ActiveX
Il termine .NET fa riferimento alla tecnologia .NET di
Microsoft. Il framework .NET è la base di programmazione
dell’ambiente .NET per costruire, rilasciare ed eseguire
applicazioni basate su Web, applicazioni smart client e Web
service XML. È quindi necessario installare il framework .NET.
Per maggiori informazioni si può consultare il sito Web MSDN.
Nota Creare e comunicare con oggetti .NET richiede
il .NET Framework 1.1 Service Pack 1 o successivo.
Inoltre, National Instruments raccomanda vivamente di utilizzare
solo oggetti .NET nei progetti LabVIEW.
Il termine ActiveX si riferisce invece alla tecnologia ActiveX
e alla tecnologia OLE di Microsoft. Con ActiveX
Automation, un’applicazione Windows, come LabVIEW,
fornisce un set pubblico di oggetti, comandi e funzioni a cui
altre applicazioni Windows possono accedere.
In questa prima parte verranno discussi i seguenti argomenti:
A. Richiamo di oggetti in LabVIEW utilizzando ActiveX
B. Uso di LabVIEW come Client ActiveX
C. Uso di LabVIEW come Server ActiveX
D. Eventi ActiveX
Nella seconda parte, che verrà pubblicata sul numero di
Settembre, verranno invece trattati i temi seguenti:
E. Richiamo di oggetti in LabVIEW utilizzando .NET
F. Implementazione di .NET
G. Registriazione di Eventi .NET
A. Richiamo di oggetti in LabVIEW utilizzando ActiveX
Potete utilizzare LabVIEW come client ActiveX per accedere
ad oggetti, proprietà, metodi ed eventi associati ad altre
applicazioni abilitate ActiveX.
LabVIEW può operare anche come server ActiveX, permettendo
ad altre applicazioni di accedere ad oggetti, proprietà
e metodi di LabVIEW.
Oggetti, proprietà, metodi ed eventi ActiveX
Le applicazioni abilitate ActiveX includono oggetti aventi
proprietà e metodi accessibili ad altre applicazioni. Gli
oggetti possono essere visibili agli utenti, come nel caso di
pulsanti, finestre, immagini, documenti ed aree di dialogo, o
invisibili agli utenti, come oggetti di applicazioni. Potete
accedere a un’applicazione accedendo a un oggetto associato
a quell’applicazione e settando una proprietà o invocando
un metodo di quell’oggetto.
Gli eventi sono le azioni eseguite su un oggetto, come cliccare
un mouse, premere un tasto o ricevere notifiche circa
fatti come l’esaurimento della memoria o il completamento
di task. Ogni volta che queste azioni si verificano sull’oggetto,
l’oggetto invia un evento per avvertire il contenitore
ActiveX, insieme ai dati specifici all’evento. L’oggetto
ActiveX definisce gli eventi disponibili per un oggetto.
VI ActiveX, funzioni, controlli e indicatori
Utilizzate i VI, le funzioni, i controlli e gli indicatori seguenti
per accedere ad oggetti, proprietà, metodi ed eventi associati
ad altre applicazioni abilitate ActiveX:
• Usate il controllo automation refnum per creare un riferimento
ad un oggetto ActiveX. Cliccate con il tasto destro su
questo controllo sul pannello frontale per selezionare un
oggetto dalla type library a cui volete accedere.
• Usate la funzione Automation Open per aprire un oggetto
ActiveX.
• Usate il contenitore ActiveX per accedere ad un oggetto
ActiveX sul pannello frontale e visualizzarlo. Cliccate con il
tasto destro sul contenitore, selezionate Insert ActiveX
Object nel menu abbreviato e selezionate l’oggetto a cui
volete accedere.
• Usate il Property Node per leggere (get) o scrivere (set) le
proprietà associate ad un oggetto ActiveX.
• Usate l’Invoke Node per invocare i metodi associati a un
oggetto ActiveX.
• Usate la funzione Register Event Callback per gestire gli
eventi che si verificano su un oggetto ActiveX.
• Usate il controllo e l’indicatore variant per trasferire dati
verso o da controlli ActiveX.
Suggerimento Selezionate Tools».NET & ActiveX»Add
ActiveX Controls to Palette per aggiungere file di controllo
custom alla palette dei controlli ActiveX.
B. Uso di LabVIEW come Client ActiveX
Quando LabVIEW accede agli oggetti associati a un’altra
applicazione abilitata ActiveX, agisce come client ActiveX.
Potete usare LabVIEW come client ActiveX nei modi seguenti:
30

SCUOLA DI LABVIEW
• Aprite un’applicazione, come Microsoft Excel, create un
documento ed aggiungete dati al documento.
• Incorporate un documento, come un documento
Microsoft Word o uno spreadsheet Excel, sul pannello frontale
in un contenitore.
• Piazzate sul pannello frontale un pulsante o un altro
oggetto di un’altra applicazione, come un pulsante Help
che richiama il file help dell’altra applicazione.
• Linkate da un’altra applicazione un controllo ActiveX che
avete costruito.
LabVIEW accede a un oggetto ActiveX con il controllo automation
refnum o il contenitore ActiveX, che sono entrambi
oggetti del pannello frontale. Usate il controllo automation
refnum per selezionare un oggetto ActiveX. Usate il contenitore
ActiveX per selezionare un oggetto ActiveX visualizzabile,
come un pulsante o un documento, e piazzatelo sul
pannello frontale. Entrambi gli oggetti appaiono come controlli
automation refnum sullo schema a blocchi.
La fig. 1 illustra come LabVIEW, operando come client
ActiveX, interagisce con le applicazioni server.
Figura 1 - LabVIEW come ActiveX Automation Client
LabVIEW accede alla type library del server per ottenere
informazioni circa i suoi oggetti, metodi e proprietà.
LabVIEW può eseguire azioni come invocare metodi, leggere
o scrivere proprietà e così via.
Accesso ad un’applicazione abilitata ActiveX
Per accedere a un’applicazione abilitata ActiveX, usate il
controllo automation refnum sullo schema a blocchi per
creare un riferimento a un’applicazione. Collegate il controllo
alla funzione Automation Open, che apre
l’applicazione chiamante. Usate il Property Node per selezionare
e accedere alle proprietà associate con l’oggetto.
Usate l’Invoke Node per selezionare e accedere ai metodi
associati con l’oggetto. Chiudete il riferimeno all’oggetto
usando la funzione Close Reference.
Chiudendo il riferimento si rimuove l’oggetto dalla memoria.
Per esempio, potete costruire un VI che apre Microsoft Excel
in modo che appaia sullo schermo dell’utente, crei un workbook,
crei uno spreadsheet, crei una tabella in LabVIEW e
scriva tale tabella nello spreadsheet Excel.
Consultate il VI Write Table To XL in labview\examples\
comm\ExcelExamples.llb per un esempio sull’uso di
LabVIEW come client Excel.
Inserimento di un oggetto ActiveX sul pannello
frontale
Per inserire un oggetto ActiveX sul pannello frontale, cliccate
con il tasto destro sul contenitore ActiveX, selezionate Insert
ActiveX Object dal menu abbreviato e selezionate il controllo
o il documento ActiveX che volete inserire. Potete settare
le proprietà di un oggetto ActiveX usando l’ActiveX Property
Browser o le pagine delle proprietà, oppure potete settare le
proprietà da programma usando il Property Node.
Usate l’Invoke Node per invocare i metodi associati con
l’oggetto.
Per esempio, potete visualizzare una pagina Web sul
pannello frontale usando un contenitore ActiveX per
accedere al controllo Microsoft Web Browser, selezionando
la classe di metodi Navigate, selezionando
il metodo URL e specificando l’URL.
Se usate il contenitore ActiveX, non dovete collegare
il controllo automation refnum sullo schema a blocchi
alla funzione Automation Open o chiudere il rifrimento
all’oggetto usando la funzione Close
Reference. Potete collegare direttamente l’Invoke
Node o il Property Node perché il contenitore ActiveX
incorpora l’applicazione chiamante in LabVIEW.
Tuttavia, se il contenitore ActiveX include proprietà o
metodi che restituiscono altri automation refnum,
dovete chiudere tali riferimenti addizionali.
Design Mode per oggetti ActiveX
Cliccate con il tasto destro su un contenitore
ActiveX e selezionate Advanced»Design Mode
dal menu abbreviato per visualizzare il contenitore in design
mode mentre editate il VI. In design mode non vengono
generati eventi e non sono eseguite procedure di evento. La
modalità di default è la run mode, nella quale potete interagire
con l’oggetto come farebbe l’utente.
Impostazione delle proprietà ActiveX
Dopo avere aperto un server ActiveX o avere inserito un controllo
o un documento ActiveX, potete settare le proprietà
associate a quel controllo o documento usando l’ActiveX
Property Browser, le pagine delle proprietà e il Property Node.
ActiveX Property Browser
Usate l’ActiveX Property Browser per visualizzare e impostare
tutte le proprietà associate a un controllo o documento
ActiveX in un contenitore ActiveX. Per accedere
31

06
SCUOLA DI LABVIEW
all’ActiveX Property Browser, cliccate con il tasto destro sul
controllo o documento nel contenitore sul pannello frontale
e selezionate Property Browser nel menu abbreviato.
Potete anche selezionare Tools».NET & ActiveX»Browse
ActiveX Properties. L’ActiveX Property Browser è un
modo semplice per impostare le proprietà di un oggetto
ActiveX interattivamente, ma non potete usare il browser
per impostare le proprietà da programma e potete usare
l’ActiveX Property Browser solo con oggetti ActiveX in un
contenitore. L’ActiveX Property Browser non è disponibile in
run mode o mentre viene eseguito un VI.
Pagine delle proprietà ActiveX
Molti oggetti ActiveX includono pagine di proprietà, che organizzano
le proprietà associate con l’oggetto su tab separati.
Per accedere alle pagine delle proprietà ActiveX, cliccate con il
tasto destro sull’oggetto nel contenitore sul pannello frontale
e selezionate il nome dell’oggetto nel menu abbreviato.
Analogamente all’ActiveX Property Browser, anche le pagine
delle proprietà ActiveX sono un modo semplice per
impostare le proprietà di un oggetto ActiveX interattivamente,
ma non potete utilizzarle per impostare le proprietà
da programma, e potete usare le pagine delle proprietà solo
con gli oggetti ActiveX in un contenitore. Le pagine delle
proprietà non sono disponibili per tutti gli oggetti ActiveX.
Inoltre, le pagine delle proprietà non sono disponibili in run
mode o mentre il VI è in esecuzione.
Figura 2 - Cambiamento della proprietà Value per il controllo ActiveX CWButton
Property Node
Usate il Property Node per impostare le proprietà ActiveX da
programma. Per esempio, se usate un oggetto ActiveX per
avvertire un utente quando una temperatura supera un limite,
usate il Property Node per impostare la proprietà Value
dell’oggetto per specificare il limite.
Lo schema a blocchi di fig. 2 illustra un esempio che cambia
la proprietà Value per il controllo ActiveX CWButton, che
fa parte della National Instruments Measurement Studio
User Interface ActiveX Library, quando la temperatura raggiunge
o supera 85 gradi Fahrenheit.
In questo caso, il controllo CWButton opera come un LED,
cambia colori e visualizza ‘Warning’ quando la temperatura
raggiunge il limite, che è lo stato ‘on’ del controllo CWButton.
Nota In questo esempio, potete utilizzare l’ActiveX
Property Browser o le pagine delle proprietà per
impostare le proprietà OffText, OffColor, OnText e OnColor
per il controllo CWButton, perché non è necessario impostare
queste proprietà da programma.
C. Uso di LabVIEW come Server ActiveX
L’applicazione LabVIEW, i VI e le proprietà e i metodi di controllo
sono disponibili tramite chiamate ActiveX da altre
applicazioni. Altre applicazioni abilitate ActiveX, come
Microsoft Excel, possono richiedere proprietà, metodi e singoli
VI da LabVIEW, e LabVIEW opera come server ActiveX.
Per esempio, potete incorporare un VI graph in uno spreadsheet
Excel e dallo spreadsheet inserire dati negli input del
VI ed eseguire il VI. Quando eseguite il VI, i dati sono plottati
nel grafico.
Consultate labview\examples\comm\freqresp.xls per un
esempio d’uso delle proprietà e dei metodi LabVIEW in uno
spreadsheet Excel. LabVIEW supporta un’interfaccia ActiveX
verso il VI Server. Tale interfaccia con il server permette alle
applicazioni client di accedere da programma a LabVIEW.
La fig. 3 illustra come LabVIEW opera come server ActiveX
per interagire con le applicazioni client.
La type library di LabVIEW, labview.tlb, fornisce informazioni
circa oggetti, metodi e proprietà di LabVIEW. Le applicazioni
client possono accedere ai metodi e scrivere o leggere
proprietà del server ActiveX LabVIEW.
Potete usare LabVIEW come server ActiveX, permettendo ad
altri client abilitati ActiveX di richiedere proprietà e metodi
da LabVIEW e singoli VI. Per configurare LabVIEW come server
ActiveX, selezionate Tools»Options per visualizzare
l’area di dialogo Options. Selezionate VI Server: Confi -
guration nel menu a tendina superiore e mettete un segno
di spunta su ActiveX.
Supporto per interfacce ActiveX Automation personalizzate
Se state scrivendo un client ActiveX che accede a proprietà
e metodi di un server ActiveX usando LabVIEW, potete accedere
alle interfacce custom esposte dal server. A tale scopo,
non è necessario utilizzare IDispatch. Tuttavia, lo sviluppatore
del server ActiveX deve fare in modo che i parametri
delle proprietà e dei metodi in tali interfacce custom abbiano
tipi di dati Automation (IDispatch). Lo sviluppatore del
server deve fare in questo modo per esporre più interfacce
da un oggetto, anziché da più oggetti.
32

SCUOLA DI LABVIEW
Gestione di Eventi ActiveX
Dovete creare un VI di callback per gestire eventi dai controlli
ActiveX quando i controlli stessi generano gli eventi
registrati. Il VI di callback viene eseguito al verificarsi dell’evento.
Per creare un VI di callback, cliccate
con il tasto destro sull’input VI Ref della funzione
Register Event Callback e selezionate
Create Callback VI nel menu abbreviato.
LabVIEW crea un VI rientrante. Aprite il VI ed
editate lo schema a blocchi per gestire l’evento.
Il VI di callback contiene i seguenti elementi:
Figura 3 - LabVIEW ActiveX Automation Server
D. Eventi ActiveX
Per usare eventi ActiveX in un’applicazione, dovete registrare
l’evento e gestirlo quando si verifica. La registrazione degli
eventi ActiveX è simile alla registrazione degli eventi dinamici.
Tuttavia, l’architettura del VI di un evento ActiveX è diversa
dall’architettura di un VI di gestione eventi. Un tipico VI di
evento ActiveX è formato dai seguenti componenti:
• Oggetto ActiveX per il quale desiderate generare un evento.
• Funzione Register Event Callback per specificare e registrare
il tipo di evento che volete generare.
• VI Callback contenente il codice che dovete scrivere per
gestire l’evento che specificate.
Potete generare e gestire eventi relativi a oggetti ActiveX in
un contenitore o relativi a oggetti ActiveX che specificate
usando un Automation Refnum. Per esempio, potete chiamare
un controllo ad albero Windows da un contenitore
ActiveX e specificare che volete generare un evento Double
Click per gli elementi visualizzati nel controllo ad albero.
La funzione Register Event Callback è un nodo ridimensionabile
in grado di gestire più eventi, analogamente alla funzione
Register For Events.
Quando cablate la reference di un oggetto ActiveX alla funzione
Register Event Callback e specificate l’evento che volete
generare per quell’oggetto, state registrando l’oggetto ActiveX
per quell’evento. Dopo la registrazione, create un VI di callback
che contiene il codice scritto per gestire l’evento.
Eventi diversi possono avere formati dati differenti, quindi
cambiare l’evento dopo avere creato un VI di callback potrebbe
rompere i fili di connessione sullo schema a blocchi.
Selezionate quindi l’evento prima di creare il VI di callback.
• Event common data contiene i seguenti
elementi:
• Source è un controllo numerico che specifica
la sorgente dell’evento, come LabVIEW o
ActiveX. Un valore 1 indica un evento
ActiveX.
• Type specifica quale evento si è verificato. Questo è un tipo
enumerato per gli eventi dell’interfaccia utente e un tipo intero
senza segno a 32 bit per le sorgenti ActiveX e altre sorgenti
di eventi. Per gli eventi ActiveX, il tipo di evento rappresenta
il codice del metodo, o ID, per l’evento registrato.
• Time è il time stamp in millisecondi che specifica quando
è stato generato l’evento.
• Control Ref è un riferimento all’ActiveX o all’Auto -
mation Refnum su cui si è verificato l’evento.
• Event Data è un cluster dei parametri specifici all’evento
gestito dal VI di callback. LabVIEW determina
l’appropriato Event Data quando selezionate un evento
dalla funzione Register Event Callback. Se un evento non ha
alcun dato associato ad esso, LabVIEW non crea questo
controllo nel VI di callback.
• Event Data Out è un cluster dei parametri modificabili
specifici all’evento gestito dal VI di callback. Tale elemento
è disponibile solo se l’evento ActiveX ha parametri d’uscita.
• (Opzionale) User Parameter è il dato che si desidera
passare al VI di callback quando l’oggetto ActiveX genera
l’evento.
Nota Potete usare un VI esistente come VI di callback
purché il pannello dei connettori del VI che intendete
utilizzare corrisponda al pannello dei connettori dei dati di
evento. Il VI di callback deve essere rientrante e la reference
al VI di callback deve essere strettamente tipizzato.
Non potete eseguire chiamate sincrone a finestre di dialogo
non modali da un VI di callback. Dovete chiamarle in modo
asincrono da un VI di callback invocando un metodo Run VI
e scrivendo una costante booleana FALSE all’ingresso Wait
Until Done del metodo.
Note sull’autore
Laureato in ingegneria nucleare al Politecnico di Milano, Matteo
Foini lavora in qualità di Technical Marketing Engineer presso
National Instruments Italy
Readerservice.it n. 626
33