CMFCToolBarImages-Klasse

Artikel
10/12/2023

Die Bilder auf einer Symbolleiste. Die CMFCToolBarImages Klasse verwaltet Symbolleistenbilder, die aus Anwendungsressourcen oder aus Dateien geladen wurden. Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der 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	Spiegelt alle Symbolleistenbilder horizontal wieder.
CMFCToolBarImages::MirrorBitmap	Stellt eine Bitmap horizontal wieder.
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

CObject

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 verwaltet, 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 Spiegelbild.

BOOL Mirror();

Rückgabewert

TRUE, wenn die Bilder erfolgreich gespiegelt 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 Spiegelbild.

static BOOL MirrorBitmap(
    HBITMAP& hbmp,
    int cxImage);

Parameter

hbmp
[in, out] Ein Handle zur Bitmap-Spiegelung.

cxImage
[in] Breite des Bilds in Pixeln.

Rückgabewert

TRUE, wenn das Bild erfolgreich gespiegelt wurde; 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

Weitere Informationen

Hierarchiediagramm
Klassen
CObject-Klasse
CMFCToolBar-Klasse
CMFCToolBarButton-Klasse

Freigeben über

CMFCToolBarImages-Klasse

Syntax

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Geschützte Methoden

Datenelemente

Hinweise

Beispiel

Vererbungshierarchie

Anforderungen

CMFCToolBarImages::AdaptColors

Parameter

Hinweise

CMFCToolBarImages::AddIcon

Parameter

Rückgabewert

CMFCToolBarImages::AddImage

Parameter

Rückgabewert

CMFCToolBarImages::CleanUp

Hinweise

CMFCToolBarImages::Clear

CMFCToolBarImages::CMFCToolBarImages

Hinweise

CMFCToolBarImages::CopyImageToClipboard

Parameter

Rückgabewert

Bemerkungen

CMFCToolBarImages::CopyTo

Parameter

Rückgabewert

Bemerkungen

CMFCToolBarImages::CreateFromImageList

Parameter

Rückgabewert

Hinweise

CMFCToolBarImages::CreateRegionFromImage

Parameter

Rückgabewert

Bemerkungen

CMFCToolBarImages::D eleteImage

Parameter

Rückgabewert

CMFCToolBarImages::D raw

Parameter

Rückgabewert

CMFCToolBarImages::D rawEx

Parameter

Rückgabewert

Bemerkungen

CMFCToolBarImages::EnableRTL

Parameter

Hinweise

CMFCToolBarImages::EndDrawImage

Parameter

CMFCToolBarImages::ExtractIcon

Parameter

Rückgabewert

CMFCToolBarImages::FillDitheredRect

Parameter

Hinweise

CMFCToolBarImages::GetAlwaysLight

Rückgabewert

Bemerkungen

CMFCToolBarImages::GetCount

Rückgabewert

CMFCToolBarImages::GetDisabledImageAlpha

Rückgabewert

Hinweise

CMFCToolBarImages::GetFadedImageAlpha

Rückgabewert

Bemerkungen

CMFCToolBarImages::GetImageSize

Parameter

Rückgabewert

Hinweise

CMFCToolBarImages::GetImageWell

Rückgabewert