Funzione LoadIconWithScaleDown (commctrl.h)

Articolo
11/15/2023

Carica un'icona. Se l'icona non è una dimensione standard, questa funzione ridimensiona un'immagine più grande anziché ridimensionare un'immagine più piccola.

Sintassi

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

Parametri

[in] hinst

Tipo: HINSTANCE

Handle per il modulo di un file DLL o eseguibile (.exe) che contiene l'icona da caricare. Per altre informazioni, vedere GetModuleHandle.

Per caricare un'icona di sistema predefinita o un file di icona autonomo, impostare questo parametro su NULL.

[in] pszName

Tipo: PCWSTR

Puntatore a un buffer Unicode con terminazione Null che contiene informazioni sulla posizione sull'icona da caricare.

Se hinst non è NULL, pszName specifica la risorsa icona in base al nome o all'ordinale. Questo ordinale deve essere pacchetto usando la macro MAKEINTRESOURCE .

Se hinst è NULL, pszName specifica l'identificatore (a partire dal prefisso IDI_) di un'icona di sistema predefinita da caricare.

[in] cx

Tipo: int

Larghezza desiderata, in pixel, dell'icona.

[in] cy

Tipo: int

Altezza desiderata, in pixel, dell'icona.

[out] phico

Tipo: HICON*

Quando questa funzione restituisce, contiene un puntatore all'handle dell'icona caricata.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario, incluso quanto segue:

Codice restituito	Descrizione
E_INVALIDARG	Il contenuto del buffer a cui fa riferimento pszName non rientra nelle interpretazioni previste.

Commenti

Questa funzione cerca prima il file dell'icona per un'icona con le stesse dimensioni. Se non viene trovata una corrispondenza, a meno che sia cx che cy corrispondano a una delle dimensioni dell'icona standard, ovvero 16, 32, 48 o 256 pixel, l'icona più grande successiva è selezionata e quindi è stata selezionata la dimensione desiderata. Ad esempio, se un'icona con una dimensione x di 40 pixel viene richiesta dall'applicazione callign, viene usata l'icona a 48 pixel e ridimensionata fino a 40 pixel. Al contrario, la funzione LoadImage seleziona l'icona a 32 pixel e lo ridimensiona fino a 40 pixel.

Se la funzione non è in grado di individuare un'icona più grande, per impostazione predefinita il comportamento standard di trovare l'icona più piccola successiva e ridimensionarla fino alle dimensioni desiderate.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commctrl.h
Libreria	Comctl32.lib
DLL	Comctl32.dll

Condividi tramite