Proprietà Printer.PrintAction

Articolo
09/12/2008

Aggiornamento: novembre 2007

Ottiene o imposta un valore che determina se l'output di stampa viene diretto a una stampante, una finestra di anteprima di stampa o un file.

Spazio dei nomi: Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintassi

Public Property PrintAction As PrintAction

Dim instance As Printer
Dim value As PrintAction

value = instance.PrintAction

instance.PrintAction = value

public PrintAction PrintAction { get; set; }

public:
property PrintAction PrintAction {
    PrintAction get ();
    void set (PrintAction value);
}

public function get PrintAction () : PrintAction
public function set PrintAction (value : PrintAction)

Valore proprietà

Tipo: System.Drawing.Printing.PrintAction

Restituisce un'enumerazione PrintAction.

Note

Quando viene selezionato l'oggetto PrintToPrinter, l'output di stampa viene diretto alla stampante predefinita del computer. Se non è installata alcuna stampante, viene generato un errore.

Quando viene selezionato l'oggetto PrintToPreview, l'output di stampa viene visualizzato in un controllo PrintPreviewDialog standard.

Quando viene selezionato l'oggetto PrintToFile, l'output di stampa viene salvato in un file Encapsulated PostScript (.eps, .ps o .ai) nel percorso specificato dalla proprietà PrintFileName. Se non è specificato alcun nome di file, viene generato un errore. I file vengono salvati in formato PostScript con gradazioni di grigio a 8 bit. Il formato PostScript RGB a 24 bit non è supportato.

Nota:
All'utente non viene richiesto di specificare un percorso o un'estensione di file. Per assicurarsi che il file presenti un percorso e un'estensione validi, è possibile implementare una propria finestra di dialogo. Per eseguire questa operazione, utilizzare un componente SaveFileDialog e assegnare il valore restituito alla proprietà PrintFileName prima di chiamare il metodo Print.

Nella tabella riportata di seguito vengono elencati i valori di PrintAction validi per la proprietà PrintAction.

Nome dell'enumerazione	Descrizione
PrintToFile	L'operazione di stampa viene diretta a un file.
PrintToPreview	L'operazione di stampa viene diretta a una finestra di dialogo di anteprima di stampa.
PrintToPrinter	L'operazione di stampa viene diretta a una stampante.

Nota:
Le funzioni e gli oggetti nello spazio dei nomi Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 vengono forniti per essere utilizzati dagli strumenti per l'aggiornamento da Visual Basic 6.0 a Visual Basic 2008. Nella maggior parte dei casi, tali funzioni e oggetti duplicano le funzionalità disponibili in altri spazi dei nomi in .NET Framework. Sono necessari, pertanto, solo quando il modello di codice di Visual Basic 6.0 differisce in modo significativo dall'implementazione di .NET Framework.

Le funzioni e gli oggetti nello spazio dei nomi Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 vengono forniti per essere utilizzati dagli strumenti per l'aggiornamento da Visual Basic 6.0 a Visual Basic 2008. Nella maggior parte dei casi, tali funzioni e oggetti duplicano le funzionalità disponibili in altri spazi dei nomi in .NET Framework. Sono necessari, pertanto, solo quando il modello di codice di Visual Basic 6.0 differisce in modo significativo dall'implementazione di .NET Framework.

Esempi

Nell'esempio riportato di seguito viene illustrato come impostare la proprietà PrintAction. È necessario disporre di tre controlli RadioButton che consentano all'utente di selezionare un metodo di stampa.

Dim Printer As New Printer
If RadioButton1.Checked = True Then
    Printer.PrintAction = Printing.PrintAction.PrintToPrinter
ElseIf RadioButton2.Checked = True Then
    Printer.PrintAction = Printing.PrintAction.PrintToPreview
Else
    Printer.PrintFileName = _ My.Computer.FileSystem.SpecialDirectories.CurrentUserApplicationData _ 
    & "Form1.eps"
    Printer.PrintAction = Printing.PrintAction.PrintToFile
End If

Autorizzazioni

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.