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à

CObject

CSmartDockingInfo

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;

Vedi anche

Grafico della gerarchia
Classi
Classe CObject