CSmartDockingInfo-Klasse
Definiert die Darstellung von intelligenten Andockmarkern.
Syntax
class CSmartDockingInfo : public CObject
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
CSmartDockingInfo::CSmartDockingInfo |
Der Standardkonstruktor. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CSmartDockingInfo::CopyTo | Kopiert die aktuellen Smart Docking-Infoparameter in das bereitgestellte CSmartDockingInfo -Objekt. |
Datenelemente
| Name | Beschreibung |
|---|---|
| CSmartDockingInfo::m_bUseThemeColorInShading | Gibt an, ob die aktuelle Designfarbe verwendet werden soll, wenn das Framework intelligente Andockmarkierungen anzeigt. |
| CSmartDockingInfo::m_clrBaseBackground | Gibt die Basishintergrundfarbe von smarten Docking-Markern an. |
| CSmartDockingInfo::m_clrToneDest | Gibt die Farbe an, die in smarten Docking-Marker-Bitmaps ersetzt m_clrToneSrc wird. |
| CSmartDockingInfo::m_clrToneSrc | Gibt die Farbe von Bitmaps für intelligente Andockmarkierungen an. |
| CSmartDockingInfo::m_clrTransparent | Gibt die Farbe intelligenter Docking-Marker-Bitmaps an, wenn sie transparent sind. |
| CSmartDockingInfo::m_nCentralGroupOffset | Gibt den Offset der zentralen Gruppe von intelligenten Andockpunkten aus den Grenzen des zentralen Gruppenrechtecks an. |
| CSmartDockingInfo::m_sizeTotal | Gibt die Gesamtgröße aller smarten Andockpunkte in einer Gruppe an. |
| CSmartDockingInfo::m_uiMarkerBmpResID | Definiert die Ressourcen-IDs der Bitmaps, die das Framework für intelligente Andockmarkierungen verwendet, die nicht hervorgehoben sind. |
| CSmartDockingInfo::m_uiMarkerLightBmpResID | Definiert die Ressourcen-IDs der Bitmaps, die das Framework für intelligente Andockmarkierungen verwendet, die hervorgehoben sind. |
Hinweise
Das Framework verarbeitet intelligente Docking-Marker intern. Die folgende Abbildung zeigt die standardmäßigen intelligenten Docking-Marker:
In dieser Abbildung zeigt das Bild auf der linken Seite eine intelligente Docking-Markierung für eine zentrale Gruppe, die nicht an eine Registerkarte angedockt ist. Das Bild in der Mitte zeigt eine intelligente Docking-Markierung am rechten Rand. Das Bild auf der rechten Seite zeigt eine zentrale Gruppe intelligenter Docking-Markierungen, die an eine Registerkarte angedockt haben. Die intelligente Verankerungsmarkierung der zentralen Gruppe weist eine Hauptbitmap und fünf smarte Docking-Marker-Bitmaps auf.
Sie können die folgenden Parameter von intelligenten Docking-Markern anpassen:
Farbe Sie können z. B. die blaue Farbe der Markierungen in der Abbildung durch eine beliebige benutzerdefinierte Farbe ersetzen.
Transparenzfarbe.
Offset einer intelligenten Docking-Markierung in der zentralen Gruppe vom Rand des umgebenden Rechtecks.
Die Hauptbitmap, die die zentrale Gruppe darstellt.
Die Bitmaps, die die regulären und hervorgehobenen smarten Andockmarkierungen darstellen.
Die folgende Abbildung zeigt ein Beispiel für intelligente Andockmarker, die angepasst wurden:
Vererbungshierarchie
Anforderungen
Header: afxDockingManager.h
CSmartDockingInfo::CopyTo
Kopiert die aktuellen Smart-Docking-Parameter in das bereitgestellte CSmartDockingInfo -Objekt.
void CopyTo(CSmartDockingInfo& params);
Parameter
params
[out] Ein Objekt vom Typ CSmartDockingInfo , das mit den aktuellen Smart-Docking-Parametern aufgefüllt wird.
CSmartDockingInfo::m_bUseThemeColorInShading
Gibt an, ob die aktuelle Designfarbe verwendet werden soll, wenn das Framework intelligente Andockmarkierungen anzeigt.
BOOL m_bUseThemeColorInShading;
Hinweise
Wenn WAHR, werden die Markierungen mit der aktuellen Designfarbe gezeichnet. andernfalls werden die Markierungen mit einer hellblauen Farbe gezeichnet.
Der Standardwert ist FALSCH.
CSmartDockingInfo::m_clrBaseBackground
Gibt die Basishintergrundfarbe von smarten Docking-Markern an.
COLORREF m_clrBaseBackground;
CSmartDockingInfo::m_clrToneDest
Gibt die Farbe an, die in smarten Docking-Marker-Bitmaps ersetzt m_clrToneSrc wird.
COLORREF m_clrToneDest;
Hinweise
Legen Sie diesen Wert fest, um die Farbe von Markerbitmaps programmgesteuert zu ändern. Wenn Sie beispielsweise die Farbe der standardmarkierungen ändern möchten, die mit dem Framework bereitgestellt werden, legen Sie diesen Wert auf die gewünschte Farbe fest. Standardmäßig ist CSmartDockingInfo::m_clrToneSrc auf RGB (61, 123, 241) (eine blumige Farbe) festgelegt.
Um die Farbe von benutzerdefinierten Markierungen zu ändern, müssen Sie beide m_clrToneDest und m_clrToneSrc.
CSmartDockingInfo::m_clrToneSrc
Gibt die Farbe von Bitmaps für intelligente Andockmarkierungen an.
COLORREF m_clrToneSrc;
Hinweise
Legen Sie diesen Wert nur fest, wenn Sie die Farbe einer benutzerdefinierten Bitmap durch eine andere Farbe ersetzen möchten. Sie müssen diesen Wert nicht festlegen, wenn Sie die Farbe einer Standardmarkierung (Framework bereitgestellt) ändern.
Wird verwendet (COLORREF)-1 , um ein Mitglied der intelligenten Docking-Gruppe leer zu lassen.
CSmartDockingInfo::m_clrTransparent
Gibt die Farbe intelligenter Docking-Marker-Bitmaps an, wenn sie transparent sind.
COLORREF m_clrTransparent;
Hinweise
Sie müssen diesen Wert festlegen, wenn Sie benutzerdefinierte Markierungen und benutzerdefinierte Bitmaps in der Andockgruppe anzeigen.
CSmartDockingInfo::m_nCentralGroupOffset
Gibt den Offset zwischen der zentralen Gruppe von intelligenten Andockpunkten und den Begrenzungen des zentralen Gruppenrechtecks an.
int m_nCentralGroupOffset;
Hinweise
Geben Sie diesen Wert an, wenn Sie den Standardoffset zwischen benutzerdefinierten Markierungen und den Grenzen der zentralen Gruppe von intelligenten Andockpunkten ändern möchten. Der Standardoffset beträgt 5 Pixel.
CSmartDockingInfo::m_sizeTotal
Gibt die Gesamtgröße eines umgebenden Rechtecks an, das alle intelligenten Docking-Markierungen in der zentralen Gruppe einschließt.
CSize m_sizeTotal;
Hinweise
Legen Sie m_sizeTotal die Größe des umgebenden Rechtecks der zentralen Gruppenmarkierung fest. Sie müssen diesen Wert angeben, wenn Sie benutzerdefinierte Bitmaps für Markierungen verwenden.
CSmartDockingInfo::m_uiMarkerBmpResID
Definiert die Ressourcen-IDs der Bitmaps, die für nicht hervorgehobene benutzerdefinierte Smart-Docking-Marker verwendet werden.
UINT m_uiMarkerBmpResID[AFX_SD_MARKERS_NUM];
Hinweise
Füllen Sie dieses Array mit den Ressourcen-IDs der Bitmaps aus, die die intelligenten Andockmarkierungen darstellen. AFX_SD_MARKERS_NUM ist derzeit als 5 definiert. Sie füllen das Array wie folgt aus:
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
Definiert die Ressourcen-IDs der Bitmaps, die für hervorgehobene benutzerdefinierte intelligente Andockmarkierungen verwendet werden.
UINT m_uiMarkerLightBmpResID[AFX_SD_MARKERS_NUM];
Hinweise
Füllen Sie dieses Array mit den Ressourcen-IDs der Bitmaps aus, die die hervorgehobenen intelligenten Andockmarkierungen darstellen. AFX_SD_MARKERS_NUM ist derzeit als 5 definiert. Sie füllen das Array wie folgt aus:
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;