PageSetupDialog Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

PageSetupDialog.cs

Permite que os usuários alterem as configurações de impressão relacionadas à página, incluindo margens e orientação de papel. Essa classe não pode ser herdada.

public ref class PageSetupDialog sealed : System::Windows::Forms::CommonDialog

public sealed class PageSetupDialog : System.Windows.Forms.CommonDialog

type PageSetupDialog = class
    inherit CommonDialog

Public NotInheritable Class PageSetupDialog
Inherits CommonDialog

Herança

Object

MarshalByRefObject

Component

CommonDialog

PageSetupDialog

Exemplos

O exemplo de código a seguir demonstra o PageSetupDialog uso das propriedades e ShowNetwork do PageSettingsPrinterSettingsuso. Para executar este exemplo, coloque-o em um formulário que contém um Button nome Button1, um ListBox nome ListBox1e um PageSetupDialog nome PageSetupDialog1. Verifique se o evento de clique do botão está conectado ao método de manipulação de eventos neste exemplo.

//This method displays a PageSetupDialog object. If the
// user clicks OK in the dialog, selected results of
// the dialog are displayed in ListBox1.
void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   
   // Initialize the dialog's PrinterSettings property to hold user
   // defined printer settings.
   PageSetupDialog1->PageSettings = gcnew System::Drawing::Printing::PageSettings;
   
   // Initialize dialog's PrinterSettings property to hold user
   // set printer settings.
   PageSetupDialog1->PrinterSettings = gcnew System::Drawing::Printing::PrinterSettings;
   
   //Do not show the network in the printer dialog.
   PageSetupDialog1->ShowNetwork = false;
   
   //Show the dialog storing the result.
   System::Windows::Forms::DialogResult result = PageSetupDialog1->ShowDialog();
   
   // If the result is OK, display selected settings in
   // ListBox1. These values can be used when printing the
   // document.
   if ( result == ::DialogResult::OK )
   {
      array<Object^>^results = {PageSetupDialog1->PageSettings->Margins,PageSetupDialog1->PageSettings->PaperSize,PageSetupDialog1->PageSettings->Landscape,PageSetupDialog1->PrinterSettings->PrinterName,PageSetupDialog1->PrinterSettings->PrintRange};
      ListBox1->Items->AddRange( results );
   }
   
}

//This method displays a PageSetupDialog object. If the
// user clicks OK in the dialog, selected results of
// the dialog are displayed in ListBox1.
private void Button1_Click(System.Object sender, System.EventArgs e)
{

    // Initialize the dialog's PrinterSettings property to hold user
    // defined printer settings.
    PageSetupDialog1.PageSettings =
        new System.Drawing.Printing.PageSettings();

    // Initialize dialog's PrinterSettings property to hold user
    // set printer settings.
    PageSetupDialog1.PrinterSettings =
        new System.Drawing.Printing.PrinterSettings();

    //Do not show the network in the printer dialog.
    PageSetupDialog1.ShowNetwork = false;

    //Show the dialog storing the result.
    DialogResult result = PageSetupDialog1.ShowDialog();

    // If the result is OK, display selected settings in
    // ListBox1. These values can be used when printing the
    // document.
    if (result == DialogResult.OK)
    {
        object[] results = new object[]{ 
            PageSetupDialog1.PageSettings.Margins, 
            PageSetupDialog1.PageSettings.PaperSize, 
            PageSetupDialog1.PageSettings.Landscape, 
            PageSetupDialog1.PrinterSettings.PrinterName, 
            PageSetupDialog1.PrinterSettings.PrintRange};
        ListBox1.Items.AddRange(results);
    }
}

'This method displays a PageSetupDialog object. If the
' user clicks OK in the dialog, selected results of
' the dialog are displayed in ListBox1.
Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    ' Initialize the dialog's PrinterSettings property to hold user
    ' defined printer settings.
    PageSetupDialog1.PageSettings = _
        New System.Drawing.Printing.PageSettings

    ' Initialize dialog's PrinterSettings property to hold user
    ' set printer settings.
    PageSetupDialog1.PrinterSettings = _
        New System.Drawing.Printing.PrinterSettings

    'Do not show the network in the printer dialog.
    PageSetupDialog1.ShowNetwork = False

    'Show the dialog storing the result.
    Dim result As DialogResult = PageSetupDialog1.ShowDialog()

    ' If the result is OK, display selected settings in
    ' ListBox1. These values can be used when printing the
    ' document.
    If (result = DialogResult.OK) Then
        Dim results() As Object = New Object() _
            {PageSetupDialog1.PageSettings.Margins, _
             PageSetupDialog1.PageSettings.PaperSize, _
             PageSetupDialog1.PageSettings.Landscape, _
             PageSetupDialog1.PrinterSettings.PrinterName, _
             PageSetupDialog1.PrinterSettings.PrintRange}
        ListBox1.Items.AddRange(results)
    End If

End Sub

Comentários

A PageSetupDialog caixa de diálogo modifica as informações e PrinterSettings as PageSettings informações de um determinado Document. O usuário pode habilitar seções da caixa de diálogo para manipular impressão e margens; orientação de papel, tamanho e origem; e para mostrar botões de ajuda e rede. A MinMargins propriedade define as margens mínimas que um usuário pode selecionar.

Quando você cria uma instância da PageSetupDialog classe, as propriedades de leitura/gravação são definidas como valores iniciais. Para obter uma lista desses valores, consulte o PageSetupDialog construtor.

Como uma PageSetupDialog página precisa ser exibida, você precisa definir a Documentpropriedade , PrinterSettingsou PageSettings antes de chamar ShowDialog; caso contrário, ocorrerá uma exceção.

Construtores

Nome	Description
PageSetupDialog()	Inicializa uma nova instância da classe PageSetupDialog.

Propriedades

Nome	Description
AllowMargins	Obtém ou define um valor que indica se a seção margens da caixa de diálogo está habilitada.
AllowOrientation	Obtém ou define um valor que indica se a seção de orientação da caixa de diálogo (paisagem versus retrato) está habilitada.
AllowPaper	Obtém ou define um valor que indica se a seção de papel da caixa de diálogo (tamanho do papel e fonte de papel) está habilitada.
AllowPrinter	Obtém ou define um valor que indica se o botão Impressora está habilitado.
Document	Obtém ou define um valor que indica das PrintDocument quais obter as configurações de página.
EnableMetric	Obtém ou define um valor que indica se as configurações de margem, quando exibidas em milímetros, devem ser convertidas automaticamente de e para centésimos de polegada.
MinMargins	Obtém ou define um valor que indica as margens mínimas, em centésimos de polegada, o usuário tem permissão para selecionar.
PageSettings	Obtém ou define um valor que indica as configurações de página a serem modificadas.
PrinterSettings	Obtém ou define as configurações da impressora que são modificadas quando o usuário clica no botão Impressora na caixa de diálogo.
ShowHelp	Obtém ou define um valor que indica se o botão Ajuda está visível.
ShowNetwork	Obtém ou define um valor que indica se o botão Rede está visível.
Tag	Obtém ou define um objeto que contém dados sobre o controle. (Herdado de CommonDialog)

Métodos

Nome	Description
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Define o procedimento comum de gancho de caixa de diálogo que é substituído para adicionar funcionalidade específica a uma caixa de diálogo comum. (Herdado de CommonDialog)
OnHelpRequest(EventArgs)	Aciona o evento HelpRequest. (Herdado de CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Define o procedimento de janela do proprietário substituído para adicionar funcionalidades específicas a uma caixa de diálogo comum. (Herdado de CommonDialog)
Reset()	Redefine todas as opções para seus valores padrão.
RunDialog(IntPtr)	Quando substituído em uma classe derivada, especifica uma caixa de diálogo comum. (Herdado de CommonDialog)
ShowDialog()	Executa uma caixa de diálogo comum com um proprietário padrão. (Herdado de CommonDialog)
ShowDialog(IWin32Window)	Executa uma caixa de diálogo comum com o proprietário especificado. (Herdado de CommonDialog)

Eventos

Nome	Description
HelpRequest	Ocorre quando o usuário clica no botão Ajuda em uma caixa de diálogo comum. (Herdado de CommonDialog)

Confira também

• CommonDialog
• Margins
• PageSettings
• PrintDocument
• PrinterSettings