QPageSize Class

Documentation sur les fonctions des membres

QPageSize::QPageSize()

Crée un objet QPageSize de type null.

QPageSize::QPageSize(QPageSize::PageSizeId pageSize)

Crée un objet `QPageSize` de la taille standard ` pageSize`.

Si pageSize est QPageSize::Custom, le QPageSize obtenu ne sera pas valide. Utilisez plutôt le constructeur de taille personnalisée.

[explicit] QPageSize::QPageSize(const QSize &pointSize, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

Crée une instance de `QPageSize` correspondant à l'pointSize fournie en points, en utilisant l'matchPolicy correspondante.

Si l’ pointSize fournie correspond à une QPageSize::PageSizeId standard, c’est cette taille de page qui sera utilisée. Notez que si l’ matchPolicy est FuzzyMatch, cela peut entraîner l’ajustement de l’ pointSize à la taille standard. Pour éviter cela, utilisez plutôt une matchPolicy de type ExactMatch.

Si l’ pointSize fournie n’est pas une QPageSize::PageSizeId standard, une taille de QPageSize::Custom sera créée.

Si name est nul, le nom localisé standard sera utilisé. S’il s’agit d’un format de page personnalisé, un nom personnalisé au format « Personnalisé (largeur x hauteur) » sera créé.

La valeur par défaut de matchPolicy est FuzzyMatch.

[explicit] QPageSize::QPageSize(const QSizeF &size, QPageSize::Unit units, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

Crée une page personnalisée à l'adresse size sur units.

Si l'size fournie correspond à un format standard de QPageSize::PageSizeId, alors la taille de cette page sera utilisée. Notez que si l'matchPolicy est FuzzyMatch, cela peut entraîner l'ajustement de l'size à la taille standard. Pour éviter cela, utilisez plutôt une matchPolicy de type ExactMatch.

Si l’ size fournie n’est pas une QPageSize::PageSizeId standard, une taille QPageSize::Custom sera créée. La taille d’origine sera conservée et servira de base à tous les autres calculs de taille.

Si name est nul, un nom personnalisé sera créé sous la forme « Personnalisé (largeur x hauteur) », la taille étant exprimée dans les unités fournies.

QPageSize::QPageSize(const QPageSize &other)

Constructeur de copie : copie la valeur de ` other ` dans `this`.

[noexcept] QPageSize::~QPageSize()

Supprime la page.

QSizeF QPageSize::definitionSize() const

Renvoie la taille de définition de la page.

Pour un format de page standard, il s'agira de la taille définie dans la norme correspondante ; ainsi, le format ISO A4 sera défini en millimètres, tandis que le format ANSI Letter sera défini en pouces.

Pour un format de page personnalisé, il s'agira de la taille d'origine utilisée pour créer l'objet de format de page.

Si l'QPageSize e n'est pas valide, l'QSizeF e sera également invalide.

Voir également definitionUnits().

[static] QSizeF QPageSize::definitionSize(QPageSize::PageSizeId pageSizeId)

Renvoie la taille de définition de l'pageSizeId.

Pour obtenir les unités de définition, appelez la fonction ` QPageSize::definitionUnits()`.

QPageSize::Unit QPageSize::definitionUnits() const

Renvoie les unités de définition du format de la page.

Pour un format de page standard, il s'agira des unités définies dans la norme correspondante ; par exemple, le format ISO A4 sera défini en millimètres tandis que le format ANSI Letter sera défini en pouces.

Pour un format de page personnalisé, il s’agira des unités d’origine utilisées pour créer l’objet de format de page.

Si l'QPageSize n'est pas valide, l'QPageSize::Unit ne sera pas valide.

Voir également definitionSize().

[static] QPageSize::Unit QPageSize::definitionUnits(QPageSize::PageSizeId pageSizeId)

Renvoie les unités de définition de la norme pageSizeId.

Pour obtenir la taille de définition, appelez la fonction ` QPageSize::definitionSize()`.

QPageSize::PageSizeId QPageSize::id() const

Renvoie l'QPageSize::PageSizeId e standard de la page, ou QPageSize::Custom.

Si l'QPageSize n'est pas valide, l'ID sera QPageSize::Custom.

[static] QPageSize::PageSizeId QPageSize::id(int windowsId)

Renvoie l'PageSizeId correspondant à la valeur donnée de l'énumération Windows DMPAPER windowsId.

S'il n'existe aucun « PageSizeId » correspondant, la valeur QPageSize::Custom est renvoyée.

[static] QPageSize::PageSizeId QPageSize::id(const QSize &pointSize, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

Renvoie l'QPageSize::PageSizeId standard de l'pointSize donnée en points à l'aide de l'matchPolicy fournie.

Si vous utilisez FuzzyMatch, la taille en points de l’ PageSizeId renvoyée peut ne pas correspondre exactement à la pointSize que vous avez fournie. Vous devez appeler QPageSize::sizePoints() en utilisant l’ PageSizeId renvoyée pour connaître la taille réelle en points de l’ PageSizeId avant de l’utiliser dans des calculs.

[static] QPageSize::PageSizeId QPageSize::id(const QSizeF &size, QPageSize::Unit units, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

Renvoie l'QPageSize::PageSizeId standard de l'size donnée dans units à l'aide de l'matchPolicy fournie.

Si vous utilisez FuzzyMatch, la taille unitaire de l’ PageSizeId renvoyée peut ne pas correspondre exactement à celle de l’ size que vous avez fournie. Vous devez appeler QPageSize::size() en utilisant l’ PageSizeId renvoyée pour connaître la taille unitaire réelle de l’ PageSizeId avant de l’utiliser dans des calculs.

bool QPageSize::isEquivalentTo(const QPageSize &other) const

Renvoie « true » si cette page est équivalente à la page other, c'est-à-dire si la page a la même taille, indépendamment d'autres attributs tels que le nom.

bool QPageSize::isValid() const

Renvoie true si la taille de cette page est valide.

La taille de la page peut être invalide si elle a été créée avec un PageSizeId invalide, ou avec un QSize ou un QSizeF négatif ou invalide, ou encore avec le constructeur null.

QString QPageSize::key() const

Renvoie la clé unique correspondant au format de la page.

Par défaut, il s'agit du mot-clé standard « mediaOption » du PPD correspondant au format de page, ou de la clé de format personnalisée du PPD. Si l'instance de ` QPageSize ` provient d'un périphérique d'impression, il s'agira alors de la clé fournie par ce périphérique, qui peut différer de la clé standard.

Si l'QPageSize n'est pas valide, la clé sera une chaîne vide.

Cette clé ne doit jamais être affichée aux utilisateurs finaux ; il s'agit d'une clé interne uniquement. Pour obtenir un nom lisible par l'utilisateur, utilisez name().

Voir également name().

[static] QString QPageSize::key(QPageSize::PageSizeId pageSizeId)

Renvoie le mot-clé « mediaOption » de l'pageSizeId standard.

Si l’ QPageSize n’est pas valide, la clé sera vide.

QString QPageSize::name() const

Renvoie un nom localisé et lisible par l'utilisateur correspondant à la taille de la page.

Si l'instance QPageSize a été obtenue à partir d'un périphérique d'impression, le nom utilisé est celui fourni par ce périphérique. Notez qu'un périphérique d'impression peut ne pas prendre en charge la langue par défaut actuelle.

Si l'QPageSize n'est pas valide, le nom sera une chaîne vide.

[static] QString QPageSize::name(QPageSize::PageSizeId pageSizeId)

Renvoie le nom localisé de l'pageSizeId standard.

Si l'QPageSize n'est pas valide, le nom sera vide.

QRectF QPageSize::rect(QPageSize::Unit units) const

Renvoie le rectangle de la page au format requis units.

Si l'QPageSize n'est pas valide, l'QRect ne sera pas valide.

QRect QPageSize::rectPixels(int resolution) const

Renvoie le rectangle de la page en pixels matériels à l'adresse resolution indiquée.

Si l'QPageSize n'est pas valide, l'QRect ne sera pas valide.

QRect QPageSize::rectPoints() const

Renvoie le rectangle de la page en points PostScript (1/72e de pouce).

Si l'QPageSize e n'est pas valide, l'QRect e ne sera pas valide non plus.

QSizeF QPageSize::size(QPageSize::Unit units) const

Renvoie la taille de la page dans l'units e spécifiée.

Si l'QPageSize est invalide, l'QSizeF sera également invalide.

[static] QSizeF QPageSize::size(QPageSize::PageSizeId pageSizeId, QPageSize::Unit units)

Renvoie la taille de l'pageSizeId standard dans l'units demandé.

QSize QPageSize::sizePixels(int resolution) const

Renvoie la taille de la page en pixels matériels à l'adresse resolution indiquée.

Si l'QPageSize est invalide, la fonction QSize renverra une valeur invalide.

[static] QSize QPageSize::sizePixels(QPageSize::PageSizeId pageSizeId, int resolution)

Renvoie la taille de l'pageSizeId standard en pixels de périphérique pour l'resolution donné.

QSize QPageSize::sizePoints() const

Renvoie la taille de la page en points PostScript (1/72e de pouce).

Si l'QPageSize e n'est pas valide, l'QSize e ne sera pas valide non plus.

[static] QSize QPageSize::sizePoints(QPageSize::PageSizeId pageSizeId)

Renvoie la taille de l’ pageSizeId standard en points.

[noexcept] void QPageSize::swap(QPageSize &other)

Remplace cette adresse QPageSize par other. Cette opération est très rapide et ne pose jamais de problème.

int QPageSize::windowsId() const

Renvoie la valeur de l'énumération DMPAPER de Windows correspondant à la taille de la page.

Toutes les tailles de page PPD valides n'ont pas d'équivalent sous Windows ; dans ce cas, la valeur 0 est renvoyée.

Si l'QPageSize e n'est pas valide, l'ID Windows sera 0.

Voir également id().

[static] int QPageSize::windowsId(QPageSize::PageSizeId pageSizeId)

Renvoie la valeur de l'énumération DMPAPER de Windows correspondant au format standard « pageSizeId ».

Toutes les tailles de page PPD valides n'ont pas d'équivalent sous Windows ; dans ce cas, la valeur 0 est renvoyée.

[noexcept] QPageSize &QPageSize::operator=(QPageSize &&other)

La commande « move-assigns » attribue la variable « other » à cette instance « QPageSize », transférant ainsi la propriété du pointeur géré à cette instance.

QPageSize &QPageSize::operator=(const QPageSize &other)

Opérateur d'affectation : affecte la valeur « other » à « this ».