PageSetupDialog Classe

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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.

Permite ao usuário alterar configurações de impressão relativas à página, como as margens e a orientação do 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 uso das PageSetupDialog PageSettingspropriedades , PrinterSettingse ShowNetwork . Para executar este exemplo, coloque-o em um formulário que contém um Button chamado Button1, um ListBox chamado ListBox1e um PageSetupDialog chamado 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 PageSettings informações e PrinterSettings 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 precisa de configurações de página para exibir, você precisa definir a Documentpropriedade , PrinterSettingsou PageSettings antes de chamar ShowDialog; caso contrário, ocorrerá uma exceção.

Construtores

PageSetupDialog()

Inicializa uma nova instância da classe PageSetupDialog.

Propriedades

AllowMargins	Obtém ou define um valor que indica se a seção de 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 origem do papel) está habilitada.
AllowPrinter	Obtém ou define um valor que indica se o botão está Impressora está habilitado.
CanRaiseEvents	Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component)
Container	Obtém o IContainer que contém o Component. (Herdado de Component)
DesignMode	Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component)
Document	Obtém ou define um valor que indica PrintDocument do qual obter as configurações de página.
EnableMetric	Obtém ou define um valor indicando se as configurações de margem, quando exibidas em milímetros, devem ser convertidas automaticamente para e de centenas de polegada.
Events	Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component)
MinMargins	Obtém ou define um valor que indica as margens mínimas, em centésimos de polegada, que um usuário pode 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 de 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.
Site	Obtém ou define o ISite do Component. (Herdado de Component)
Tag	Obtém ou define um objeto que contém dados sobre o controle. (Herdado de CommonDialog)

Métodos

CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados pelo Component. (Herdado de Component)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados. (Herdado de Component)
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)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Define o procedimento de gancho de caixa de diálogo comum que é substituído para adicionar uma funcionalidade específica a uma caixa de diálogo comum. (Herdado de CommonDialog)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
OnHelpRequest(EventArgs)	Aciona o evento HelpRequest. (Herdado de CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Define o procedimento da janela de proprietário que é substituído para adicionar a funcionalidade específica 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)
ToString()	Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído. (Herdado de Component)

Eventos

Disposed	Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component)
HelpRequest	Ocorre quando o usuário clica no botão Ajuda em uma caixa de diálogo comum. (Herdado de CommonDialog)

Aplica-se a

Compartilhar via