Proprietà PrintForm.PrintAction

Articolo
09/12/2008

Aggiornamento: novembre 2007

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

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

Sintassi

<BrowsableAttribute(True)> _
Public Property PrintAction As PrintAction

Dim instance As PrintForm
Dim value As PrintAction

value = instance.PrintAction

instance.PrintAction = value

[BrowsableAttribute(true)]
public PrintAction PrintAction { get; set; }

[BrowsableAttribute(true)]
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 viene diretto alla stampante predefinita del sistema. È possibile eseguire l'override di questo comportamento e impostare in modo esplicito la stampante e le relative proprietà utilizzando la proprietà PrinterSettings. Se non è disponibile una stampante predefinita, all'utente viene richiesto di selezionarne una.

Quando viene selezionato l'oggetto PrintToPreview, il form viene visualizzato in un controllo Windows Form PrintPreviewDialog standard.

Quando viene selezionato l'oggetto PrintToFile, un'immagine del form viene salvata in un file Encapsulated PostScript (.eps, .ps o .ai) nel percorso specificato dalla proprietà PrintFileName. Se non è specificato alcun nome di file, all'utente viene richiesto di specificarlo.

Nota:
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.

Esempi

Nell'esempio riportato di seguito viene illustrato come impostare la proprietà PrintAction. Questo esempio richiede che si disponga di un componente PrintForm denominato PrintForm1 e di tre controlli RadioButton in un form.

If RadioButton1.Checked = True Then
    PrintForm1.PrintAction = Printing.PrintAction.PrintToPrinter
ElseIf RadioButton2.Checked = True Then
    PrintForm1.PrintAction = Printing.PrintAction.PrintToPreview
Else
    PrintForm1.PrintFileName = _
  My.Computer.FileSystem.SpecialDirectories.CurrentUserApplicationData _
  & "Form1.eps"
    PrintForm1.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.