Classe CSmartDockingInfo
Definisce l'aspetto dei marcatori standard di ancoraggio intelligente.
Sintassi
class CSmartDockingInfo : public CObject
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
CSmartDockingInfo::CSmartDockingInfo |
Costruttore predefinito. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CSmartDockingInfo::CopyTo | Copia i parametri delle informazioni di ancoraggio intelligente correnti nell'oggetto CSmartDockingInfo fornito. |
Membri dei dati
| Nome | Descrizione |
|---|---|
| CSmartDockingInfo::m_bUseThemeColorInShading | Specifica se utilizzare il colore del tema corrente quando il framework visualizza indicatori di ancoraggio intelligente. |
| CSmartDockingInfo::m_clrBaseBackground | Specifica il colore di sfondo di base dei marcatori di ancoraggio intelligente. |
| CSmartDockingInfo::m_clrToneDest | Specifica il colore che sostituisce m_clrToneSrc nelle bitmap del marcatore di ancoraggio intelligente. |
| CSmartDockingInfo::m_clrToneSrc | Specifica il colore delle bitmap dell'indicatore di ancoraggio intelligente. |
| CSmartDockingInfo::m_clrTransparent | Specifica il colore delle bitmap del marcatore di ancoraggio intelligente quando sono trasparenti. |
| CSmartDockingInfo::m_nCentralGroupOffset | Specifica l'offset del gruppo centrale di indicatori di ancoraggio intelligente dai limiti del rettangolo del gruppo centrale. |
| CSmartDockingInfo::m_sizeTotal | Specifica le dimensioni totali di tutti i marcatori di ancoraggio intelligente in un gruppo. |
| CSmartDockingInfo::m_uiMarkerBmpResID | Definisce gli ID risorsa delle bitmap usate dal framework per gli indicatori di ancoraggio intelligente non evidenziati. |
| CSmartDockingInfo::m_uiMarkerLightBmpResID | Definisce gli ID risorsa delle bitmap usate dal framework per i marcatori di ancoraggio intelligenti evidenziati. |
Osservazioni:
Il framework gestisce internamente i marcatori di ancoraggio intelligente. La figura seguente mostra i marcatori di ancoraggio intelligente standard:
In questa figura l'immagine a sinistra mostra un indicatore di ancoraggio intelligente del gruppo centrale che non dispone dell'ancoraggio a una scheda abilitata. L'immagine al centro mostra un indicatore di ancoraggio intelligente del bordo destro. L'immagine a destra mostra un indicatore di ancoraggio intelligente del gruppo centrale con ancoraggio a una scheda abilitata. L'indicatore di ancoraggio intelligente del gruppo centrale ha una bitmap principale e cinque bitmap di ancoraggio intelligente.
È possibile personalizzare i parametri seguenti dei marcatori di ancoraggio intelligente:
Colore. Ad esempio, è possibile sostituire il colore blu dei marcatori nella figura con qualsiasi colore definito dall'utente.
Colore trasparenza.
Offset di un marcatore di ancoraggio intelligente nel gruppo centrale dal bordo del rettangolo di delimitazione.
Bitmap principale che rappresenta il gruppo centrale.
Bitmap che rappresenta i normali indicatori di ancoraggio intelligente evidenziati e regolari.
La figura seguente mostra un esempio di indicatori di ancoraggio intelligente che sono stati personalizzati:
Gerarchia di ereditarietà
Requisiti
Intestazione: afxDockingManager.h
CSmartDockingInfo::CopyTo
Copia i parametri di ancoraggio intelligente correnti nell'oggetto CSmartDockingInfo fornito.
void CopyTo(CSmartDockingInfo& params);
Parametri
params
[out] Oggetto di tipo CSmartDockingInfo popolato con i parametri di ancoraggio intelligente correnti.
CSmartDockingInfo::m_bUseThemeColorInShading
Specifica se utilizzare il colore del tema corrente quando il framework visualizza indicatori di ancoraggio intelligente.
BOOL m_bUseThemeColorInShading;
Osservazioni:
Se TRUE, i marcatori vengono disegnati utilizzando il colore del tema corrente; in caso contrario, i marcatori vengono disegnati con un colore blu chiaro.
Il valore predefinito è FALSE.
CSmartDockingInfo::m_clrBaseBackground
Specifica il colore di sfondo di base dei marcatori di ancoraggio intelligente.
COLORREF m_clrBaseBackground;
CSmartDockingInfo::m_clrToneDest
Specifica il colore che sostituirà m_clrToneSrc nelle bitmap dell'indicatore di ancoraggio intelligente.
COLORREF m_clrToneDest;
Osservazioni:
Impostare questo valore per modificare il colore delle bitmap del marcatore a livello di codice. Ad esempio, se si vuole modificare il colore dei marcatori standard forniti con il framework, impostare questo valore sul colore desiderato. Per impostazione predefinita, CSmartDockingInfo::m_clrToneSrc è impostato su RGB (61, 123, 241) (colore blusce).
Per modificare il colore dei marcatori personalizzati, è necessario specificare sia m_clrToneDest che m_clrToneSrc.
CSmartDockingInfo::m_clrToneSrc
Specifica il colore delle bitmap dell'indicatore di ancoraggio intelligente.
COLORREF m_clrToneSrc;
Osservazioni:
Impostare questo valore solo quando si desidera sostituire il colore di una bitmap personalizzata con un altro colore. Non è necessario impostare questo valore se si modifica il colore di un marcatore standard (fornito dal framework).
Usare (COLORREF)-1 per lasciare vuoto un membro del gruppo di ancoraggio intelligente.
CSmartDockingInfo::m_clrTransparent
Specifica il colore delle bitmap del marcatore di ancoraggio intelligente quando sono trasparenti.
COLORREF m_clrTransparent;
Osservazioni:
È necessario impostare questo valore quando si visualizzano marcatori personalizzati e bitmap personalizzate nel gruppo di ancoraggio.
CSmartDockingInfo::m_nCentralGroupOffset
Specifica l'offset tra il gruppo centrale di indicatori di ancoraggio intelligente e i limiti del rettangolo del gruppo centrale.
int m_nCentralGroupOffset;
Osservazioni:
Specificare questo valore se si desidera modificare l'offset predefinito tra marcatori personalizzati e i limiti del gruppo centrale di indicatori di ancoraggio intelligente. L'offset predefinito è 5 pixel.
CSmartDockingInfo::m_sizeTotal
Specifica la dimensione totale di un rettangolo di delimitazione che racchiude tutti i marcatori di ancoraggio intelligente nel gruppo centrale.
CSize m_sizeTotal;
Osservazioni:
Impostare m_sizeTotal sulle dimensioni del rettangolo di delimitazione del marcatore del gruppo centrale. È necessario specificare questo valore se si usano bitmap personalizzate per i marcatori.
CSmartDockingInfo::m_uiMarkerBmpResID
Definisce gli ID risorsa delle bitmap usate per marcatori di ancoraggio intelligente personalizzati non evidenziati.
UINT m_uiMarkerBmpResID[AFX_SD_MARKERS_NUM];
Osservazioni:
Compilare questa matrice con gli ID risorsa delle bitmap che rappresentano gli indicatori di ancoraggio intelligente. AFX_SD_MARKERS_NUM è attualmente definito come 5. Compilare la matrice come segue:
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
Definisce gli ID risorsa delle bitmap usate per i marcatori di ancoraggio intelligenti personalizzati evidenziati.
UINT m_uiMarkerLightBmpResID[AFX_SD_MARKERS_NUM];
Osservazioni:
Compilare questa matrice con gli ID risorsa delle bitmap che rappresentano gli indicatori di ancoraggio intelligente evidenziati. AFX_SD_MARKERS_NUM è attualmente definito come 5. Compilare la matrice come segue:
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;