Per includere il Print Engine di NiceLabel nell’applicazione, sarà necessario creare un riferimento all'assembly di SDK.NET.Interface.dll. Il file è solitamente localizzato nella cartella c:\Program Files\NiceLabel\NiceLabel 10\\bin.net\.
È consigliabile conservare i file di NiceLabel .NET API in una cartella separata dal file eseguibile dell'applicazione. Dopo aver fatto riferimento a SDK.NET.Interface.dll, è possibile copiare il file .dll nella cartella bin dell'applicazione.
I componenti NiceLabel .NET API non hanno capacità di progettazione di etichette e nessuna interfaccia utente. NiceLabel .NET API è un motore di stampa incorporato in altre applicazioni.
I modelli di etichette, utilizzati dal Print Engine di NiceLabel per la stampa, devono essere creati in NiceLabel Desktop Designer. È lo strumento di progettazione delle etichette per creare il layout grafico dei modelli di etichette, definire le proprietà degli oggetti e i campi variabili.
Utilizzare NiceLabel Desktop Designer per creare i modelli di etichette, e utilizzare NiceLabel .NET API per unire i dati utente e gestire la stampa delle etichette.
Tutte le caratteristiche di NiceLabel .NET API sono esposte attraverso l’interfaccia NiceLabel.SDK.IPrintEngine.
Quando l'applicazione si riferisce all'assembly SDK.NET.Interface.dll, l’assembly può accedere alla classe statica PrintEngineFactory. Prima di usare qualsiasi altra proprietà, l'applicazione deve impostare la proprietà SDKFilesPath. Questa operazione è necessaria affinché la libreria possa accedere ai file NiceLabel .NET API, i quali possono trovarsi in posizioni diverse.
Quando la posizione è nota, l'applicazione può recuperare l'interfaccia IPrintEngine accedendo alla proprietà PrintEngineFactory.PrintEngine.
Dopo aver recuperato PrintEngine, è necessario eseguire una chiamata al metodo Initialize() dell’istanza IPrintEngine restituita.
IPrintEngine printEngine = PrintEngineFactory.PrintEngine; printEngine.Initialize();
Prima di terminare l'applicazione, è necessario chiamare il metodo Shutdown() dell'istanza IPrintEngine per rilasciare tutte le risorse usate dalla biblioteca.
Il metodo OpenLabel() consente all'applicazione di gestire i modelli ai quali gli utenti possono accedere. I modelli possono essere aperti dai file sul file system del client oppure dagli oggetti System.IO.Stream per gli utenti che desiderano distribuirli incorporati nell'applicazione o gestirli in un database.
Gli utenti di Control Center possono gestire i file di etichette nell'archivio Documenti.
Il Print Engine di NiceLabel fornisce un elenco di driver di stampa disponibili localmente per le proprie applicazioni e riduce la necessità di codifica.
La selezione della stampante segue la gerarchia:
-
La proprietà
PrinterName. -
Il nome della stampante memorizzato nel modello di etichetta.
-
La stampante predefinita del sistema.
Nota
Le applicazioni basate su NiceLabel .NET API utilizzano lo stesso motore di stampa per le anteprime e la stampa, pertanto le anteprime grafiche delle etichette sono identiche alle etichette stampate.
Con il metodo GetLabelPreview(), l'applicazione può recuperare un'anteprima grafica della prossima etichetta che verrà stampata.
Il metodo PrintToGraphics() genera una serie di immagini di tutte le etichette che potrebbero venire stampate. In questo modo è possibile lavorare con prove di concetto.
La tecnologia NiceLabel consente di stampare su qualsiasi stampante con un driver Windows. L’output di NiceLabel fornisce inoltre i comandi della stampante per oltre 4000 diversi modelli di stampante, consentendo di utilizzare le funzionalità native della stampante, come codici a barre interni, caratteri e contatori.
NiceLabel .NET API offre tre diverse modalità di stampa:
-
Stampa sincrona. Questa modalità mantiene una connessione al processo di stampa. Con questa modalità, l'applicazione invia i dati al processo di stampa e mantiene la connessione stabilita finché il processo di stampa è occupato. Il richiamo del metodo
Print()restituisce il feedback sul processo di stampa. -
Stampa asincrona. Questa modalità elabora il processo di stampa nel proprio thread. Ciò migliora le prestazioni e fa aumentare il numero di processi di stampa che possono essere elaborati in un lasso di tempo. Quando si utilizza il metodo
PrintAsync(), il chiamante viene avvisato tramite i gestori di eventi, nel momento in cui lo stato del processo di stampa cambia. -
Stampa della sessione. Si utilizza questa opzione quando non si desidera interrompere i lavori di stampa o è necessario stampare etichette diverse su una singola pagina, NiceLabel abilita questa opzione con la stampa della sessione.
Tutte le etichette all'interno della stampa di un'unica sessione vengono inviate alla stampante come un unico processo, assicurando l'ordine di stampa corretto.
Ciascuna stampa di sessione include tre fasi:
-
StartSessionPrint()inizializza una nuova sessione di stampa. -
SessionPrint()aggiunge una richiesta di stampa alla sessione corrente e può essere chiamato più volte. -
EndSessionPrint()finalizza la sessione corrente.
-
NiceLabel .NET API consente di monitorare il processo di stampa attraverso gli aggiornamenti dello stato del lavoro di stampa indipendentemente dalla modalità di stampa dell'etichetta scelta. Questo accesso dettagliato al processo di stampa consente di controllare e rispondere correttamente a qualsiasi situazione.
Tutte le eccezioni dal Print Engine di NiceLabel sono del tipo SDKException. Questa classe contiene informazioni dettagliate sugli errori che potrebbero verificarsi.
Gli utenti di Control Center possono registrare gli eventi di stampa di ciascun client nel database di Control Center. È possibile esaminare le informazioni raccolte dall'interfaccia web centralizzata di Control Center.
Per ulteriori dettagli, vedere il Riferimento di programmazioneNiceLabel .NET API.