CPagerCtrl, classe
La classe CPagerCtrl inclut dans un wrapper le contrôle pager Windows, qui peut afficher une fenêtre contenue qui ne tient pas dans la fenêtre conteneur.
Syntaxe
class CPagerCtrl : public CWnd
Membres
Constructeurs publics
| Nom | Description |
|---|---|
| CPagerCtrl ::CPagerCtrl | Construit un objet CPagerCtrl. |
Méthodes publiques
| Nom | Description |
|---|---|
| CPagerCtrl ::Create | Crée un contrôle de pagineur avec des styles spécifiés et l’attache à l’objet actuel CPagerCtrl . |
| CPagerCtrl ::CreateEx | Crée un contrôle de pagineur avec des styles étendus spécifiés et l’attache à l’objet actuel CPagerCtrl . |
| CPagerCtrl ::ForwardMouse | Active ou désactive le transfert WM_MOUSEMOVE messages vers la fenêtre contenue dans le contrôle de pagineur actif. |
| CPagerCtrl ::GetBkColor | Récupère la couleur d’arrière-plan du contrôle de pagineur actif. |
| CPagerCtrl ::GetBorder | Récupère la taille de bordure du contrôle de pagineur actif. |
| CPagerCtrl ::GetButtonSize | Récupère la taille du bouton du contrôle de pagineur actif. |
| CPagerCtrl ::GetButtonState | Récupère l’état du bouton spécifié dans le contrôle du pagineur actif. |
| CPagerCtrl ::GetDropTarget | Récupère l’interface IDropTarget pour le contrôle de pagineur actuel. |
| CPagerCtrl ::GetScrollPos | Récupère la position de défilement du contrôle de pagineur actif. |
| CPagerCtrl ::IsButtonDepressed | Indique si le bouton spécifié du contrôle de pagineur actif est en pressed état. |
| CPagerCtrl ::IsButtonGrayed | Indique si le bouton spécifié du contrôle de pagineur actif est en grayed état. |
| CPagerCtrl ::IsButtonHot | Indique si le bouton spécifié du contrôle de pagineur actif est en hot état. |
| CPagerCtrl ::IsButtonInvisible | Indique si le bouton spécifié du contrôle de pagineur actif est en invisible état. |
| CPagerCtrl ::IsButtonNormal | Indique si le bouton spécifié du contrôle de pagineur actif est en normal état. |
| CPagerCtrl ::RecalcSize | Provoque le recalcul du contrôle du pagineur actuel pour recalculer la taille de la fenêtre autonome. |
| CPagerCtrl ::SetBkColor | Définit la couleur d’arrière-plan du contrôle de pagineur actif. |
| CPagerCtrl ::SetBorder | Définit la taille de bordure du contrôle de pagineur actif. |
| CPagerCtrl ::SetButtonSize | Définit la taille du bouton du contrôle de pagineur actif. |
| CPagerCtrl ::SetChild | Définit la fenêtre autonome du contrôle de pagineur actif. |
| CPagerCtrl ::SetScrollPos | Définit la position de défilement du contrôle de pagineur actif. |
Notes
Un contrôle de pagineur est une fenêtre qui contient une autre fenêtre linéaire et supérieure à la fenêtre contenante et vous permet de faire défiler la fenêtre autonome en mode affichage. Le contrôle pager affiche deux boutons de défilement qui disparaissent automatiquement lorsque la fenêtre autonome fait défiler jusqu’à sa plus grande étendue, et réapparaître autrement. Vous pouvez créer un contrôle de pagineur qui fait défiler horizontalement ou verticalement.
Par exemple, si votre application a une barre d’outils qui n’est pas suffisamment large pour afficher tous ses éléments, vous pouvez affecter la barre d’outils à un contrôle de pagineur et les utilisateurs pourront faire défiler la barre d’outils vers la gauche ou la droite pour accéder à tous les éléments. Microsoft Internet Explorer Version 4.0 (commctrl.dll version 4.71) introduit le contrôle de pagineur.
La CPagerCtrl classe est dérivée de la classe CWnd . Pour plus d’informations et une illustration d’un contrôle pager, consultez Contrôles Pager.
Hiérarchie d'héritage
CPagerCtrl
Spécifications
En-tête : afxcmn.h
CPagerCtrl ::CPagerCtrl
Construit un objet CPagerCtrl.
CPagerCtrl();
Notes
Utilisez la méthode CPagerCtrl ::Create ou CPagerCtrl ::CreateEx pour créer un contrôle pager et l’attacher à l’objet CPagerCtrl .
CPagerCtrl ::Create
Crée un contrôle de pagineur avec des styles spécifiés et l’attache à l’objet actuel CPagerCtrl .
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Paramètres
dwStyle
[in] Combinaison de bits (OR) de styles de fenêtre et de styles de contrôle de pagineur à appliquer au contrôle.
Rect
[in] Référence à une structure RECT qui contient la position et la taille du contrôle dans les coordonnées du client.
pParentWnd
[in] Pointeur vers un objet CWnd qui est la fenêtre parente du contrôle. Ce paramètre ne peut pas être NULL.
nID
[in] ID du contrôle.
Valeur de retour
TRUE si cette méthode réussit ; sinon, FALSE.
Notes
Pour créer un contrôle de pagineur, déclarez une CPagerCtrl variable, puis appelez la méthode CPagerCtrl ::Create ou CPagerCtrl ::CreateEx sur cette variable.
Exemple
L’exemple suivant crée un contrôle de pagineur, puis utilise la méthode CPagerCtrl ::SetChild pour associer un contrôle bouton très long au contrôle pager. L’exemple utilise ensuite la méthode CPagerCtrl ::SetButtonSize pour définir la hauteur du contrôle pager sur 20 pixels et la méthode CPagerCtrl ::SetBorder pour définir l’épaisseur de la bordure sur 1 pixel.
// Initialize the dropdown menu of the splitbutton control.
m_splitButton.SetDropDownMenu(IDR_MENU1, 0);
// Create the pager control.
BOOL nRet;
CRect rect;
GetClientRect(&rect);
nRet = m_pager.Create(
(WS_VISIBLE | WS_CHILD | PGS_HORZ),
CRect(rect.Width() / 4, 5, (rect.Width() * 3) / 4, 55),
this,
IDC_PAGER1);
m_pager.GetClientRect(&rect);
nRet = m_button.Create(
_T("This is a very, very long button. 012345678901234567890"),
(WS_VISIBLE | WS_CHILD), // Do not use CCS_NORESIZE.
CRect(0, 0, rect.Width(), 30),
&m_pager, IDC_BUTTON1);
m_pager.SetChild(m_button.m_hWnd);
m_pager.SetButtonSize(20);
m_pager.SetBorder(1);
CPagerCtrl ::CreateEx
Crée un contrôle de pagineur avec des styles étendus spécifiés et l’attache à l’objet actuel CPagerCtrl .
virtual BOOL CreateEx(
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Paramètres
dwExStyle
[in] Combinaison de bits de styles étendus à appliquer au contrôle. Pour plus d’informations, consultez le paramètre dwExStyle de la fonction CreateWindowEx .
dwStyle
[in] Combinaison de bits (OR) de styles de fenêtre et de styles de contrôle de pagineur à appliquer au contrôle.
Rect
[in] Référence à une structure RECT qui contient la position et la taille du contrôle dans les coordonnées du client.
pParentWnd
[in] Pointeur vers un objet CWnd qui est la fenêtre parente du contrôle. Ce paramètre ne peut pas être NULL.
nID
[in] ID du contrôle.
Valeur de retour
TRUE si cette méthode réussit ; sinon, FALSE.
Notes
Pour créer un contrôle de pagineur, déclarez une CPagerCtrl variable, puis appelez la méthode CPagerCtrl ::Create ou CPagerCtrl ::CreateEx sur cette variable.
CPagerCtrl ::ForwardMouse
Active ou désactive le transfert WM_MOUSEMOVE messages vers la fenêtre contenue dans le contrôle de pagineur actif.
void ForwardMouse(BOOL bForward);
Paramètres
bForward
[in] TRUE pour transférer les messages de la souris ou FALSE pour ne pas transférer les messages de la souris.
Notes
Cette méthode envoie le message PGM_FORWARDMOUSE , qui est décrit dans le Kit de développement logiciel (SDK) Windows.
CPagerCtrl ::GetBorder
Récupère la taille de bordure du contrôle de pagineur actif.
int GetBorder() const;
Valeur de retour
Taille de bordure actuelle, mesurée en pixels.
Notes
Cette méthode envoie le message PGM_GETo ORDER, qui est décrit dans le Kit de développement logiciel (SDK) Windows.
Exemple
L’exemple suivant utilise la méthode CPagerCtrl ::GetBorder pour récupérer l’épaisseur de la bordure du contrôle pager.
void CCSplitButton_s2Dlg::OnXBorder()
{
int borderSize = m_pager.GetBorder();
CString str;
str.Format(_T("The border is %d pixel(s) thick."), borderSize);
MessageBox(str);
}
CPagerCtrl ::GetBkColor
Récupère la couleur d’arrière-plan du contrôle de pagineur actif.
COLORREF GetBkColor() const;
Valeur de retour
Valeur COLORREF qui contient la couleur d’arrière-plan actuelle du contrôle pagineur.
Notes
Cette méthode envoie le message PGM_GETo KCOLOR, qui est décrit dans le Kit de développement logiciel (SDK) Windows.
Exemple
L’exemple suivant utilise la méthode CPagerCtrl ::SetBkColor pour définir la couleur d’arrière-plan du contrôle pager sur rouge et la méthode CPagerCtrl ::GetBkColor pour confirmer que la modification a été apportée.
void CCSplitButton_s2Dlg::OnXColor()
{
COLORREF originalColor;
// Set color to red.
originalColor = m_pager.SetBkColor(RGB(255, 0, 0));
if (m_pager.GetBkColor() != RGB(255, 0, 0))
{
MessageBox(_T("Control did not return RED as the previous color."));
}
// The following statement is one way to restore the color.
// m_pager.SetBkColor( originalColor );
}
CPagerCtrl ::GetButtonSize
Récupère la taille du bouton du contrôle de pagineur actif.
int GetButtonSize() const;
Valeur de retour
Taille actuelle du bouton, mesurée en pixels.
Notes
Cette méthode envoie le message PGM_GETo UTTONSIZE, qui est décrit dans le Kit de développement logiciel (SDK) Windows.
Si le contrôle de pagineur a le style PGS_HORZ, la taille du bouton détermine la largeur des boutons du pagineur et si le contrôle de page a le style PGS_VERT, la taille du bouton détermine la hauteur des boutons du pagineur. Pour plus d’informations, consultez Styles de contrôle Pager.
CPagerCtrl ::GetButtonState
Récupère l’état du bouton de défilement spécifié dans le contrôle de pagineur actif.
DWORD GetButtonState(int iButton) const;
Paramètres
iButton
[in] Indique le bouton pour lequel l’état est récupéré. Si le style de contrôle du pagineur est PGS_HORZ, spécifiez PGB_TOPORLEFT pour le bouton gauche et PGB_BOTTOMORRIGHT pour le bouton droit. Si le style de contrôle du pagineur est PGS_VERT, spécifiez PGB_TOPORLEFT pour le bouton supérieur et PGB_BOTTOMORRIGHT pour le bouton inférieur. Pour plus d’informations, consultez Styles de contrôle Pager.
Valeur de retour
État du bouton spécifié par le paramètre iButton . L’état est PGF_INVISIBLE, PGF_NORMAL, PGF_GRAYED, PGF_DEPRESSED ou PGF_HOT. Pour plus d’informations, consultez la section Valeur de retour du message PGM_GETo UTTONSTATE.
Notes
Cette méthode envoie le message PGM_GETo UTTONSTATE, qui est décrit dans le Kit de développement logiciel (SDK) Windows.
CPagerCtrl ::GetDropTarget
Récupère l’interface IDropTarget pour le contrôle de pagineur actuel.
IDropTarget* GetDropTarget() const;
Valeur de retour
Pointeur vers l’interface IDropTarget du contrôle de pagineur actif.
Notes
IDropTarget est l’une des interfaces que vous implémentez pour prendre en charge les opérations de glisser-déplacer dans votre application.
Cette méthode envoie le message PGM_GETDROPTARGET , qui est décrit dans le Kit de développement logiciel (SDK) Windows. L’appelant de cette méthode est responsable de l’appel du Release membre de l’interface IDropTarget lorsque l’interface n’est plus nécessaire.
CPagerCtrl ::GetScrollPos
Récupère la position de défilement du contrôle de pagineur actif.
int GetScrollPos() const;
Valeur de retour
Position de défilement actuelle, mesurée en pixels.
Notes
Cette méthode envoie le message PGM_GETPOS , qui est décrit dans le Kit de développement logiciel (SDK) Windows.
Exemple
L’exemple suivant utilise la méthode CPagerCtrl ::GetScrollPos pour récupérer la position de défilement actuelle du contrôle pager. Si le contrôle de page n’est pas déjà fait défiler vers zéro, la position la plus à gauche, l’exemple utilise la méthode CPagerCtrl ::SetScrollPos pour définir la position de défilement sur zéro.
void CCSplitButton_s2Dlg::OnXScrollposition()
{
int pos;
CString str;
pos = m_pager.GetScrollPos();
if (pos != 0)
m_pager.SetScrollPos(0);
str.Format(_T("Old position = %d; new position = 0"), pos);
MessageBox(str);
}
CPagerCtrl ::IsButtonDepressed
Indique si le bouton de défilement spécifié du contrôle de pagineur actif est enfoncé.
BOOL IsButtonDepressed(int iButton) const;
Paramètres
iButton
[in] Indique le bouton pour lequel l’état est récupéré. Si le style de contrôle du pagineur est PGS_HORZ, spécifiez PGB_TOPORLEFT pour le bouton gauche et PGB_BOTTOMORRIGHT pour le bouton droit. Si le style de contrôle du pagineur est PGS_VERT, spécifiez PGB_TOPORLEFT pour le bouton supérieur et PGB_BOTTOMORRIGHT pour le bouton inférieur. Pour plus d’informations, consultez Styles de contrôle Pager.
Valeur de retour
TRUE si le bouton spécifié est dans l’état enfoncé ; sinon, FALSE.
Notes
Cette méthode envoie le message PGM_GETo UTTONSTATE, qui est décrit dans le Kit de développement logiciel (SDK) Windows. Il teste ensuite si l’état retourné est PGF_DEPRESSED. Pour plus d’informations, consultez la section Valeur de retour du message PGM_GETo UTTONSTATE.
CPagerCtrl ::IsButtonGrayed
Indique si le bouton de défilement spécifié du contrôle de page actuel est grisé.
BOOL IsButtonGrayed(int iButton) const;
Paramètres
iButton
[in] Indique le bouton pour lequel l’état est récupéré. Si le style de contrôle du pagineur est PGS_HORZ, spécifiez PGB_TOPORLEFT pour le bouton gauche et PGB_BOTTOMORRIGHT pour le bouton droit. Si le style de contrôle du pagineur est PGS_VERT, spécifiez PGB_TOPORLEFT pour le bouton supérieur et PGB_BOTTOMORRIGHT pour le bouton inférieur. Pour plus d’informations, consultez Styles de contrôle Pager.
Valeur de retour
TRUE si le bouton spécifié est grisé ; sinon, FALSE.
Notes
Cette méthode envoie le message PGM_GETo UTTONSTATE, qui est décrit dans le Kit de développement logiciel (SDK) Windows. Il teste ensuite si l’état retourné est PGF_GRAYED. Pour plus d’informations, consultez la section Valeur de retour du message PGM_GETo UTTONSTATE.
CPagerCtrl ::IsButtonHot
Indique si le bouton de défilement spécifié du contrôle de pagineur actuel est en état chaud.
BOOL IsButtonHot(int iButton) const;
Paramètres
iButton
[in] Indique le bouton pour lequel l’état est récupéré. Si le style de contrôle du pagineur est PGS_HORZ, spécifiez PGB_TOPORLEFT pour le bouton gauche et PGB_BOTTOMORRIGHT pour le bouton droit. Si le style de contrôle du pagineur est PGS_VERT, spécifiez PGB_TOPORLEFT pour le bouton supérieur et PGB_BOTTOMORRIGHT pour le bouton inférieur. Pour plus d’informations, consultez Styles de contrôle Pager.
Valeur de retour
TRUE si le bouton spécifié est en état chaud ; sinon, FALSE.
Notes
Cette méthode envoie le message PGM_GETo UTTONSTATE, qui est décrit dans le Kit de développement logiciel (SDK) Windows. Il teste ensuite si l’état retourné est PGF_HOT. Pour plus d’informations, consultez la section Valeur de retour du message PGM_GETo UTTONSTATE.
CPagerCtrl ::IsButtonInvisible
Indique si le bouton de défilement spécifié du contrôle de pagineur actuel est dans un état invisible.
BOOL IsButtonInvisible(int iButton) const;
Paramètres
iButton
[in] Indique le bouton pour lequel l’état est récupéré. Si le style de contrôle du pagineur est PGS_HORZ, spécifiez PGB_TOPORLEFT pour le bouton gauche et PGB_BOTTOMORRIGHT pour le bouton droit. Si le style de contrôle du pagineur est PGS_VERT, spécifiez PGB_TOPORLEFT pour le bouton supérieur et PGB_BOTTOMORRIGHT pour le bouton inférieur. Pour plus d’informations, consultez Styles de contrôle Pager.
Valeur de retour
TRUE si le bouton spécifié est dans un état invisible ; sinon, FALSE.
Notes
Windows rend le bouton de défilement dans une direction particulière invisible lorsque la fenêtre autonome fait défiler jusqu’à sa plus grande étendue, car le fait de cliquer sur le bouton ne peut pas amener davantage de fenêtre autonome en mode affichage.
Cette méthode envoie le message PGM_GETo UTTONSTATE, qui est décrit dans le Kit de développement logiciel (SDK) Windows. Il teste ensuite si l’état retourné est PGF_INVISIBLE. Pour plus d’informations, consultez la section Valeur de retour du message PGM_GETo UTTONSTATE.
Exemple
L’exemple suivant utilise la méthode CPagerCtrl ::IsButtonInvisible pour déterminer si les boutons de défilement gauche et droit du contrôle pager sont visibles.
void CCSplitButton_s2Dlg::OnXIsbuttoninvisible()
{
BOOL bLeft = m_pager.IsButtonInvisible(PGB_TOPORLEFT);
BOOL bRight = m_pager.IsButtonInvisible(PGB_BOTTOMORRIGHT);
CString str;
str.Format(_T("The left button is%s visible; the right button is%s visible."),
(bLeft ? _T(" not") : _T("")),
(bRight ? _T(" not") : _T("")));
MessageBox(str);
}
CPagerCtrl ::IsButtonNormal
Indique si le bouton de défilement spécifié du contrôle de pagineur actif est dans un état normal.
BOOL IsButtonNormal(int iButton) const;
Paramètres
iButton
[in] Indique le bouton pour lequel l’état est récupéré. Si le style de contrôle du pagineur est PGS_HORZ, spécifiez PGB_TOPORLEFT pour le bouton gauche et PGB_BOTTOMORRIGHT pour le bouton droit. Si le style de contrôle du pagineur est PGS_VERT, spécifiez PGB_TOPORLEFT pour le bouton supérieur et PGB_BOTTOMORRIGHT pour le bouton inférieur. Pour plus d’informations, consultez Styles de contrôle Pager.
Valeur de retour
TRUE si le bouton spécifié est dans un état normal ; sinon, FALSE.
Notes
Cette méthode envoie le message PGM_GETo UTTONSTATE, qui est décrit dans le Kit de développement logiciel (SDK) Windows. Il teste ensuite si l’état retourné est PGF_NORMAL. Pour plus d’informations, consultez la section Valeur de retour du message PGM_GETo UTTONSTATE.
CPagerCtrl ::RecalcSize
Provoque le recalcul du contrôle du pagineur actuel pour recalculer la taille de la fenêtre autonome.
void RecalcSize();
Notes
Cette méthode envoie le message PGM_RECALCSIZE , qui est décrit dans le Kit de développement logiciel (SDK) Windows. Par conséquent, le contrôle de pagineur envoie la notification PGN_CALCSIZE pour obtenir les dimensions défilantes de la fenêtre autonome.
Exemple 1
L’exemple suivant utilise la méthode CPagerCtrl ::RecalcSize pour demander au contrôle de pagineur actuel de recalculer sa taille.
void CCSplitButton_s2Dlg::OnXRecalcsize()
{
// If the child control changes size, call RecalcSize() to change
// the size of the pager control accordingly.
m_pager.RecalcSize();
MessageBox(_T("The pager control size has been recalculated."));
}
Exemple 2
L’exemple suivant utilise la réflexion de message pour permettre au contrôle du pagineur de recalculer sa propre taille au lieu d’exiger que la boîte de dialogue parent du contrôle effectue le calcul. L’exemple dérive la MyPagerCtrl classe de la classe CPagerCtrl, puis utilise un mappage de messages pour associer la notification PGN_CALCSIZE au OnCalcsize gestionnaire de notification. Dans cet exemple, le gestionnaire de notification définit la largeur et la hauteur du contrôle du pagineur sur des valeurs fixes.
BEGIN_MESSAGE_MAP(CMyPagerCtrl, CPagerCtrl)
ON_NOTIFY_REFLECT(PGN_CALCSIZE, &CMyPagerCtrl::OnCalcSize)
END_MESSAGE_MAP()
// CMyPagerCtrl message handlers
void CMyPagerCtrl::OnCalcSize(NMHDR *code, LRESULT *param)
{
// If the control contained in the pager control changes size, use this
// handler to change the size of the pager control accordingly.
LPNMPGCALCSIZE tmp = (LPNMPGCALCSIZE)code;
*param = 0;
tmp->iWidth = 500;
tmp->iHeight = 50;
}
CPagerCtrl ::SetBkColor
Définit la couleur d’arrière-plan du contrôle de pagineur actif.
COLORREF SetBkColor(COLORREF clrBk);
Paramètres
clrBk
[in] Valeur COLORREF qui contient la nouvelle couleur d’arrière-plan du contrôle de pagineur.
Valeur de retour
Valeur COLORREF qui contient la couleur d’arrière-plan précédente du contrôle de pagineur.
Notes
Cette méthode envoie le message PGM_SETo KCOLOR, qui est décrit dans le Kit de développement logiciel (SDK) Windows.
Exemple
L’exemple suivant utilise la méthode CPagerCtrl ::SetBkColor pour définir la couleur d’arrière-plan du contrôle pager sur rouge et la méthode CPagerCtrl ::GetBkColor pour confirmer que la modification a été apportée.
void CCSplitButton_s2Dlg::OnXColor()
{
COLORREF originalColor;
// Set color to red.
originalColor = m_pager.SetBkColor(RGB(255, 0, 0));
if (m_pager.GetBkColor() != RGB(255, 0, 0))
{
MessageBox(_T("Control did not return RED as the previous color."));
}
// The following statement is one way to restore the color.
// m_pager.SetBkColor( originalColor );
}
CPagerCtrl ::SetBorder
Définit la taille de bordure du contrôle de pagineur actif.
int SetBorder(int iBorder);
Paramètres
iBorder
[in] Nouvelle taille de bordure, mesurée en pixels. Si le paramètre iBorder est négatif, la taille de la bordure est définie sur zéro.
Valeur de retour
Taille de bordure précédente, mesurée en pixels.
Notes
Cette méthode envoie le message PGM_SETo ORDER, qui est décrit dans le Kit de développement logiciel (SDK) Windows.
Exemple
L’exemple suivant crée un contrôle de pagineur, puis utilise la méthode CPagerCtrl ::SetChild pour associer un contrôle bouton très long au contrôle pager. L’exemple utilise ensuite la méthode CPagerCtrl ::SetButtonSize pour définir la hauteur du contrôle pager sur 20 pixels et la méthode CPagerCtrl ::SetBorder pour définir l’épaisseur de la bordure sur 1 pixel.
// Initialize the dropdown menu of the splitbutton control.
m_splitButton.SetDropDownMenu(IDR_MENU1, 0);
// Create the pager control.
BOOL nRet;
CRect rect;
GetClientRect(&rect);
nRet = m_pager.Create(
(WS_VISIBLE | WS_CHILD | PGS_HORZ),
CRect(rect.Width() / 4, 5, (rect.Width() * 3) / 4, 55),
this,
IDC_PAGER1);
m_pager.GetClientRect(&rect);
nRet = m_button.Create(
_T("This is a very, very long button. 012345678901234567890"),
(WS_VISIBLE | WS_CHILD), // Do not use CCS_NORESIZE.
CRect(0, 0, rect.Width(), 30),
&m_pager, IDC_BUTTON1);
m_pager.SetChild(m_button.m_hWnd);
m_pager.SetButtonSize(20);
m_pager.SetBorder(1);
CPagerCtrl ::SetButtonSize
Définit la taille du bouton du contrôle de pagineur actif.
int SetButtonSize(int iButtonSize);
Paramètres
iButtonSize
[in] Nouvelle taille de bouton, mesurée en pixels.
Valeur de retour
Taille du bouton précédent, mesurée en pixels.
Notes
Cette méthode envoie le message PGM_SETo UTTONSIZE, qui est décrit dans le Kit de développement logiciel (SDK) Windows.
Si le contrôle de pagineur a le style PGS_HORZ, la taille du bouton détermine la largeur des boutons du pagineur et si le contrôle de page a le style PGS_VERT, la taille du bouton détermine la hauteur des boutons du pagineur. La taille du bouton par défaut est de trois quarts de la largeur de la barre de défilement, et la taille minimale du bouton est de 12 pixels. Pour plus d’informations, consultez Styles de contrôle Pager.
Exemple
L’exemple suivant crée un contrôle de pagineur, puis utilise la méthode CPagerCtrl ::SetChild pour associer un contrôle bouton très long au contrôle pager. L’exemple utilise ensuite la méthode CPagerCtrl ::SetButtonSize pour définir la hauteur du contrôle pager sur 20 pixels et la méthode CPagerCtrl ::SetBorder pour définir l’épaisseur de la bordure sur 1 pixel.
// Initialize the dropdown menu of the splitbutton control.
m_splitButton.SetDropDownMenu(IDR_MENU1, 0);
// Create the pager control.
BOOL nRet;
CRect rect;
GetClientRect(&rect);
nRet = m_pager.Create(
(WS_VISIBLE | WS_CHILD | PGS_HORZ),
CRect(rect.Width() / 4, 5, (rect.Width() * 3) / 4, 55),
this,
IDC_PAGER1);
m_pager.GetClientRect(&rect);
nRet = m_button.Create(
_T("This is a very, very long button. 012345678901234567890"),
(WS_VISIBLE | WS_CHILD), // Do not use CCS_NORESIZE.
CRect(0, 0, rect.Width(), 30),
&m_pager, IDC_BUTTON1);
m_pager.SetChild(m_button.m_hWnd);
m_pager.SetButtonSize(20);
m_pager.SetBorder(1);
CPagerCtrl ::SetChild
Définit la fenêtre autonome du contrôle de pagineur actif.
void SetChild(HWND hwndChild);
Paramètres
hwndChild
[in] Handle to the window to be contained.
Notes
Cette méthode envoie le message PGM_SETCHILD , qui est décrit dans le Kit de développement logiciel (SDK) Windows.
Cette méthode ne modifie pas le parent de la fenêtre autonome ; il affecte uniquement un handle de fenêtre au contrôle pagineur pour le défilement. Dans la plupart des cas, la fenêtre autonome est une fenêtre enfant du contrôle pager.
Exemple
L’exemple suivant crée un contrôle de pagineur, puis utilise la méthode CPagerCtrl ::SetChild pour associer un contrôle bouton très long au contrôle pager. L’exemple utilise ensuite la méthode CPagerCtrl ::SetButtonSize pour définir la hauteur du contrôle pager sur 20 pixels et la méthode CPagerCtrl ::SetBorder pour définir l’épaisseur de la bordure sur 1 pixel.
// Initialize the dropdown menu of the splitbutton control.
m_splitButton.SetDropDownMenu(IDR_MENU1, 0);
// Create the pager control.
BOOL nRet;
CRect rect;
GetClientRect(&rect);
nRet = m_pager.Create(
(WS_VISIBLE | WS_CHILD | PGS_HORZ),
CRect(rect.Width() / 4, 5, (rect.Width() * 3) / 4, 55),
this,
IDC_PAGER1);
m_pager.GetClientRect(&rect);
nRet = m_button.Create(
_T("This is a very, very long button. 012345678901234567890"),
(WS_VISIBLE | WS_CHILD), // Do not use CCS_NORESIZE.
CRect(0, 0, rect.Width(), 30),
&m_pager, IDC_BUTTON1);
m_pager.SetChild(m_button.m_hWnd);
m_pager.SetButtonSize(20);
m_pager.SetBorder(1);
CPagerCtrl ::SetScrollPos
Définit la position de défilement du contrôle de pagineur actif.
void SetScrollPos(int iPos);
Paramètres
Offices
[in] Nouvelle position de défilement, mesurée en pixels.
Notes
Cette méthode envoie le message PGM_SETPOS , qui est décrit dans le Kit de développement logiciel (SDK) Windows.
Voir aussi
CPagerCtrl, classe
Graphique hiérarchique
Contrôles de pagineur
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