CSmartDockingInfo, classe
Définit l'apparence des marqueurs d'ancrage intelligents.
Syntaxe
class CSmartDockingInfo : public CObject
Membres
Constructeurs publics
| Nom | Description |
|---|---|
CSmartDockingInfo::CSmartDockingInfo |
Constructeur par défaut. |
Méthodes publiques
| Nom | Description |
|---|---|
| CSmartDockingInfo ::CopyTo | Copie les paramètres d’informations d’ancrage intelligent actuels dans l’objet CSmartDockingInfo fourni. |
Données membres
| Nom | Description |
|---|---|
| CSmartDockingInfo ::m_bUseThemeColorInShading | Spécifie s’il faut utiliser la couleur de thème actuelle lorsque l’infrastructure affiche des marqueurs d’ancrage intelligents. |
| CSmartDockingInfo ::m_clrBaseBackground | Spécifie la couleur d’arrière-plan de base des marqueurs d’ancrage intelligent. |
| CSmartDockingInfo ::m_clrToneDest | Spécifie la couleur qui remplace les bitmaps m_clrToneSrc de marqueurs d’ancrage intelligent. |
| CSmartDockingInfo ::m_clrToneSrc | Spécifie la couleur des bitmaps de marqueurs d’ancrage intelligent. |
| CSmartDockingInfo ::m_clrTransparent | Spécifie la couleur des bitmaps de marqueurs d’ancrage intelligent lorsqu’elles sont transparentes. |
| CSmartDockingInfo ::m_nCentralGroupOffset | Spécifie le décalage du groupe central de marqueurs d’ancrage intelligent à partir des limites du rectangle du groupe central. |
| CSmartDockingInfo ::m_sizeTotal | Spécifie la taille totale de tous les marqueurs d’ancrage intelligent dans un groupe. |
| CSmartDockingInfo ::m_uiMarkerBmpResID | Définit les ID de ressources des bitmaps que l’infrastructure utilise pour les marqueurs d’ancrage intelligent qui ne sont pas mis en surbrillance. |
| CSmartDockingInfo ::m_uiMarkerLightBmpResID | Définit les ID de ressources des bitmaps que l’infrastructure utilise pour les marqueurs d’ancrage intelligent mis en surbrillance. |
Notes
L’infrastructure gère les marqueurs d’ancrage intelligents en interne. L’illustration suivante montre les marqueurs d’ancrage intelligent standard :
Dans cette figure, l’image située à gauche montre un marqueur d’ancrage intelligent de groupe central qui n’a pas d’ancrage sur un onglet activé. L’image au milieu montre un marqueur d’ancrage intelligent de bord droit. L’image à droite montre un marqueur d’ancrage intelligent de groupe central qui a une ancrage sur un onglet activé. Le marqueur d’ancrage intelligent du groupe central a une bitmap principale et cinq bitmaps de marqueur d’ancrage intelligente.
Vous pouvez personnaliser les paramètres suivants des marqueurs d’ancrage intelligent :
Couleur. Par exemple, vous pouvez remplacer la couleur bleue des marqueurs de la figure par n’importe quelle couleur définie par l’utilisateur.
Couleur de transparence.
Décalage d’un marqueur d’ancrage intelligent dans le groupe central à partir de la bordure du rectangle englobant.
Bitmap principale qui représente le groupe central.
Bitmaps qui représentent les marqueurs d’ancrage intelligents standard et mis en surbrillance.
L’illustration suivante montre un exemple de marqueurs d’ancrage intelligent qui ont été personnalisés :
Hiérarchie d'héritage
Spécifications
En-tête : afxDockingManager.h
CSmartDockingInfo ::CopyTo
Copie les paramètres d’ancrage intelligent actuels dans l’objet CSmartDockingInfo fourni.
void CopyTo(CSmartDockingInfo& params);
Paramètres
params
[out] Objet de type CSmartDockingInfo rempli avec les paramètres d’ancrage intelligent actuels.
CSmartDockingInfo ::m_bUseThemeColorInShading
Spécifie s’il faut utiliser la couleur de thème actuelle lorsque l’infrastructure affiche des marqueurs d’ancrage intelligents.
BOOL m_bUseThemeColorInShading;
Notes
Si la valeur est TRUE, les marqueurs sont dessinés à l’aide de la couleur de thème actuelle ; sinon, les marqueurs sont dessinés avec une couleur bleue claire.
La valeur par défaut est FALSE.
CSmartDockingInfo ::m_clrBaseBackground
Spécifie la couleur d’arrière-plan de base des marqueurs d’ancrage intelligent.
COLORREF m_clrBaseBackground;
CSmartDockingInfo ::m_clrToneDest
Spécifie la couleur qui remplacera m_clrToneSrc les bitmaps de marqueurs d’ancrage intelligent.
COLORREF m_clrToneDest;
Notes
Définissez cette valeur pour modifier la couleur des bitmaps de marqueurs par programmation. Par exemple, si vous souhaitez modifier la couleur des marqueurs standard fournis avec l’infrastructure, définissez cette valeur sur la couleur souhaitée. Par défaut, CSmartDockingInfo ::m_clrToneSrc est défini sur RVB (61, 123, 241) (couleur bleutée).
Pour modifier la couleur des marqueurs personnalisés, vous devez spécifier à la fois m_clrToneDest et m_clrToneSrc.
CSmartDockingInfo ::m_clrToneSrc
Spécifie la couleur des bitmaps de marqueurs d’ancrage intelligent.
COLORREF m_clrToneSrc;
Notes
Définissez cette valeur uniquement lorsque vous souhaitez remplacer la couleur d’une bitmap personnalisée par une autre couleur. Vous n’avez pas besoin de définir cette valeur si vous modifiez la couleur d’un marqueur standard (framework fourni).
Permet (COLORREF)-1 de laisser un membre du groupe d’ancrage intelligent vide.
CSmartDockingInfo ::m_clrTransparent
Spécifie la couleur des bitmaps de marqueurs d’ancrage intelligent lorsqu’elles sont transparentes.
COLORREF m_clrTransparent;
Notes
Vous devez définir cette valeur lorsque vous affichez des marqueurs personnalisés et des bitmaps personnalisées dans le groupe d’ancrage.
CSmartDockingInfo ::m_nCentralGroupOffset
Spécifie le décalage entre le groupe central de marqueurs d’ancrage intelligent et les limites du rectangle de groupe central.
int m_nCentralGroupOffset;
Notes
Spécifiez cette valeur si vous souhaitez modifier le décalage par défaut entre les marqueurs personnalisés et les limites du groupe central de marqueurs d’ancrage intelligent. Le décalage par défaut est de 5 pixels.
CSmartDockingInfo ::m_sizeTotal
Spécifie la taille totale d’un rectangle englobant qui entoure tous les marqueurs d’ancrage intelligent dans le groupe central.
CSize m_sizeTotal;
Notes
Définissez m_sizeTotal la taille du rectangle englobant du marqueur de groupe central. Vous devez spécifier cette valeur si vous utilisez des bitmaps personnalisées pour les marqueurs.
CSmartDockingInfo ::m_uiMarkerBmpResID
Définit les ID de ressources des bitmaps utilisées pour les marqueurs d’ancrage intelligents personnalisés non mis en surbrillance.
UINT m_uiMarkerBmpResID[AFX_SD_MARKERS_NUM];
Notes
Remplissez ce tableau avec les ID de ressource des bitmaps représentant les marqueurs d’ancrage intelligents. AFX_SD_MARKERS_NUM est actuellement défini sur 5. Vous remplissez le tableau comme suit :
params.m_uiMarkerBmpResID[0] = IDB_MARKER_LEFT;
params.m_uiMarkerBmpResID[1] = IDB_MARKER_RIGHT;
params.m_uiMarkerBmpResID[2] = IDB_MARKER_TOP;
params.m_uiMarkerBmpResID[3] = IDB_MARKER_BOTTOM;
params.m_uiMarkerBmpResID[4] = IDB_MARKER_CENTER;
CSmartDockingInfo ::m_uiMarkerLightBmpResID
Définit les ID de ressource des bitmaps utilisées pour les marqueurs d’ancrage intelligents personnalisés mis en surbrillance.
UINT m_uiMarkerLightBmpResID[AFX_SD_MARKERS_NUM];
Notes
Remplissez ce tableau avec les ID de ressource des bitmaps représentant les marqueurs d’ancrage intelligents mis en surbrillance. AFX_SD_MARKERS_NUM est actuellement défini sur 5. Vous remplissez le tableau comme suit :
params.m_uiMarkerLightBmpResID[0] = IDB_MARKER_LEFT_LIGHT;
params.m_uiMarkerLightBmpResID[1] = IDB_MARKER_RIGHT_LIGHT;
params.m_uiMarkerLightBmpResID[2] = IDB_MARKER_TOP_LIGHT;
params.m_uiMarkerLightBmpResID[3] = IDB_MARKER_BOTTOM_LIGHT;
params.m_uiMarkerLightBmpResID[4] = IDB_MARKER_CENTER_LIGHT;
Voir aussi
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