Partager via


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 :

Marqueurs standard pour l’ancrage intelligent.

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 :

Marqueurs personnalisés pour l’ancrage intelligent.

Hiérarchie d'héritage

CObject

CSmartDockingInfo

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

Graphique hiérarchique
Classes
CObject, classe