PageMediaSize Classe

Définition

Décrit le format de page du papier ou d’autres supports.

public ref class PageMediaSize sealed
public sealed class PageMediaSize
type PageMediaSize = class
Public NotInheritable Class PageMediaSize
Héritage
PageMediaSize

Exemples

L’exemple suivant montre comment utiliser cette classe pour mettre à l’échelle un élément visuel en fonction des marges du papier sur lequel il doit être imprimé.

/// <summary>
///   Returns a scaled copy of a given visual transformed to
///   fit for printing to a specified print queue.</summary>
/// <param name="v">
///   The visual to be printed.</param>
/// <param name="pq">
///   The print queue to be output to.</param>
/// <returns>
///   The root element of the transformed visual.</returns>
private Visual PerformTransform(Visual v, PrintQueue pq)
{
    ContainerVisual root = new ContainerVisual();
    const double inch = 96;

    // Set the margins.
    double xMargin = 1.25 * inch;
    double yMargin = 1 * inch;

    PrintTicket pt = pq.UserPrintTicket;
    Double printableWidth = pt.PageMediaSize.Width.Value;
    Double printableHeight = pt.PageMediaSize.Height.Value;

    Double xScale = (printableWidth - xMargin * 2) / printableWidth;
    Double yScale = (printableHeight - yMargin * 2) / printableHeight;

    root.Children.Add(v);
    root.Transform = new MatrixTransform(xScale, 0, 0, yScale, xMargin, yMargin);

    return root;
}// end:PerformTransform()
''' <summary>
'''   Returns a scaled copy of a given visual transformed to
'''   fit for printing to a specified print queue.</summary>
''' <param name="v">
'''   The visual to be printed.</param>
''' <param name="pq">
'''   The print queue to be output to.</param>
''' <returns>
'''   The root element of the transformed visual.</returns>
Private Function PerformTransform(ByVal v As Visual, ByVal pq As PrintQueue) As Visual
    Dim root As New ContainerVisual()
    Const inch As Double = 96

    ' Set the margins.
    Dim xMargin As Double = 1.25 * inch
    Dim yMargin As Double = 1 * inch

    Dim pt As PrintTicket = pq.UserPrintTicket
    Dim printableWidth As Double = pt.PageMediaSize.Width.Value
    Dim printableHeight As Double = pt.PageMediaSize.Height.Value

    Dim xScale As Double = (printableWidth - xMargin * 2) / printableWidth
    Dim yScale As Double = (printableHeight - yMargin * 2) / printableHeight

    root.Children.Add(v)
    root.Transform = New MatrixTransform(xScale, 0, 0, yScale, xMargin, yMargin)

    Return root
End Function ' end:PerformTransform()

Remarques

Pour une classe qui inclut les mêmes informations sur la taille du média que PageMediaSize sur la zone imageable de la page, consultez PrintDocumentImageableArea.

Avertissement

Les classes de l’espace System.Printing de noms ne sont pas prises en charge pour une utilisation au sein d’un service Windows ou d’une application ou d’un service ASP.NET. La tentative d’utilisation de ces classes à partir de l’un de ces types d’applications peut entraîner des problèmes inattendus, tels que des performances de service réduites et des exceptions d’exécution.

Si vous souhaitez imprimer à partir d’une application Windows Forms, consultez l’espace System.Drawing.Printing de noms.

Constructeurs

Nom Description
PageMediaSize(Double, Double)

Initialise une nouvelle instance de la classe à l’aide de la largeur et de la PageMediaSize hauteur.

PageMediaSize(PageMediaSizeName, Double, Double)

Initialise une nouvelle instance de la PageMediaSize classe à l’aide de la largeur et de la hauteur spécifiées PageMediaSizeName .

PageMediaSize(PageMediaSizeName)

Initialise une nouvelle instance de la PageMediaSize classe à l’aide du fichier spécifié PageMediaSizeName.

Propriétés

Nom Description
Height

Obtient la hauteur de la page.

PageMediaSizeName

Obtient le nom de la taille de page du papier ou d’autres supports.

Width

Obtient la largeur de la page.

Méthodes

Nom Description
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
ToString()

Affiche le format de page du papier ou d’autres supports.

S’applique à