Commentaires et blocs ignorés

Important

La plateforme d’impression moderne est le moyen privilégié de Windows pour communiquer avec les imprimantes. Nous vous recommandons d’utiliser le pilote de classe IPP en boîte de Microsoft, ainsi que les applications de support d’impression (PSA), pour personnaliser l’expérience d’impression dans Windows 10 et 11 pour le développement de périphériques d’impression.

Pour plus d’informations, veuillez consulter les articles Plateforme d’impression moderne et Guide de conception des applications de support d’impression.

Les fichiers GPD peuvent contenir des commentaires. Le format d’un commentaire est le suivant :

*% CommentString

où CommentString est une chaîne de caractères se terminant par un caractère de fin de ligne. Chaque ligne d’un commentaire multiligne doit commencer par la séquence de caractères *%. La séquence *% doit être précédée d’un espace blanc ou d’un saut de ligne.

Les exemples suivants sont des commentaires valides :

*% This section of the GPD file
*% contains macro definitions.
*Macros: HP4L
{
    *% These macros define command prefixes for the paper size feature.
    LetterCmdPrefix: "<1B>&l2a8c1E<1B>*p0x0Y"  *% Prefix for letter option.
    A4CmdPrefix: "<1B>&l26a8c1E<1B>*p0x0Y"     *% Prefix for A4 option.
    Env10CmdPrefix: "<1B>&l81a8c1E<1B>*p0x0Y"  *% Prefix for Env10 option.
}

Pour demander à l’analyseur (parser) GPD d’ignorer un groupe d’entrées GPD, vous pouvez créer un bloc ignoré qui contient les entrées à ignorer. Le format d’un bloc ignoré est le suivant :

*IgnoreBlock { IgnoredEntries }

où IgnoredEntries est un ensemble d’entrées de fichier GPD contenant un nombre égal d’accolades gauche et droite.

Dans l’exemple suivant, l’analyseur GPD ignore les entrées de fichier GPD décrivant l’option LANDSCAPE_CC90.

*Feature: Orientation
{
    *Name: "Orientation"
    *DefaultOption: Portrait
    *Option: Portrait
    {
        *Name: "Portrait"
        *Command: CmdSelect
        {
            *Order: DOC_SETUP.7
            *Cmd: "<1B>&l0O"
        }
    }
*IgnoreBlock
{
    *Option: LANDSCAPE_CC90
    {
        *Name: "Landscape"
        *Command: CmdSelect
        {
            *Order: DOC_SETUP.7
            *Cmd: "<1B>&l1O"
        }
    }
}
}