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
| Nom | Description |
|---|---|
| CMFCRibbonStatusBarPane ::CMFCRibbonStatusBarPane | Construit et initialise un objet CMFCRibbonStatusBarPane. |
Méthodes publiques
| Nom | Description |
|---|---|
| CMFCRibbonStatusBarPane ::GetAlmostLargeText | Retourne la chaîne qui définit la chaîne de texte la plus longue qui peut être affichée dans le volet sans troncation. |
| CMFCRibbonStatusBarPane ::GetTextAlign | Retourne le paramètre actuel de l’alignement du texte. |
| CMFCRibbonStatusBarPane ::IsAnimation | Détermine si l’animation est en cours. |
| CMFCRibbonStatusBarPane ::IsExtended | Détermine si le volet se trouve dans la zone étendue de la barre d’état du ruban. |
| CMFCRibbonStatusBarPane ::OnDrawBorder | (Remplacements CMFCRibbonButton ::OnDrawBorder.) |
| CMFCRibbonStatusBarPane ::OnFillBackground | (Remplacements CMFCRibbonButton ::OnFillBackground.) |
| CMFCRibbonStatusBarPane ::SetAlmostLargeText | Définit la chaîne de texte la plus longue qui peut être affichée dans le volet sans troncation. |
| CMFCRibbonStatusBarPane ::SetAnimationList | Affecte au volet une liste d’images qui peut être utilisée pour l’animation. |
| CMFCRibbonStatusBarPane ::SetTextAlign | Définit l’alignement du texte. |
| CMFCRibbonStatusBarPane ::StartAnimation | Démarre l’animation affectée au volet. |
| CMFCRibbonStatusBarPane ::StopAnimation | Arrête l’animation affectée au volet. . |
Méthodes protégées
| Nom | Description |
|---|---|
| CMFCRibbonStatusBarPane ::OnFinishAnimation | Appelé par l’infrastructure lorsque l’animation affectée au volet s’arrête. |
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
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
StopAnimationla méthode appelle la OnFinishAnimation méthode, que vous pouvez utiliser pour propre des 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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour