Affichage des articles dans C++Builder

Il existe quelques dossiers spéciaux dans Windows XP qui possèdent un watermark, aussi appelé filigrane en français, en bas à droite. Voici l’exemple du dossier Ma musique:
Listview with a watermark
Le but de cet article est de vous aider à faire la même chose dans un TListview sous C++Builder. Pour que l’effet soit réussi, je vous suggère d’utiliser un fichier de type PNG ou icône car ces deux formats permettent l’utilisation du canal alpha. Si vous décidez d’utiliser le format PNG, je vous conseille de jeter un coup d’œil à mon article qui explique comment charger une image dans les ressources. Parce qu’il est plus simple de faire un code qui charge l’icône de l’application, c’est ce format que nous utiliserons.

La première étape est bien sûr de créer un nouveau projet auquel on ajoute un contrôle TListView. Vous pouvez y ajouter quelques TListColumns et TListItems pour faire un peu plus réel.

Étant donné que j’ai décidé d’utiliser un auto_ptr, il faut inclure l’entête suivant dans votre fichier cpp.

#include <memory>

Dans le constructeur de la Form, ajoutez le code suivant:

    static std::auto_ptr<Graphics::TBitmap> Bitmap(new Graphics::TBitmap);
    Bitmap->Canvas->Brush->Color = ListView1->Color;
    Bitmap->SetSize(32, 32); // Le casque romain est seulement en 32x32 pixels
    Bitmap->Canvas->Draw(0, 0, Application->Icon);

    LVBKIMAGE lv;
    lv.ulFlags = LVBKIF_TYPE_WATERMARK;
    lv.hbm = Bitmap->Handle;
    ListView_SetBkImage(ListView1->Handle, &lv);
    ListView_SetTextBkColor(ListView1->Handle, CLR_NONE);

La première ligne sert à créer une image de type Bitmap. Ce format est nécessaire car la fonction qui va être utilisée plus tard nécessite comme paramètre un HBITMAP. Le seconde ligne va servir à définir la couleur de fond de l’image. Si on effectue cette tâche avant d’établir la grandeur de l’image, l’image sera alors automatiquement de cette couleur. Cela évite d’avoir à dessiner un rectangle de la grandeur du Bitmap par la suite. À la troisième ligne, on utilise une grandeur de 32 par 32 pixels, car c’est la grandeur de l’icône de l’application. L’image par défaut dans C++Builder 2010 est un casque romain. La ligne d’après est utilisée pour dessiner l’icône sur le Bitmap. Maintenant, l’image est prête à être utilisée.

Les lignes 6 à 8 servent à remplir une structure de type LVBKIMAGE qui sera utilisée par la fonction ListView_SetBkImage à la ligne 9.

On pourrait penser que l’on a terminé, eh bien non. Il reste un petit tour de passe nécessaire pour voir notre image dans la listview.

Dans votre fichier d’en-tête, ajoutez les déclarations suivantes dans la section private:

    void __fastcall ListViewWndProc(Messages::TMessage &Message);
    Classes::TWndMethod OldListViewProc;

Ensuite, on retourne dans le constructeur de la Form pour ajouter ce code qui sert à rediriger les appels de Windows à la listview vers la méthode ListViewWndProc:

OldListViewProc = ListView1->WindowProc;
ListView1->WindowProc = ListViewWndProc;

Il faut par la suite ajouter cette méthode:

void __fastcall TForm1::ListViewWndProc(Messages::TMessage &Message)
{
    if(Message.Msg == WM_ERASEBKGND)
    {
        ListView1->DefaultHandler(&Message);
        return;
    }
    OldListViewProc(Message);
}

Si ce code n’est pas utilisé, l’événement WMEraseBkgnd de la classe TWinControl, l’ancêtre de TListView, sera appelé. Cette méthode empêche le message WM_ERASEBKGND de se rendre à la procédure par défaut. C’est pourquoi la méthode DefaultHandler de la listview est appelée et que l’on interdit un appel à OldListViewProc si on reçoit ce message.

À présent, vous avez tout le code nécessaire pour faire votre propre watermark dans un contrôle de type listview.

Depuis C++Builder 2009, le contrôle TEdit possède une nouvelle propriété qui se nomme TextHint. Étant curieux de nature, je décide de l’essayer. Première constatation: il s’agit d’une zone de texte. Donc, je me dis que si je tape quelque chose à l’intérieur et que je compile le code, mon message devrait apparaître quelque part. C’est ce que je m’empresse de faire. Malheureusement, j’ai beau essayer de faire plusieurs actions sur mon contrôle, je ne vois pas mon texte. Alors, je me dis que j’ai sans doute mal compris à quoi peut bien servir cette propriété. Ainsi, je décide d’aller faire un tour dans l’aide. Sur la page de la propriété du TEdit, il n’y a aucune information. Alors, je vais donc sur la page de son parent: le classe TCustomEdit. Voici la description que j’y trouve:

Un conseil ou un message à afficher quand la propriété Text est vide.

Utilisez TextHint pour informer l’utilisateur du type d’entrée attendu dans le champ texte. Les thèmes d’exécution doivent être activés.

Donc, si je me fie à cette information, il devrait y avoir un texte dans mon contrôle car il est vide et les thèmes sont activés sur mon PC. Je décide d’employer les grands moyens: j’ouvre le fichier StdCtrls.pas et je regarde le code de la méthode SetTextHint. La fonction DoSetTextHint est appelée alors je me dirige vers ce code pour me rendre compte que le message EM_SETCUEBANNER est envoyé à Windows. Sur la page MSDN du message, je trouve un texte qui explique que ça ne fonctionne pas si sous Windows XP les langues d’Extrême-Orient sont installées. Bien sûr, sur mon ordinateur, j’ai coché la petite case car j’ai besoin de ces caractères pour tester mes applications multi-langues. Pour ceux qui se demandent où est cette configuration, elle est dans les Options régionales et linguistiques du Panneau de configuration sous l’onglet Langues.

Voici le résultat lorsque je teste sur un système qui remplit toutes les exigences, même celles non documentées dans l’aide officielle:
La propriété TextHint d'un TEdit

Le problème semble être résolu depuis Windows Vista.

J’espère que vous lirez cet article avant de perdre du temps à essayer de comprendre pourquoi cela ne fonctionne pas sur votre ordinateur, ou encore pire sur celui d’un client :) .

Dans C++Builder il est très facile de charger un icône ou même une image Bitmap situé dans les ressources d’une application. La méthode LoadFromResourceName sera alors utilisée.
Voici un exemple pour un fichier Bitmap que l’on veut mettre dans un TImage:

Image1->Picture->Bitmap->LoadFromResourceName((unsigned)HInstance, "BMP_BACKGROUND");

Maintenant, voici un exemple pour un icône que l’on veut utiliser pour un TForm:

Form1->Icon->LoadFromResourceName((unsigned)HInstance, "ICO_DELETE");

Une seule ligne de code est nécessaire pour ces deux types. Par contre, les autres types d’image utilisent le type RC DATA, donc c’est un peu plus compliqué.

Voyons tout d’abord comment ajouter un fichier de type image dans un projet. C’est assez simple car les dernières versions de l’IDE mettent à notre disposition une fenêtre pour exécuter ces tâches. Le fichier .rc sera créé automatiquement par l’interface et il n’aura pas à être modifié manuellement. Pour y accéder, il faut aller dans le menu Project et après dans Resources. Ensuite, il suffit de cliquer le bouton Add pour ajouter un fichier. Par la suite, il est préférable de lui donner un nom approprié.
Ressources sous C++Builder
Pour utiliser la classe TPngImage il faut inclure l’en-tête suivant:

#include <pngimage.hpp>

Voici maintenant le code que j’utilise pour charger l’image PNG et la mettre dans un TImage:

    TPngImage *PngImage = new TPngImage;
    PngImage->LoadFromResourceName((unsigned)HInstance, "PNG_LOGO");
    Image1->Picture->Bitmap->Assign(PngImage);
    delete PngImage;

Le code est assez simple, mais il est quand même un peu plus long que les deux précédents. On doit créer l’objet PngImage pour y charger temporairement la ressource. Pour assigner le PNG à l’objet Image1, on utilise Assign.

Une même méthode similaire pourrait être appliquée avec les classes TGIFImage et TJPEGImage. Voici un exemple pour une image de type JPEG:

    TJPEGImage *JPEGImage = new TJPEGImage;
    TResourceStream *Res = new TResourceStream((unsigned)HInstance, "JPEG_PHOTO", (System::WideChar *)RT_RCDATA);
    JPEGImage->LoadFromStream(Res);
    Image1->Picture->Bitmap->Assign(JPEGImage);
    delete Res;
    delete JPEGImage;

La classe TResourceStream permet de lire les ressources d’une application et l’enregistrer dans un flux mémoire. Ensuite, on charge ce flux dans l’objet JPEGImage à l’aide de la méthode LoadFromStream.

Je crois maintenant vous entendre penser: « Quoi, il n’existe pas de façon plus générale de charger n’importe quel type d’image dans un TImage? ». La réponse est oui, bien sûr, si vous possédez C++Builder 2010. La classe TWICImage peut être utilisée à cet fin. Il s’agit d’une encapsulation de Windows Imaging Component qui permet le chargement d’une grande variété de formats d’images. Voici l’enum des formats supportés:

enum TWICImageFormat { wifBmp, wifPng, wifJpeg, wifGif, wifTiff, wifWMPhoto, wifOther };

TWICImage est défini dans Graphics.hpp et on l’utilise comme suit:

    TWICImage *WicImg = new TWICImage();
    TResourceStream *Res = new TResourceStream((unsigned)HInstance, "PNG_LOGO", (System::WideChar *)RT_RCDATA);
    WicImg->LoadFromStream(Res);
    Image1->Picture->Graphic = WicImg;
    delete Res;
    delete WicImg;

TWICImage est un descendant de TGraphic tout comme TJPEGImage et TGIFImage. C’est pourquoi le code est pratiquement le même et que je ne le commenterai pas. Il est à noter cependant que TWICImage est disponible sur Windows XP SP3 ou une version supérieure.

À partir de maintenant, vous n’aurez plus d’excuse à utiliser des Bitmaps en ressources. Il est désormais plus simple que jamais d’utiliser n’importe quel autre format. Encore une fois, j’espère que cela vous sera utile.

Voici un article qui explique comment ajouter un texte dans la liste vide d’un de vos programmes à l’aide de C++Builder.

Dans certaines applications, quand il y a une liste vide (ce qui pourrait laisser croire à une erreur), on ajoute un message au lieu de la laisser ainsi. C’est le cas d’Outlook Express, on peut le voir sur la capture d’écran qui suit.
Outlook Express avec une liste vide
Il existe plusieurs façons d’imiter ce comportement. Mais tout comme Outlook, je voulais que mon texte soit centré et que le redimensionnement des colonnes n’ait aucune influence sur la position du texte.

La première étape est d’ajouter un TListView à votre fenêtre principale. Utilisez le style vsReport pour que l’on puisse voir des colonnes. Pour tester le redimensionnement de la liste, vous pouvez mettre la propriété Align à alClient. Pour tester le redimensionnement des colonnes, il serait préférable d’en ajouter quelques-unes.

Pour capturer les messages qui sont envoyés au contrôle, il faut rediriger la propriété WindowProc vers votre code. Tous les objets qui héritent de TControl possèdent cette propriété. Dans votre fichier d’en-tête, ajoutez les déclarations suivantes dans la section private:

    void __fastcall ListViewWndProc(Messages::TMessage &Message);
    Classes::TWndMethod OldListViewProc;

Ensuite, on met ce code dans le constructeur de la Form:

    OldListViewProc = ListView1->WindowProc;
    ListView1->WindowProc = ListViewWndProc;

Il ne reste plus que le gros morceau maintenant:

void __fastcall TForm1::ListViewWndProc(Messages::TMessage &Message)
{
    static int PrevWidth = 65535; // On met un gros nombre

    if(Message.Msg == WM_PAINT && ListView1->Items->Count <= 0)
    {
        PAINTSTRUCT PaintStruct;
        BeginPaint(ListView1->Handle, &PaintStruct);

        ListView1->Canvas->Font->Color = clWindowText;
        if(ListView1->Enabled)
            ListView1->Canvas->Brush->Color = clWindow;
        else
            ListView1->Canvas->Brush->Color = clBtnFace;
        ListView1->Canvas->FillRect(ListView1->ClientRect);

        RECT rcH;
        int HeaderHeight;
        if(GetWindowRect(ListView_GetHeader(ListView1->Handle), &rcH))
        {    // On ajoute un petit décalage à la hauteur de l'entête
            HeaderHeight = (rcH.bottom - rcH.top) + 10;
        }

        String Temp = "La liste est vide, faites quelque chose pour la remplir.";
        TRect MyRect = ListView1->ClientRect;
        MyRect.Top = HeaderHeight;
        ListView1->Canvas->TextRect(MyRect, Temp, Graphics::TTextFormat() <<
            tfCenter << tfWordBreak << tfNoPrefix << tfNoClip);

        EndPaint(ListView1->Handle, &PaintStruct);
        Message.Result = 0; // On retourne 0 car WM_PAINT à été traité
        return;
    }
    else if(Message.Msg == WM_SIZE && ListView1->Items->Count <= 0)
    {
        if(Message.LParamLo < PrevWidth)
        {   // Quand la largeur de la liste diminue WM_PAINT n'est pas appelé, donc on le fait
            ListView1->Invalidate();
        }
        PrevWidth = Message.LParamLo; // On enregistre la nouvelle largeur
        Message.Result = 0; // On retourne 0 car WM_SIZE à été traité
    }
    OldListViewProc(Message);
}

La première partie du code sert à intercepter le message WM_PAINT dans le but de dessiner la liste. WParam et LParam ne sont pas utilisés pour ce message.

Le texte sera toujours de la couleur clWindowText et l’arrière plan, un rectangle dessiné par FillRect, sera clWindow ou clBtnFace dépendant si le contrôle est activé ou désactivé. Servez-vous des fonctions GetWindowRect et ListView_GetHeader pour aller chercher la hauteur de l’en-tête de liste à laquelle il est préférable d’ajouter un décalage de 10 pixels pour rendre le texte plus apparent. Ensuite, on dessine le texte avec TextRect qui permet de centrer le texte dans le rectangle qui correspond à la taille de la zone client du contrôle.

Dans la deuxième partie, on intercepte le message WM_SIZE car  il faut redessiner le contrôle lorsqu’il rapetisse. Le mot inférieur de LParam, LParamLo, correspond à la largeur de la zone client du contrôle. LParamHi contient la hauteur mais vous n’en aurez pas besoin.

Vous pouvez tenter de compiler le code sans cette section et diminuer la largeur de la liste. Vous remarquerez que le message WM_PAINT n’est pas appelé et donc le texte ne se recentre pas. Je me sers d’une variable statique nommée PrevWidth pour enregistrer la dernière largeur de la liste. Si on avait voulu centrer le texte de façon verticale, il aurait aussi fallu gérer le redimensionnement de la hauteur.

Une des parties les plus importante du code est la ligne 43 où l’on transmet tous les messages non traités vers la procédure d’origine. Sans cette ligne de code, l’application ne fonctionnera pas.

J’espère que vous avez encore appris quelque chose à l’aide de cet article.