CMFCToolBarImages-Klasse
Die Bilder auf einer Symbolleiste. Die CMFCToolBarImages Klasse verwaltet Symbolleistenbilder, die aus Anwendungsressourcen oder aus Dateien geladen wurden.
Weitere Details finden Sie im Quellcode im Ordner VC\atlmfc\src\mfc Ihrer Visual Studio-Installation.
Syntax
class CMFCToolBarImages : public CObject
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CMFCToolBarImages::CMFCToolBarImages | Erstellt ein CMFCToolBarImages-Objekt. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CMFCToolBarImages::AdaptColors | |
| CMFCToolBarImages::AddIcon | Fügt der Symbolleistenbilder ein Symbol hinzu. |
| CMFCToolBarImages::AddImage | Fügt der Symbolleistenbilder eine Bitmap hinzu. |
| CMFCToolBarImages::CleanUp | |
| CMFCToolBarImages::Clear | Gibt die Systemressourcen frei, die diesem Objekt zugeordnet wurden. |
| CMFCToolBarImages::ConvertTo32Bits | Konvertiert unterstrichene Bitmaps in 32 bpp-Bilder. |
| CMFCToolBarImages::CopyImageToClipboard | |
| CMFCToolBarImages::CopyTo | |
| CMFCToolBarImages::CreateFromImageList | Initialisiert die Symbolleistenbilder aus einer Bildliste ( CImageList-Klasse). |
| CMFCToolBarImages::CreateRegionFromImage | |
| CMFCToolBarImages::D eleteImage | Löscht das Bild mit einem angegebenen Index aus den Symbolleistenbildern, wenn diese Gruppe von Symbolleistenbildern benutzerdefinierte Bilder enthält. |
| CMFCToolBarImages::D raw | Zeichnet ein einzelnes Symbolleistenbild (Schaltfläche). |
| CMFCToolBarImages::D rawEx | |
| CMFCToolBarImages::EnableRTL | |
| CMFCToolBarImages::EndDrawImage | Gibt Systemressourcen frei, nachdem ein Symbolleistenbild gezeichnet wurde. |
| CMFCToolBarImages::ExtractIcon | Gibt das Symbol zurück, das einen angegebenen Bildindex aus den Symbolleistenbildern enthält. |
| CMFCToolBarImages::FillDitheredRect | Füllt ein Rechteck mithilfe eines Pinsels mit den Hintergrundfarben der Symbolleiste. |
| CMFCToolBarImages::GetAlwaysLight | |
| CMFCToolBarImages::GetBitsPerPixel | Gibt die aktuelle Auflösung unterstrichener Bilder zurück. |
| CMFCToolBarImages::GetCount | Gibt die Anzahl der Bilder auf der Symbolleiste zurück. |
| CMFCToolBarImages::GetDisabledImageAlpha | Gibt den Alphakanalwert zurück, der für deaktivierte Bilder verwendet wird. |
| CMFCToolBarImages::GetFadedImageAlpha | |
| CMFCToolBarImages::GetImageSize | Ruft entweder die Größe der Symbolleistenbilder ab, die im Arbeitsspeicher (Quellgröße) gespeichert sind, oder die Größe der Symbolleistenbilder, die auf dem Bildschirm gezeichnet werden (Zielgröße). |
| CMFCToolBarImages::GetImageWell | Gibt das Handle an die Bitmap zurück, die alle Symbolleistenbilder enthält. |
| CMFCToolBarImages::GetImageWellLight | |
| CMFCToolBarImages::GetLastImageRect | |
| CMFCToolBarImages::GetLightPercentage | |
| CMFCToolBarImages::GetMapTo3DColors | |
| CMFCToolBarImages::GetMask | |
| CMFCToolBarImages::GetResourceOffset | Gibt den Bildindex für eine angegebene Ressourcen-ID zurück. |
| CMFCToolBarImages::GetScale | Gibt das aktuelle Skalierungsverhältnis unterstrichener Bilder zurück. |
| CMFCToolBarImages::GetTransparentColor | |
| CMFCToolBarImages::GrayImages | Graut die Symbolleistenbilder, damit sie deaktiviert aussehen. |
| CMFCToolBarImages::Is32BitTransparencySupported | Bestimmt, ob das Betriebssystem die 32-Bit-Alphamischung unterstützt. |
| CMFCToolBarImages::IsPreMultiplyAutoCheck | |
| CMFCToolBarImages::IsRTL | Bestimmt, ob die Unterstützung von rechts nach links (RTL) aktiviert ist. |
| CMFCToolBarImages::IsReadOnly | Bestimmt, ob die Symbolleistenbilder schreibgeschützt sind. |
| CMFCToolBarImages::IsScaled | Gibt an, ob die unterstrichenen Bilder skaliert werden oder nicht. |
| CMFCToolBarImages::IsUserImagesList | Bestimmt, ob diese Gruppe von Symbolleistenbildern benutzerdefinierte Bilder enthält. |
| CMFCToolBarImages::IsValid | Bestimmt, ob diese Gruppe von Symbolleistenbildern ein gültiges Symbolleistenbild enthält. |
| CMFCToolBarImages::Load | Lädt Symbolleistenbilder aus Systemressourcen oder aus einer Datei. |
| CMFCToolBarImages::LoadStr | |
| CMFCToolBarImages::MapFromSysColor | |
| CMFCToolBarImages::MapTo3dColors | |
| CMFCToolBarImages::MapToSysColor | |
| CMFCToolBarImages::MapToSysColorAlpha | |
| CMFCToolBarImages::Mirror | Horizontal Spiegel alle Symbolleistenbilder. |
| CMFCToolBarImages::MirrorBitmap | Horizontal Spiegel eine Bitmap. |
| CMFCToolBarImages::MirrorBitmapVert | |
| CMFCToolBarImages::MirrorVert | |
| CMFCToolBarImages::OnSysColorChange | |
| CMFCToolBarImages::P repareDrawImage | Weist die Ressourcen zu, die zum Zeichnen eines Symbolleistenbilds in einer angegebenen Größe erforderlich sind. |
| CMFCToolBarImages::Save | Speichert die Symbolleistenbilder in einer Datei, wenn diese Gruppe von Symbolleistenbildern benutzerdefinierte Bilder enthält. |
| CMFCToolBarImages::SetAlwaysLight | |
| CMFCToolBarImages::SetDisabledImageAlpha | Legt den Alphakanalwert fest, der für deaktivierte Bilder verwendet wird. |
| CMFCToolBarImages::SetFadedImageAlpha | |
| CMFCToolBarImages::SetImageSize | Legt die Größe eines Symbolleistenbilds (Quellgröße) fest. |
| CMFCToolBarImages::SetLightPercentage | |
| CMFCToolBarImages::SetMapTo3DColors | |
| CMFCToolBarImages::SetPreMultiplyAutoCheck | |
| CMFCToolBarImages::SetSingleImage | |
| CMFCToolBarImages::SetTransparentColor | Legt die transparente Farbe der Symbolleistenbilder fest. |
| CMFCToolBarImages::SmoothResize | Ändert die Größe unterstrichener Bilder reibungslos. |
| CMFCToolBarImages::UpdateImage | Aktualisiert ein benutzerdefiniertes Symbolleistenbild aus einer Bitmap. |
Geschützte Methoden
| Name | Beschreibung |
|---|---|
| CMFCToolBarImages::P reMultiplyAlpha |
Datenelemente
| Name | Beschreibung |
|---|---|
| CMFCToolBarImages::m_bDisableTrueColorAlpha | TRUE, wenn die Truecolor-Alphamischung (32-Bit-Farbe) deaktiviert ist. |
Hinweise
Die vollständige Bitmap von Symbolleistenbildern, die verwaltet werden, CMFCToolbarImages besteht aus einem oder mehreren kleinen Symbolleistenbildern (Schaltflächen) einer festen Größe.
Beispiel
Im folgenden Beispiel wird das Konfigurieren eines CMFCToolBarImages Objekts mithilfe verschiedener Methoden in der CMFCToolBarImages Klasse veranschaulicht. Das Beispiel zeigt, wie die Größe des Symbolleistenbilds festgelegt, ein Bild geladen und die transparente Farbe des Bilds festgelegt wird. Dieser Codeausschnitt ist Teil des Visual Studio Demo-Beispiels.
CMFCToolBarImages m_Image;
m_Image.SetImageSize(CSize(32, 32));
m_Image.Load(IDR_START);
m_Image.SetTransparentColor(RGB(255, 0, 255));
Vererbungshierarchie
CMFCToolBarImages
Anforderungen
Header: afxtoolbarimages.h
CMFCToolBarImages::AdaptColors
void AdaptColors(
COLORREF clrBase,
COLORREF clrTone);
Parameter
[in] clrBase
[in] clrTone
Hinweise
CMFCToolBarImages::AddIcon
Fügt der Liste der Symbolleistenbilder ein Symbol hinzu.
int AddIcon(
HICON hIcon,
BOOL bAlphaBlend=FALSE);
Parameter
hIcon
[in] Ein Handle zum Hinzufügen des Symbols.
bAlphaBlend
[in] TRUE, wenn dieses Symbol mit Alphamischung verwendet wird; andernfalls FALSE.
Rückgabewert
Der nullbasierte Index des Symbolleistenbilds, das hinzugefügt wurde, wenn die Methode erfolgreich ist; andernfalls -1.
CMFCToolBarImages::AddImage
Fügt der Symbolleistenbilder eine Bitmap hinzu.
int AddImage(
HBITMAP hbmp,
BOOL bSetBitPerPixel=FALSE);
int AddImage(
const CMFCToolBarImages& imageList,
int nIndex);
Parameter
hbmp
[in] Das Handle zur hinzuzufügenden Bitmap.
bSetBitPerPixel
[in] TRUE, wenn das CMFCToolBarImages Objekt die Farbtiefe (Bits pro Pixel) des neuen Bilds verwendet; FALSE, wenn das CMFCToolbarImages Objekt die aktuelle Farbtiefe behält.
Imagelist
[in] Ein Verweis auf ein CMFCToolbarImages Objekt, das das hinzuzufügende Bild enthält.
nIndex
[in] Der Index im Quellobjekt CMFCToolbarImages des hinzuzufügenden Bilds.
Rückgabewert
Die Anzahl der Symbolleistenbilder, die das CMFCToolBarImages Objekt Standard enthält, nachdem die neue Bitmap erfolgreich hinzugefügt wurde; -1, wenn der Vorgang fehlgeschlagen ist.
CMFCToolBarImages::CleanUp
static void __stdcall CleanUp();
Hinweise
CMFCToolBarImages::Clear
Gibt die Systemressourcen frei, die dem CMFCToolbarImages -Objekt zugeordnet sind.
void Clear();
CMFCToolBarImages::CMFCToolBarImages
Erstellt ein CMFCToolBarImages-Objekt.
CMFCToolBarImages();
Hinweise
Erstellt ein CMFCToolBarImages Objekt, initialisiert das Renderingmodul und legt die Bildgröße auf den Standardwert 16 x 15 Pixel fest. Verwenden Sie CMFCToolBarImages::SetImageSize , um die Bildgröße zu ändern, bevor Sie Bilder hinzufügen.
CMFCToolBarImages::CopyImageToClipboard
BOOL CopyImageToClipboard(int iImage);
Parameter
[in] iImage
Rückgabewert
Bemerkungen
CMFCToolBarImages::CopyTo
BOOL CopyTo(CMFCToolBarImages& imageList);
Parameter
[in] Imagelist
Rückgabewert
Bemerkungen
CMFCToolBarImages::CreateFromImageList
Initialisiert die Symbolleistenbilder aus einem CImageList Class -Objekt.
BOOL CreateFromImageList(const CImageList& imageList);
Parameter
Imagelist
[in] Die Bildliste, die als Quelle für Symbolleistenbilder verwendet werden soll.
Rückgabewert
Gibt immer TRUE zurück.
Hinweise
Verwenden Sie diese Funktion, um die Symbolleistenbildliste schnell aus einer externen Bildliste zu initialisieren.
CMFCToolBarImages::CreateRegionFromImage
static HRGN __stdcall CreateRegionFromImage(
HBITMAP bmp,
COLORREF clrTransparent);
Parameter
[in] Bmp
[in] clrTransparent
Rückgabewert
Bemerkungen
CMFCToolBarImages::D eleteImage
Löscht das benutzerdefinierte Bild mit einem angegebenen Index aus den Symbolleistenbildern.
BOOL DeleteImage(int iImage);
Parameter
iImage
[in] Gibt den nullbasierten Index des zu löschenden Bilds an.
Rückgabewert
TRUE, wenn das Bild erfolgreich gelöscht wurde; FALSE, wenn der Bildindex ungültig ist, das CMFCToolbarImages Objekt temporär ist, das CMFCToolbarImages Objekt keine benutzerdefinierten Bilder enthält oder ein anderer Fehler aufgetreten ist.
CMFCToolBarImages::D raw
Zeichnet ein einzelnes Symbolleistenbild.
BOOL Draw(
CDC* pDC,
int x,
int y,
int iImageIndex,
BOOL bHilite=FALSE,
BOOL bDisabled=FALSE,
BOOL bIndeterminate=FALSE,
BOOL bShadow=FALSE,
BOOL bInactive=FALSE,
BYTE alphaSrc=255);
Parameter
pDC
[in] Ein Zeiger auf einen Gerätekontext.
x
[in] Die X-Koordinate der linken Seite des Rechtecks, an der das Bild gezeichnet werden soll.
y
[in] Die Y-Koordinate des oberen Rands des Rechtecks, in dem das Bild gezeichnet werden soll.
iImageIndex
[in] Der nullbasierte Index des anzuzeigenden Bilds.
bHilite
[in] TRUE, wenn das Bild hervorgehoben werden soll; andernfalls FALSE.
bDisabled
[in] TRUE, wenn das Bild im deaktivierten Stil gezeichnet werden soll; andernfalls FALSE.
bIndeterminate
[in] TRUE, wenn das Bild im unbestimmten Zustandsstil gezeichnet werden soll; andernfalls FALSE.
bShadow
[in] TRUE, wenn das Bild mit einem Schlagschatten gezeichnet werden soll; andernfalls FALSE.
bInactive
[in] TRUE, wenn das Bild im inaktiven Zustandsformat gezeichnet werden soll; andernfalls FALSE.
alphaSrc
[in] Der Alphakanalwert (Deckkraft). Der Wert 255 bedeutet, dass das Bild undurchsichtig gezeichnet wird. Ein Wert von 0 bedeutet, dass das Bild transparent gezeichnet wird. Dieser Wert wird nur für 32-Bit-Farbbilder und für Bilder verwendet, die ein Windows Vista-Glasformat angezeigt haben.
Rückgabewert
TRUE, wenn das angegebene Bild erfolgreich angezeigt wurde; FALSE, wenn der Bildindex ungültig war oder ein anderer Fehler aufgetreten ist.
CMFCToolBarImages::D rawEx
BOOL DrawEx(
CDC* pDC,
CRect rect,
int iImageIndex,
ImageAlignHorz horzAlign = ImageAlignHorzLeft,
ImageAlignVert vertAlign = ImageAlignVertTop,
CRect rectSrc = CRect(0, 0, 0, 0),
BYTE alphaSrc = 255);
Parameter
[in] Pdc
[in] Rect
[in] iImageIndex
[in] horzAlign
[in] vertAlign
[in] rectSrc
[in] alphaSrc
Rückgabewert
Bemerkungen
CMFCToolBarImages::EnableRTL
static void __stdcall EnableRTL(BOOL bIsRTL = TRUE);
Parameter
[in] bIsRTL
Hinweise
CMFCToolBarImages::EndDrawImage
Gibt Systemressourcen frei, die CMFCToolBarImages::P repareDrawImage zugewiesen wurden, nachdem Sie ein Symbolleistenbild durch Aufrufen von CMFCToolBarImages::D raw erstellt haben.
void EndDrawImage(CAfxDrawState& ds);
Parameter
Ds
[in] Ein Verweis auf das CAfxDrawState Objekt, das an die PrepareDrawImage Methode übergeben wurde.
CMFCToolBarImages::ExtractIcon
Gibt das Symbol zurück, das einen angegebenen Bildindex aus den Symbolleistenbildern enthält.
HICON ExtractIcon(int nIndex);
Parameter
nIndex
[in] Der nullbasierte Index in der Bildliste, in der das bild, das als Symbol extrahiert werden soll, befindet.
Rückgabewert
Ein Handle für das extrahierte Symbol oder NULL, wenn nIndex außerhalb des Zulässigen liegt.
CMFCToolBarImages::FillDitheredRect
Füllt ein Rechteck mit den Hintergrundfarben der Symbolleiste.
static void FillDitheredRect(
CDC* pDC,
const CRect& rect);
Parameter
pDC
[in] Ein Zeiger auf einen Gerätekontext.
Rect
[in] Die Koordinaten eines Rechtecks, das ausgefüllt werden soll.
Hinweise
Verwenden Sie diese Methode, um ein Rechteck mit einer Farbe zu füllen, die den Mittelwert der Systemfarben COLOR_BTNFACE und COLOR_BTNHIGHLIGHT. Wenn das System 256 oder weniger Farben verwendet, wird das Rechteck stattdessen mit einem gemusterten Muster dieser beiden Farben gefüllt.
CMFCToolBarImages::GetAlwaysLight
BOOL GetAlwaysLight() const;
Rückgabewert
Bemerkungen
CMFCToolBarImages::GetCount
Gibt die Anzahl der Bilder in der Liste der Symbolleistenbilder zurück.
int GetCount() const;
Rückgabewert
Die Anzahl der Bilder im CMFCToolBarImages Objekt.
CMFCToolBarImages::GetDisabledImageAlpha
Gibt den Alphakanalwert (Deckkraft) zurück, der für deaktivierte Bilder verwendet wird.
static BYTE GetDisabledImageAlpha();
Rückgabewert
Der aktuelle Alphakanalwert.
Hinweise
Sie können CMFCToolBarImages::SetDisabledImageAlpha aufrufen, um den Alphakanalwert zu ändern.
CMFCToolBarImages::GetFadedImageAlpha
static BYTE __stdcall GetFadedImageAlpha();
Rückgabewert
Bemerkungen
CMFCToolBarImages::GetImageSize
Ruft entweder die Größe der Symbolleistenbilder ab, die im Arbeitsspeicher (Quellgröße) gespeichert sind, oder die Größe der Symbolleistenbilder, die auf dem Bildschirm gezeichnet werden (Zielgröße).
SIZE GetImageSize(BOOL bDest=FALSE) const;
Parameter
bDest
[in] TRUE, um die Zielgröße abzurufen; FALSE zum Abrufen der Quellbildgröße.
Rückgabewert
Eine SIZE Struktur, die die Größe eines Bilds in Pixel angibt.
Hinweise
Die Größe des Quellbilds ist die Größe der Bilder, die im CMFCToolbarImages-Objekt gespeichert sind. Sie können CMFCToolBarImages::SetImageSize aufrufen, um die Quellgröße festzulegen. Der Standardwert ist 16 x 15 Pixel.
Standardmäßig ist die Zielbildgröße 0x0. Sie geben die Zielgröße an, wenn Sie CMFCToolBarImages::P repareDrawImage aufrufen. Die CMFCToolBarImages::EndDrawImage-Methode setzt die Zielgröße auf den Standardwert zurück.
CMFCToolBarImages::GetImageWell
Gibt das Handle an die Bitmap zurück, die alle Symbolleistenbilder enthält.
HBITMAP GetImageWell() const;
Rückgabewert
Ein Handle zu einer Bitmap, die Symbolleistenbilder enthält.
Hinweise
Die Symbolleistenbilder werden in einer Zeile in einer einzelnen Bitmap gespeichert, die auch als Bild bezeichnet wird. Um ein Symbolleistenbild im Bild gut zu finden, multiplizieren Sie den Index des Bilds mit der Breite der Symbolleistenbilder (siehe CMFCToolBarImages::GetImageSize), um den horizontalen Offset des Bilds innerhalb des Bilds gut abzurufen.
CMFCToolBarImages::GetImageWellLight
HBITMAP GetImageWellLight() const;
Rückgabewert
Bemerkungen
CMFCToolBarImages::GetLastImageRect
CRect GetLastImageRect() const;
Rückgabewert
Bemerkungen
CMFCToolBarImages::GetLightPercentage
int GetLightPercentage() const;
Rückgabewert
Bemerkungen
CMFCToolBarImages::GetMapTo3DColors
BOOL GetMapTo3DColors() const;
Rückgabewert
Bemerkungen
CMFCToolBarImages::GetMask
HBITMAP GetMask(int iImage);
Parameter
[in] iImage
Rückgabewert
Bemerkungen
CMFCToolBarImages::GetResourceOffset
Gibt den Bildindex für eine angegebene Ressourcen-ID zurück.
int GetResourceOffset(UINT uiResId) const;
Parameter
uiResId
[in] Eine Bildressourcen-ID.
Rückgabewert
Ein Bildindex, wenn die Methode erfolgreich war; -1, wenn das Bild mit der angegebenen Ressourcen-ID nicht vorhanden ist.
CMFCToolBarImages::GetTransparentColor
COLORREF GetTransparentColor() const;
Rückgabewert
Bemerkungen
CMFCToolBarImages::GrayImages
Graut die Symbolleistenbilder, damit sie deaktiviert aussehen.
BOOL GrayImages(int nGrayImageLuminancePercentage);
Parameter
nGrayImageLuminancePercentage
[in] Leuchtdichtenprozentsatz.
Rückgabewert
TRUE, wenn Bilder in der Sammlung erfolgreich abgeblentet wurden; andernfalls FALSE.
Hinweise
Mit dieser Methode werden die Symbolleistenbilder geändert, indem sie die roten, grünen und blauen Komponenten jedes Pixels vervielfältigen und das Ergebnis mit nGrayImageLuminancePercentage dividiert durch 100 multiplizieren. Wenn nGrayImageLuminancePercentage null oder negativ ist, wird stattdessen der Standardwert 130 verwendet.
Hinweis
Wenn Sie die Änderung rückgängig machen möchten, müssen Sie die Bilder aus der Quelle neu laden. Dazu können Sie CMFCToolBarImages::Load oder CMFCToolBarImages::UpdateImage (nur für benutzerdefinierte Bilder) aufrufen oder CMFCToolBarImages::Clear aufrufen und die Bilder erneut hinzufügen, indem Sie CMFCToolBarImages::AddIcon oder CMFCToolBarImages::AddImage aufrufen.
CMFCToolBarImages::Is32BitTransparencySupported
Gibt an, ob das Betriebssystem die 32-Bit-Alphamischung unterstützt.
static BOOL Is32BitTransparencySupported();
Rückgabewert
TRUE, wenn die 32-Bit-Alphamischung unterstützt wird; andernfalls FALSE.
Hinweise
Verwenden Sie diese statische Methode, um zur Laufzeit zu ermitteln, ob das Betriebssystem die 32-Bit-Alphamischung unterstützt. Dieses Feature wird unter Windows 2000 und höheren Versionen unterstützt.
CMFCToolBarImages::IsPreMultiplyAutoCheck
BOOL IsPreMultiplyAutoCheck() const;
Rückgabewert
Bemerkungen
CMFCToolBarImages::IsReadOnly
Gibt an, ob die Symbolleistenbilder schreibgeschützt sind.
BOOL IsReadOnly() const;
Rückgabewert
TRUE, wenn die Symbolleistenbilder schreibgeschützt sind, andernfalls FALSE.
Hinweise
Das CMFCToolbarImages Objekt ist schreibgeschützt, wenn die Bitmap mit Symbolleistenbildern aus einer schreibgeschützten Datei geladen wurde oder wenn die Bitmap mit der CMFCToolBarImages::CopyTemp Methode kopiert wurde.
CMFCToolBarImages::IsRTL
Gibt an, ob die Unterstützung von rechts nach links (RTL) aktiviert ist.
static BOOL IsRTL();
Rückgabewert
TRUE, wenn die RTL-Unterstützung aktiviert ist; andernfalls FALSE.
Hinweise
Die RTL-Unterstützung wird verwendet, wenn die Anwendung in eine Sprache lokalisiert wird, die von rechts nach links gelesen wird, z. B. Arabisch, Hebräisch, Perser oder Urdu.
CMFCToolBarImages::IsUserImagesList
Gibt an, ob diese Gruppe von Symbolleistenbildern benutzerdefinierte Bilder enthält.
BOOL IsUserImagesList() const;
Rückgabewert
TRUE, wenn das CMFCToolBarImages Objekt benutzerdefinierte Symbolleistenbilder enthält; andernfalls FALSE.
CMFCToolBarImages::IsValid
Gibt an, ob diese Gruppe von Symbolleistenbildern ein gültiges Symbolleistenbild enthält.
BOOL IsValid() const;
Rückgabewert
TRUE, wenn ein CMFCToolBarImages Objekt gültig ist; andernfalls FALSE.
Hinweise
Das CMFCToolBarImages Objekt ist ungültig, wenn das Handle für eine Bitmap mit Symbolleistenbildern NULL ist.
CMFCToolBarImages::Load
Lädt Symbolleistenbilder aus Systemressourcen oder aus einer Datei.
BOOL Load(
UINT uiResID,
HINSTANCE hinstRes=NULL,
BOOL bAdd=FALSE);
BOOL Load(
LPCTSTR lpszBmpFileName,
DWORD nMaxFileSize = 819200);
Parameter
uiResID
[in] Die ID einer Bitmapressource.
hinstRes
[in] Eine Instanz der Ressourcen-DLL.
bAdd
[in] TRUE, um die geladene Bitmap zur vorhandenen Bitmap hinzuzufügen, oder FALSE, um die vorhandene Bitmap zu ersetzen.
lpszBmpFileName
[in] Ein Pfad zu einer Datenträgerdatei, aus der die Bitmap geladen werden soll.
nMaxFileSize
[in] Maximale Anzahl von Bytes in der Bitmapdatei; oder 0, um die Bitmap unabhängig von der Dateigröße zu laden. Wenn die Größe der Datei diese maximale Größe überschreitet, gibt die Methode FALSE zurück und lädt die Bitmap nicht.
Rückgabewert
TRUE, wenn die Bitmap erfolgreich geladen wurde; andernfalls FALSE.
Hinweise
Wenn die Datei über das schreibgeschützte Attribut verfügt, wird die Bildliste als schreibgeschützt markiert.
CMFCToolBarImages::LoadStr
BOOL LoadStr(
LPCTSTR lpszResourceName,
HINSTANCE hinstRes = NULL,
BOOL bAdd = FALSE);
Parameter
[in] lpszResourceName
[in] hinstRes
[in] bAdd
Rückgabewert
Bemerkungen
CMFCToolBarImages::MapFromSysColor
static COLORREF __stdcall MapFromSysColor(
COLORREF color,
BOOL bUseRGBQUAD = TRUE);
Parameter
[in] Farbe
[in] bUseRGBQUAD
Rückgabewert
Bemerkungen
CMFCToolBarImages::MapTo3dColors
BOOL MapTo3dColors(
BOOL bUseRGBQUAD = TRUE,
COLORREF clrSrc = (COLORREF)-1,
COLORREF clrDest = (COLORREF)-1);
Parameter
[in] bUseRGBQUAD
[in] clrSrc
[in] clrDest
Rückgabewert
Bemerkungen
CMFCToolBarImages::MapToSysColor
static COLORREF __stdcall MapToSysColor(
COLORREF color,
BOOL bUseRGBQUAD = TRUE);
Parameter
[in] Farbe
[in] bUseRGBQUAD
Rückgabewert
Bemerkungen
CMFCToolBarImages::MapToSysColorAlpha
static COLORREF __stdcall MapToSysColorAlpha(COLORREF color);
Parameter
[in] Farbe
Rückgabewert
Bemerkungen
CMFCToolBarImages::Mirror
Ersetzt die Symbolleistenbilder durch das horizontale Spiegel Bild.
BOOL Mirror();
Rückgabewert
TRUE, wenn die Bilder erfolgreich Spiegel wurden; andernfalls FALSE.
Hinweise
Diese Methode wird verwendet, um Schreibsysteme von rechts nach links zu unterstützen.
CMFCToolBarImages::MirrorBitmap
Ersetzt eine Bitmap durch das horizontale Spiegel Bild.
static BOOL MirrorBitmap(
HBITMAP& hbmp,
int cxImage);
Parameter
hbmp
[in, out] Ein Handle für Bitmap zum Spiegel.
cxImage
[in] Breite des Bilds in Pixeln.
Rückgabewert
TRUE, wenn das Bild erfolgreich Spiegel; andernfalls FALSE.
Hinweise
Diese Funktion wird verwendet, um Schreibsysteme von rechts nach links zu unterstützen.
CMFCToolBarImages::MirrorBitmapVert
static BOOL __stdcall MirrorBitmapVert(
HBITMAP& hbmp,
int cyImage);
Parameter
[in] hbmp
[in] cyImage
Rückgabewert
Bemerkungen
CMFCToolBarImages::MirrorVert
BOOL MirrorVert();
Rückgabewert
Bemerkungen
CMFCToolBarImages::OnSysColorChange
void OnSysColorChange();
Hinweise
CMFCToolBarImages::P reMultiplyAlpha
static BOOL __stdcall PreMultiplyAlpha(
HBITMAP hbmp,
BOOL bAutoCheckPremlt);
BOOL PreMultiplyAlpha(HBITMAP hbmp);
Parameter
[in] hbmp
[in] bAutoCheckPremlt
Rückgabewert
Bemerkungen
CMFCToolBarImages::m_bDisableTrueColorAlpha
TRUE, wenn die Truecolor-Alphamischung (32-Bit-Farbe) deaktiviert ist.
static BOOL m_bDisableTrueColorAlpha;
Hinweise
Legen Sie diese Membervariable auf FALSE fest, um truecolor alpha-blending für Symbolleistenbilder zu aktivieren.
Der Standardwert ist TRUE für die Abwärtskompatibilität.
CMFCToolBarImages::P repareDrawImage
Weist die Ressourcen zu, die zum Zeichnen eines Symbolleistenbilds in einer angegebenen Größe erforderlich sind.
BOOL PrepareDrawImage(
CAfxDrawState& ds,
CSize sizeImageDest=CSize(0,
0)
BOOL bFadeInactive=FALSE);
Parameter
Ds
[in] Ein Verweis auf CAfxDrawState die Struktur, in der die zugeordneten Ressourcen zwischen Bildrenderingphasen gespeichert werden.
sizeImageDest
[in] Gibt die Größe eines Zielbilds an.
bFadeInactive
[in] TRUE, wenn inaktive Bilder eingeblendet werden sollen.
Rückgabewert
TRUE, wenn die zum Zeichnen des Symbolleistenbilds erforderlichen Ressourcen erfolgreich zugewiesen wurden, andernfalls FALSE.
Hinweise
Nachdem Sie diese Methode aufgerufen haben, können Sie CMFCToolBarImages::D raw beliebig oft aufrufen. Nachdem Sie die Zeichnung abgeschlossen haben, müssen Sie CMFCToolBarImages::EndDrawImage aufrufen, um die zugeordneten PrepareDrawImageRessourcen freizugeben.
CMFCToolBarImages::Save
Speichert die Symbolleistenbilder in einer Datei, wenn diese Gruppe von Symbolleistenbildern benutzerdefinierte Bilder enthält.
BOOL Save(LPCTSTR lpszBmpFileName=NULL);
Parameter
lpszBmpFileName
Ein Pfad zu einer Datenträgerdatei.
Rückgabewert
TRUE, wenn die Symbolleistenbilder erfolgreich gespeichert wurden; andernfalls FALSE.
Hinweise
Rufen Sie diese Methode auf, um die benutzerdefinierten Bilder in einer Datenträgerdatei zu speichern. Wenn lpszBmpFileName NULL ist, speichert die Methode die Bitmap in der Datei, aus der die Bitmap von der CMFCToolBarImages::Load-Methode geladen wurde.
CMFCToolBarImages::SetAlwaysLight
void SetAlwaysLight(BOOL bAlwaysLight = TRUE);
Parameter
[in] bAlwaysLight
Hinweise
CMFCToolBarImages::SetDisabledImageAlpha
Legt den Alphakanalwert (Deckkraft) fest, der für deaktivierte Bilder verwendet wird.
static void SetDisabledImageAlpha(BYTE nValue);
Parameter
nValue
[in] Der neue Wert des Alphakanals.
Hinweise
Verwenden Sie diese Methode, um einen benutzerdefinierten Alphawert für deaktivierte Bilder festzulegen. Der Standardwert ist 127, was bewirkt, dass deaktivierte Schaltflächenbilder halbtransparent sind. Wenn Sie den Wert 0 festlegen, sind deaktivierte Bilder vollständig transparent. Wenn Sie einen Wert von 255 festlegen, sind deaktivierte Bilder vollständig undurchsichtig.
CMFCToolBarImages::SetFadedImageAlpha
static void __stdcall SetFadedImageAlpha(BYTE nValue);
Parameter
[in] nValue
Hinweise
CMFCToolBarImages::SetImageSize
Legt die Größe jedes Symbolleistenbilds (Quellgröße) fest.
void SetImageSize(
SIZE sizeImage,
BOOL bUpdateCount=FALSE);
Parameter
sizeImage
[in] Die neue Größe von Symbolleistenbildern.
Hinweise
Standardmäßig beträgt die Größe des Symbolleistenbilds 16 x 15 Pixel. Rufen Sie diese Methode auf, wenn Sie Symbolleistenbilder einer anderen Größe verwenden möchten.
CMFCToolBarImages::SetLightPercentage
void SetLightPercentage(int nValue);
Parameter
[in] nValue
Hinweise
CMFCToolBarImages::SetMapTo3DColors
void SetMapTo3DColors(BOOL bMapTo3DColors);
Parameter
[in] bMapTo3DColors
Hinweise
CMFCToolBarImages::SetPreMultiplyAutoCheck
void SetPreMultiplyAutoCheck(BOOL bAuto = TRUE);
Parameter
[in] bAuto
Hinweise
CMFCToolBarImages::SetSingleImage
void SetSingleImage();
Hinweise
CMFCToolBarImages::SetTransparentColor
Legt die transparente Farbe der Symbolleistenbilder fest.
COLORREF SetTransparentColor(COLORREF clrTransparent);
Parameter
clrTransparent
[in] Ein RGB-Wert.
Rückgabewert
Die vorherige transparente Farbe.
Hinweise
Wenn Sie oder das Framework CMFCToolBarImages::D raw aufrufen, zeichnet die Methode kein Pixel, das der durch clrTransparent angegebenen Farbe entspricht.
CMFCToolBarImages::UpdateImage
Aktualisiert ein benutzerdefiniertes Symbolleistenbild aus einer Bitmap.
BOOL UpdateImage(
int iImage,
HBITMAP hbmp);
Parameter
iImage
[in] Der nullbasierte Index des zu aktualisierenden Bilds.
hbmp
[in] Ein Handle für die Bitmap, von der das Bild aktualisiert werden soll.
Rückgabewert
TRUE, wenn das Bild erfolgreich aktualisiert wurde; FALSE, wenn die Bildliste nicht benutzerdefiniert oder temporär ist.
CMFCToolBarImages::ConvertTo32Bits
Konvertiert unterstrichene Bitmaps in 32 bpp-Bilder.
BOOL ConvertTo32Bits(COLORREF clrTransparent = (COLORREF)-1);
Parameter
clrTransparent
Gibt transparente Farbe unterstrichener Bitmaps an.
Hinweise
CMFCToolBarImages::GetBitsPerPixel
Gibt die aktuelle Auflösung unterstrichener Bilder zurück.
int GetBitsPerPixel() const;
Rückgabewert
Ein ganzzahliger Wert, der die aktuelle Auflösung unterstrichener Bilder in Bits pro Pixel (bpp) darstellt.
Hinweise
CMFCToolBarImages::GetScale
Gibt das aktuelle Skalierungsverhältnis unterstrichener Bilder zurück.
double GetScale() const;
Rückgabewert
Ein Wert, der das aktuelle Skalierungsverhältnis darstellt.
Hinweise
CMFCToolBarImages::IsScaled
Gibt an, ob die unterstrichenen Bilder skaliert werden oder nicht.
BOOL IsScaled () const;
Rückgabewert
TRUE, wenn unterstrichene Bilder skaliert werden; andernfalls FALSE.
Hinweise
CMFCToolBarImages::SmoothResize
Ändert die Größe unterstrichener Bilder reibungslos.
BOOL SmoothResize(double dblImageScale);
Parameter
dblImageScale
Skalierungsverhältnis.
Rückgabewert
TRUE, wenn die Größe erfolgreich geändert wird; andernfalls FALSE.
Hinweise
Siehe auch
Hierarchiediagramm
Klassen
CObject-Klasse
CMFCToolBar-Klasse
CMFCToolBarButton-Klasse
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für