QPageSize Class

Documentation sur les fonctions des membres

QPageSize::QPageSize()

Crée une QPageSize nulle.

QPageSize::QPageSize(QPageSize::PageSizeId pageSize)

Crée un QPageSize de la norme pageSize.

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

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

Crée une QPageSize de la page pointSize donnée en points en utilisant la page matchPolicy correspondante.

Si l'adresse pointSize correspond à une adresse QPageSize::PageSizeId standard, c'est cette taille de page qui sera utilisée. Notez que si matchPolicy est FuzzyMatch, il se peut que pointSize soit ajusté à la taille standard. Pour éviter cela, utilisez plutôt matchPolicy ou ExactMatch.

Si l'adresse pointSize n'est pas une adresse standard QPageSize::PageSizeId, une adresse QPageSize::Custom sera créée.

Si name est nul, le nom localisé standard sera utilisé. S'il s'agit d'une taille de page personnalisée, un nom personnalisé au format "Custom (width x height)" 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 de l'adresse size donnée dans units.

Si le site size correspond à un site standard QPageSize::PageSizeId, c'est cette taille de page qui sera utilisée. Notez que si le site matchPolicy est FuzzyMatch, il se peut que le site size soit adapté à la taille standard. Pour éviter cela, utilisez plutôt matchPolicy ou ExactMatch.

Si le site size n'est pas un site standard QPageSize::PageSizeId, un site QPageSize::Custom sera créé. La taille originale de l'unité sera conservée et utilisée comme base pour tous les autres calculs de taille d'unité.

Si name est nul, un nom personnalisé sera créé sous la forme "Custom (width x height)" où la taille est exprimée dans les unités fournies.

QPageSize::QPageSize(const QPageSize &other)

Copy constructor, copie other dans this.

[noexcept] QPageSize::~QPageSize()

Détruit la page.

QSizeF QPageSize::definitionSize() const

Renvoie la taille de la définition de la taille de la page.

Pour une taille de page standard, il s'agit de la taille définie dans la norme concernée, c'est-à-dire que le format ISO A4 est défini en millimètres, tandis que le format ANSI Letter est défini en pouces.

Pour une taille de page personnalisée, il s'agit de la taille originale utilisée pour créer l'objet de taille de page.

Si l'adresse QPageSize n'est pas valide, l'adresse QSizeF ne le sera pas non plus.

Voir également definitionUnits().

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

Renvoie la taille de la définition de la norme pageSizeId.

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

QPageSize::Unit QPageSize::definitionUnits() const

Renvoie les unités de définition de la taille de la page.

Pour une taille de page standard, il s'agit des unités définies dans la norme concernée, c'est-à-dire que le format ISO A4 est défini en millimètres, tandis que le format ANSI Letter est défini en pouces.

Pour une taille de page personnalisée, il s'agit des unités d'origine utilisées pour créer l'objet taille de page.

Si l'adresse QPageSize n'est pas valide, l'adresse QPageSize::Unit ne le sera pas non plus.

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 la définition, appelez QPageSize::definitionSize().

QPageSize::PageSizeId QPageSize::id() const

Renvoie le standard QPageSize::PageSizeId de la page, ou QPageSize::Custom.

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

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

Renvoie l'adresse PageSizeId pour la valeur de l'enum Windows DMPAPER donnée windowsId.

S'il n'y a pas de correspondance avec PageSizeId, QPageSize::Custom est renvoyé.

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

Renvoie la norme QPageSize::PageSizeId de la valeur pointSize en points en utilisant la valeur matchPolicy.

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

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

Renvoie la norme QPageSize::PageSizeId de l'adresse size donnée dans units en utilisant l'adresse matchPolicy donnée.

Si vous utilisez FuzzyMatch, la taille de l'unité de PageSizeId renvoyée peut ne pas correspondre exactement à celle de size que vous avez transmise. Vous devez appeler QPageSize::size() en utilisant l'adresse PageSizeId renvoyée pour connaître la taille réelle de l'unité PageSizeId avant de l'utiliser dans vos 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 cette taille de page est valide.

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

QString QPageSize::key() const

Renvoie la clé unique de la taille de la page.

Par défaut, il s'agit du mot-clé mediaOption standard de PPD pour la taille de la page, ou de la clé de format personnalisée de PPD. Si l'instance QPageSize a été obtenue à partir d'un périphérique d'impression, il s'agira de la clé fournie par le périphérique d'impression, qui peut différer de la clé standard.

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

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

Voir aussi name().

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

Renvoie le mot-clé PPD mediaOption de la norme pageSizeId.

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

QString QPageSize::name() const

Renvoie un nom localisé lisible par l'homme pour 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 le périphérique d'impression. Notez qu'un périphérique d'impression peut ne pas prendre en charge la langue locale par défaut.

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

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

Renvoie le nom localisé de la norme pageSizeId.

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

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

Renvoie le rectangle de la page dans le format requis units.

Si l'adresse QPageSize est invalide, l'adresse QRect le sera également.

QRect QPageSize::rectPixels(int resolution) const

Renvoie le rectangle de page en pixels Device à l'adresse resolution donnée.

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

QRect QPageSize::rectPoints() const

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

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

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

Renvoie la taille de la page dans le format requis units.

Si l'adresse QPageSize n'est pas valide, l'adresse QSizeF ne le sera pas non plus.

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

Renvoie la taille de la norme pageSizeId dans la units demandée.

QSize QPageSize::sizePixels(int resolution) const

Renvoie la taille de la page en pixels Device à l'adresse resolution donnée.

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

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

Renvoie la taille de la norme pageSizeId en pixels de l'appareil pour l'adresse resolution donnée.

QSize QPageSize::sizePoints() const

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

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

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

Renvoie la taille de la norme pageSizeId en points.

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

Remplace ce site QPageSize par other. Cette opération est très rapide et n'échoue jamais.

int QPageSize::windowsId() const

Renvoie la valeur de l'enum DMPAPER de Windows pour la taille de la page.

Toutes les tailles de page PPD valides n'ont pas d'équivalent Windows, auquel cas 0 sera renvoyé.

Si l'adresse QPageSize n'est pas valide, l'identifiant Windows sera 0.

Voir également id().

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

Renvoie la valeur de l'enum Windows DMPAPER de la norme pageSizeId.

Toutes les tailles de page PPD valides n'ont pas d'équivalent sous Windows, auquel cas 0 sera renvoyé.

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

Move-assigne other à cette instance QPageSize, en transférant la propriété du pointeur géré à cette instance.

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

L'opérateur d'affectation, attribue other à ceci.