CMFCRibbonStatusBarPane, classe

La CMFCRibbonStatusBarPane classe implémente un élément de ruban que vous pouvez ajouter à une barre d’état du ruban.

Syntaxe

class CMFCRibbonStatusBarPane : public CMFCRibbonButton

Membres

Constructeurs publics

Méthodes publiques

Méthodes protégées

Exemple

L'exemple suivant montre comment utiliser les différentes méthodes de la classe CMFCRibbonStatusBarPane. L’exemple montre comment construire un CMFCRibbonStatusBarPane objet, définir l’alignement du texte de l’étiquette du volet barre d’état, définir le texte le plus long qui peut être affiché dans le volet barre d’état sans troncation, attacher au volet barre d’état une liste d’images qui peut être utilisée pour l’animation et démarrer l’animation.

CString strTitlePane1;
CString strTitlePane2;
strTitlePane1.LoadString(IDS_STATUS_PANE1);
strTitlePane2.LoadString(IDS_STATUS_PANE2);

CMFCRibbonStatusBarPane* rsbp = new CMFCRibbonStatusBarPane( ID_STATUSBAR_PANE1, strTitlePane1, TRUE );
rsbp->SetTextAlign( TA_CENTER );
rsbp->SetAlmostLargeText( _T( "Status bar" ) );
CBitmap bitmap;
bitmap.LoadBitmapW( IDB_FILESMALL );
rsbp->SetAnimationList( (HBITMAP)bitmap );
rsbp->StartAnimation();

Hiérarchie d'héritage

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonStatusBarPane

Spécifications

En-tête : afxribbonstatusbarpane.h

CMFCRibbonStatusBarPane ::CMFCRibbonStatusBarPane

Construisez un objet de volet dans la barre d’état.

CMFCRibbonStatusBarPane(
    UINT nCmdID,
    LPCTSTR lpszText,
    BOOL bIsStatic=FALSE,
    HICON hIcon=NULL,
    LPCTSTR lpszAlmostLargeText=NULL);

CMFCRibbonStatusBarPane(
    UINT nCmdID,
    LPCTSTR lpszText,
    HBITMAP hBmpAnimationList,
    int cxAnimation=16,
    COLORREF clrTrnsp=RGB(192,192 1,192) 1,
    HICON hIcon=NULL,
    BOOL bIsStatic=FALSE);

CMFCRibbonStatusBarPane(
    UINT nCmdID,
    LPCTSTR lpszText,
    UINT uiAnimationListResID,
    int cxAnimation=16,
    COLORREF clrTrnsp=RGB(192, 192 1, 192) 1,
    HICON hIcon=NULL,
    BOOL bIsStatic=FALSE);

Paramètres

nCmdID
[in] Spécifie l’ID de commande du volet.

lpszText
[in] Spécifie la chaîne de texte à afficher dans le volet.

bIsStatic
[in] Si la valeur est TRUE, le volet d’état ne peut pas être mis en surbrillance ou sélectionné en cliquant dessus.

hIcon
[in] Spécifie un handle à une icône à afficher dans le volet.

lpszAlmostLargeText
[in] Spécifie la chaîne de texte la plus longue qui peut être affichée par le volet.

hBmpAnimationList
[in] Spécifie un handle vers une liste d’images utilisée pour l’animation.

cxAnimation
[in] Spécifie la largeur, en pixels, de l’icône dans la liste d’images utilisée pour l’animation.

clrTrnsp
[in] Spécifie la couleur transparente des images dans la liste d’images qui sont utilisées pour l’animation.

uiAnimationListResID
[in] Spécifie un ID de ressource d’une liste d’images utilisée pour l’animation.

CMFCRibbonStatusBarPane ::GetAlmostLargeText

Obtient la chaîne de texte la plus longue que le volet barre d’état peut afficher.

LPCTSTR GetAlmostLargeText() const;

Valeur de retour

Chaîne de texte la plus longue que le volet de barre d’état peut afficher.

CMFCRibbonStatusBarPane ::GetTextAlign

Obtient le paramètre actuel de l’alignement du texte de l’étiquette du volet de barre d’état.

int GetTextAlign() const;

Valeur de retour

Alignement actuel du texte qui peut être l’un des éléments suivants :

• TA_LEFT

• TA_CENTER

• TA_RIGHT.

CMFCRibbonStatusBarPane ::IsAnimation

Détermine si l’animation est en cours.

BOOL IsAnimation() const;

Valeur de retour

TRUE si l’animation est en cours ; FALSE dans le cas contraire.

CMFCRibbonStatusBarPane ::IsExtended

Déterminez si le volet se trouve dans la zone étendue de la barre d’état du ruban.

BOOL IsExtended() const;

Valeur de retour

TRUE si le volet se trouve dans la zone étendue de la barre d’état. FALSE dans le cas contraire.

CMFCRibbonStatusBarPane ::OnDrawBorder

Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.

virtual void OnDrawBorder(CDC*);

Paramètres

[in] CDC*

Notes

CMFCRibbonStatusBarPane ::OnFillBackground

Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.

virtual COLORREF OnFillBackground(CDC* pDC);

Paramètres

[in] pDC

Valeur de retour

Notes

CMFCRibbonStatusBarPane ::OnFinishAnimation

L’infrastructure appelle cette méthode lorsque l’animation affectée au volet se termine.

virtual void OnFinishAnimation();

Notes

StopAnimation la méthode appelle la OnFinishAnimation méthode, que vous pouvez utiliser pour nettoyer les données lorsque l’animation se termine.

CMFCRibbonStatusBarPane ::SetAlmostLargeText

Définissez le texte le plus long qui peut être affiché dans le volet de la barre d’état sans troncation.

void SetAlmostLargeText(LPCTSTR lpszAlmostLargeText);

Paramètres

lpszAlmostLargeText
[in] Spécifie la chaîne la plus longue qui peut être affichée dans le volet de la barre d’état sans troncation.

Notes

La bibliothèque calcule la taille du texte spécifié par lpszAlmostLargeText et redimensionne le volet en conséquence. Le texte sera tronqué s’il ne tient toujours pas dans le volet.

CMFCRibbonStatusBarPane ::SetAnimationList

Joint au volet barre d’état une liste d’images qui peut être utilisée pour l’animation.

void SetAnimationList(
    HBITMAP hBmpAnimationList,
    int cxAnimation=16,
    COLORREF clrTransp=RGB(192, 192 1, 192) 1);

BOOL SetAnimationList(
    UINT uiAnimationListResID,
    int cxAnimation=16,
    COLORREF clrTransp=RGB(192, 192 1, 192) 1);

Paramètres

hBmpAnimationList
[in] Spécifie un handle dans une liste d’images.

cxAnimation
[in] Spécifie la largeur, en pixels, du cadre dans la liste d’images.

clrTransp
[in] Spécifie la couleur transparente de la liste d’images.

uiAnimationListResID
[in] Spécifie l’ID de ressource de la liste d’images.

Valeur de retour

TRUE si la liste d’images est correctement attachée au volet de la barre d’état ; FALSE dans le cas contraire.

CMFCRibbonStatusBarPane ::SetTextAlign

Définit l’alignement du texte de l’étiquette du volet de barre d’état.

void SetTextAlign(int nAlign);

Paramètres

nAlign
[in] Spécifie l’alignement du texte.

Notes

nAlign peut avoir l’une des valeurs suivantes :

• TA_LEFT : alignement gauche

• TA_CENTER : alignement central

• TA_RIGHT : alignement droit

CMFCRibbonStatusBarPane ::StartAnimation

Démarre l’animation que vous affectez au volet.

void StartAnimation(
    UINT nFrameDelay=500,
    UINT nDuration=-1);

Paramètres

nFrameDelay
[in] Spécifie la fréquence d’images d’animation, en millisecondes.

nDuration
[in] Spécifie la durée de lecture de l’animation, en millisecondes. Utilisez -1 pour une boucle infinie.

Notes

Vous devez spécifier un handle dans une liste d’images avant d’appeler StartAnimation à l’aide SetAnimationListde .

CMFCRibbonStatusBarPane ::StopAnimation

Arrête l’animation que vous avez affectée au volet de barre d’état.

void StopAnimation();

Voir aussi

Graphique hiérarchique
Classes
CMFCRibbonButton, classe
CMFCRibbonStatusBar, classe