LoadIconWithScaleDown-Funktion (commctrl.h)

Artikel
06/21/2023

Lädt ein Symbol. Wenn das Symbol keine Standardgröße hat, skaliert diese Funktion ein größeres Bild, anstatt ein kleineres Bild hochzuskalieren.

Syntax

HRESULT LoadIconWithScaleDown(
  [in]  HINSTANCE hinst,
  [in]  PCWSTR    pszName,
  [in]  int       cx,
  [in]  int       cy,
  [out] HICON     *phico
);

Parameter

[in] hinst

Typ: HINSTANCE

Ein Handle für das Modul einer DLL- oder ausführbaren Datei (.exe), die das zu ladende Symbol enthält. Weitere Informationen finden Sie unter GetModuleHandle.

Um ein vordefiniertes Systemsymbol oder eine eigenständige Symboldatei zu laden, legen Sie diesen Parameter auf NULL fest.

[in] pszName

Typ: PCWSTR

Ein Zeiger auf einen Unicode-Puffer mit NULL-Beendigung, der Standortinformationen zum zu ladenden Symbol enthält.

Wenn hinst nicht NULL ist, gibt pszName die Symbolressource entweder anhand des Namens oder der Ordnungszahl an. Diese Ordnungszahl muss mithilfe des MAKEINTRESOURCE-Makros verpackt werden.

Wenn hinstNULL ist, gibt pszName den Bezeichner (beginnend mit dem IDI_ Präfix) eines vordefinierten Systemsymbols an, das geladen werden soll.

[in] cx

Typ: int

Die gewünschte Breite des Symbols in Pixel.

[in] cy

Typ: int

Die gewünschte Höhe des Symbols in Pixel.

[out] phico

Typ: HICON*

Wenn diese Funktion zurückgibt, enthält einen Zeiger auf das Handle des geladenen Symbols.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück, einschließlich der folgenden:

Rückgabecode	Beschreibung
E_INVALIDARG	Der Inhalt des Puffers, auf den pszName verweist, passt nicht zu den erwarteten Interpretationen.

Hinweise

Diese Funktion durchsucht zunächst die Symboldatei nach einem Symbol mit exakt derselben Größe. Wenn keine Übereinstimmung gefunden wird, wird das nächstgrößerte Symbol ausgewählt und dann auf die gewünschte Größe herunterskaliert, sofern cx und cy nicht mit einer der Standardsymbolgrößen übereinstimmen – 16, 32, 48 oder 256 Pixel. Wenn beispielsweise ein Symbol mit einer x-Dimension von 40 Pixel von der callign-Anwendung angefordert wird, wird das 48-Pixel-Symbol verwendet und auf 40 Pixel herunterskaliert. Im Gegensatz dazu wählt die LoadImage-Funktion das 32-Pixel-Symbol aus und skaliert es auf 40 Pixel.

Wenn die Funktion kein größeres Symbol finden kann, wird standardmäßig das Standardverhalten verwendet, bei dem das nächstkleinste Symbol gesucht und auf die gewünschte Größe skaliert wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commctrl.h
Bibliothek	Comctl32.lib
DLL	Comctl32.dll

Freigeben über