PrinterSettings Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Especifica informações sobre como um documento é impresso, incluindo a impressora que o imprime, ao imprimir com base em um aplicativo Windows Forms.
public ref class PrinterSettings : ICloneable
public class PrinterSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
[System.Serializable]
public class PrinterSettings : ICloneable
type PrinterSettings = class
interface ICloneable
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Serializable>]
type PrinterSettings = class
interface ICloneable
[<System.Serializable>]
type PrinterSettings = class
interface ICloneable
Public Class PrinterSettings
Implements ICloneable
- Herança
-
PrinterSettings
- Atributos
- Implementações
Exemplos
O exemplo de código a seguir imprime um documento na impressora especificada. O exemplo tem três pré-requisitos:
Uma variável chamada
filePath
foi definida como o caminho do arquivo a ser impresso.Um método chamado
pd_PrintPage
, que manipula o PrintPage evento, foi definido.Uma variável chamada
printer
foi definida como o nome da impressora.
Use os System.Drawingnamespaces , System.Drawing.Printinge System.IO para este exemplo.
public:
void Printing( String^ printer )
{
try
{
streamToPrint = gcnew StreamReader( filePath );
try
{
printFont = gcnew System::Drawing::Font( "Arial",10 );
PrintDocument^ pd = gcnew PrintDocument;
pd->PrintPage += gcnew PrintPageEventHandler(
this, &Form1::pd_PrintPage );
// Specify the printer to use.
pd->PrinterSettings->PrinterName = printer;
if ( pd->PrinterSettings->IsValid )
{
pd->Print();
}
else
{
MessageBox::Show( "Printer is invalid." );
}
}
finally
{
streamToPrint->Close();
}
}
catch ( Exception^ ex )
{
MessageBox::Show( ex->Message );
}
}
public void Printing(string printer) {
try {
streamToPrint = new StreamReader (filePath);
try {
printFont = new Font("Arial", 10);
PrintDocument pd = new PrintDocument();
pd.PrintPage += new PrintPageEventHandler(pd_PrintPage);
// Specify the printer to use.
pd.PrinterSettings.PrinterName = printer;
if (pd.PrinterSettings.IsValid) {
pd.Print();
}
else {
MessageBox.Show("Printer is invalid.");
}
}
finally {
streamToPrint.Close();
}
}
catch(Exception ex) {
MessageBox.Show(ex.Message);
}
}
Public Sub Printing(printer As String)
Try
streamToPrint = New StreamReader(filePath)
Try
printFont = New Font("Arial", 10)
Dim pd As New PrintDocument()
AddHandler pd.PrintPage, AddressOf pd_PrintPage
' Specify the printer to use.
pd.PrinterSettings.PrinterName = printer
If pd.PrinterSettings.IsValid then
pd.Print()
Else
MessageBox.Show("Printer is invalid.")
End If
Finally
streamToPrint.Close()
End Try
Catch ex As Exception
MessageBox.Show(ex.Message)
End Try
End Sub
Comentários
Normalmente, você acessa um PrinterSettings por meio PrintDocument.PrinterSettings de propriedades ou PageSettings.PrinterSettings para modificar as configurações da impressora. A configuração mais comum da impressora é PrinterName, que especifica a impressora para a qual imprimir.
Para obter mais informações sobre impressão com Windows Forms, consulte a visão geral do System.Drawing.Printing namespace. Se você quiser imprimir de um aplicativo Windows Presentation Foundation, consulte o System.Printing namespace .
Observação
No .NET 6 e versões posteriores, o pacote System.Drawing.Common, que inclui esse tipo, só tem suporte em sistemas operacionais Windows. O uso desse tipo em aplicativos multiplataforma causa avisos de tempo de compilação e exceções em tempo de execução. Para obter mais informações, consulte System.Drawing.Common com suporte apenas no Windows.
Construtores
PrinterSettings() |
Inicializa uma nova instância da classe PrinterSettings. |
Propriedades
CanDuplex |
Obtém um valor que indica se a impressora dá suporte à impressão nos dois lados. |
Collate |
Obtém ou define um valor que indica se o documento impresso é agrupado. |
Copies |
Obtém ou define o número de cópias do documento a serem impressas. |
DefaultPageSettings |
Obtém as configurações de página padrão para essa impressora. |
Duplex |
Obtém ou define a configuração da impressora para imprimir nos dois lados. |
FromPage |
Obtém ou define o número de página da primeira página a ser impressa. |
InstalledPrinters |
Obtém os nomes de todas as impressoras instaladas no computador. |
IsDefaultPrinter |
Obtém um valor que indica se a propriedade PrinterName designa a impressora padrão, exceto quando o usuário define PrinterName explicitamente. |
IsPlotter |
Obtém um valor que indica se a impressora é uma plotadora. |
IsValid |
Obtém um valor que indica se a propriedade PrinterName designa uma impressora válida. |
LandscapeAngle |
Obtém o ângulo, em graus, em que a orientação retrato é girada para produzir a orientação paisagem. |
MaximumCopies |
Obtém o número máximo de cópias que a impressora permite ao usuário imprimir por vez. |
MaximumPage |
Obtém ou define o FromPage ou o ToPage máximo que pode ser selecionado em um PrintDialog. |
MinimumPage |
Obtém ou define o FromPage ou o ToPage mínimo que pode ser selecionado em um PrintDialog. |
PaperSizes |
Obtém os tamanhos de papel com suporte por essa impressora. |
PaperSources |
Obtém as bandejas de fonte de papel que estão disponíveis na impressora. |
PrinterName |
Obtém ou define o nome da impressora a ser usada. |
PrinterResolutions |
Obtém todas as resoluções com suporte por essa impressora. |
PrintFileName |
Obtém ou define o nome do arquivo, ao imprimir para um arquivo. |
PrintRange |
Obtém ou define os números de página que o usuário especificou para imprimir. |
PrintToFile |
Obtém ou define um valor que indica se a saída de impressão é enviada para um arquivo em vez de uma porta. |
SupportsColor |
Obtém um valor que indica se esta impressora dá suporte à impressão colorida. |
ToPage |
Obtém ou define o número da última página a ser impressa. |
Métodos
Clone() |
Cria uma cópia deste PrinterSettings. |
CreateMeasurementGraphics() |
Retorna um Graphics que contém informações de impressora úteis ao criar um PrintDocument. |
CreateMeasurementGraphics(Boolean) |
Retorna um Graphics que contém informações de impressora, especificando opcionalmente a origem nas margens. |
CreateMeasurementGraphics(PageSettings) |
Retorna um Graphics que contém informações de impressora associadas ao PageSettings especificado. |
CreateMeasurementGraphics(PageSettings, Boolean) |
Cria um Graphics associado às configurações de página especificadas e opcionalmente especificando a origem nas margens. |
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetHdevmode() |
Cria um identificador para uma estrutura |
GetHdevmode(PageSettings) |
Cria um identificador para uma estrutura |
GetHdevnames() |
Cria um identificador para uma estrutura |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
IsDirectPrintingSupported(Image) |
Obtém um valor que indica se a impressora dá suporte à impressão do arquivo de imagem especificado. |
IsDirectPrintingSupported(ImageFormat) |
Retorna um valor que indica se a impressora dá suporte à impressão do formato de imagem especificado. |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
SetHdevmode(IntPtr) |
Copia as informações relevantes do identificador determinado para o PrinterSettings. |
SetHdevnames(IntPtr) |
Copia as informações relevantes do identificador determinado para o PrinterSettings. |
ToString() |
Fornece informações sobre o PrinterSettings na forma de cadeia de caracteres. |