PageSetupDialog Classe

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Permet aux utilisateurs de modifier les paramètres d'impression liés à la page notamment les marges et l'orientation de la page. Cette classe ne peut pas être héritée.

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

Héritage: Object

MarshalByRefObject

Component

CommonDialog
PageSetupDialog

Exemples

L’exemple de code suivant illustre l’utilisation des PageSetupDialog PageSettingspropriétés , PrinterSettingset ShowNetwork . Pour exécuter cet exemple, placez-le dans un formulaire contenant un Button nommé Button1, un ListBox nommé ListBox1et un PageSetupDialog nommé PageSetupDialog1. Vérifiez que l’événement click du bouton est connecté à la méthode de gestion des événements dans cet exemple.

//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

Remarques

La PageSetupDialog boîte de dialogue modifie les PageSettings informations et PrinterSettings pour un donné Document. L’utilisateur peut activer les sections de la boîte de dialogue pour manipuler l’impression et les marges ; orientation, taille et source du papier ; et pour afficher les boutons Aide et réseau. La MinMargins propriété définit les marges minimales qu’un utilisateur peut sélectionner.

Lorsque vous créez une instance de la PageSetupDialog classe, les propriétés en lecture/écriture sont définies sur les valeurs initiales. Pour obtenir la liste de ces valeurs, consultez le PageSetupDialog constructeur.

Étant donné qu’un PageSetupDialog doit afficher des paramètres de page, vous devez définir la Documentpropriété , PrinterSettingsou PageSettings avant d’appeler ShowDialog; sinon, une exception se produit.

Constructeurs

PageSetupDialog()

Initialise une nouvelle instance de la classe PageSetupDialog.

Propriétés

AllowMargins	Obtient ou définit une valeur indiquant si la section des marges de la boîte de dialogue est activée.
AllowOrientation	Obtient ou définit une valeur indiquant si la section d'orientation de la boîte de dialogue (paysage ou portrait) est activée.
AllowPaper	Obtient ou définit une valeur indiquant si la section de papier de la boîte de dialogue (taille du papier et alimentation papier) est activée.
AllowPrinter	Obtient ou définit une valeur indiquant si le bouton Imprimer est activé.
CanRaiseEvents	Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
Container	Obtient le IContainer qui contient la Component. (Hérité de Component)
DesignMode	Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component)
Document	Obtient ou définit une valeur indiquant PrintDocument pour obtenir les paramètres de page.
EnableMetric	Obtient ou définit une valeur indiquant si les paramètres des marges, lorsqu'ils sont affichés en millimètres, doivent être automatiquement convertis en centièmes de pouce et inversement.
Events	Obtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component)
MinMargins	Obtient ou définit une valeur indiquant les marges minimales pouvant être sélectionnées par l'utilisateur, en centièmes de pouce.
PageSettings	Obtient ou définit une valeur indiquant les paramètres de page à modifier.
PrinterSettings	Obtient ou définit les paramètres d'impression qui sont modifiés lorsque l'utilisateur clique sur le bouton Imprimante dans la boîte de dialogue.
ShowHelp	Obtient ou définit une valeur indiquant si le bouton Aide est visible.
ShowNetwork	Obtient ou définit une valeur indiquant si le bouton Réseau est visible.
Site	Obtient ou définit le ISite de Component. (Hérité de Component)
Tag	Obtient ou définit un objet qui contient des données relatives au contrôle. (Hérité de CommonDialog)

Méthodes

CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées. (Hérité de Component)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetService(Type)	Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Définit la procédure de raccordement d'une boîte de dialogue commune devant être substituée pour qu'une fonctionnalité spécifique soit ajoutée à une boîte de dialogue commune. (Hérité de CommonDialog)
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
OnHelpRequest(EventArgs)	Déclenche l’événement HelpRequest. (Hérité de CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Définit la procédure de fenêtre propriétaire devant être substituée pour qu'une fonctionnalité spécifique soit ajoutée à une boîte de dialogue commune. (Hérité de CommonDialog)
Reset()	Rétablit les valeurs par défaut de toutes les options.
RunDialog(IntPtr)	En cas de substitution dans une classe dérivée, spécifie une boîte de dialogue commune. (Hérité de CommonDialog)
ShowDialog()	Exécute une boîte de dialogue commune avec un propriétaire par défaut. (Hérité de CommonDialog)
ShowDialog(IWin32Window)	Exécute une boîte de dialogue commune avec le propriétaire spécifié. (Hérité de CommonDialog)
ToString()	Retourne un String contenant le nom du Component, s’il en existe un. Cette méthode ne doit pas être remplacée. (Hérité de Component)

Événements

Disposed	Se produit lorsque le composant est supprimé par un appel à la méthode Dispose(). (Hérité de Component)
HelpRequest	Se produit lorsque l'utilisateur clique sur le bouton Aide dans une boîte de dialogue commune. (Hérité de CommonDialog)

S’applique à