Funzione OleMetafilePictFromIconAndLabel (ole2.h)

Articolo
03/05/2024

Crea un metafile in cui viene disegnato l'icona e l'etichetta specificati.

Sintassi

HGLOBAL OleMetafilePictFromIconAndLabel(
  [in] HICON    hIcon,
  [in] LPOLESTR lpszLabel,
  [in] LPOLESTR lpszSourceFile,
  [in] UINT     iIconIndex
);

Parametri

[in] hIcon

Handle all'icona da disegnare nel metafile. Questo parametro può essere NULL. Se hIcon è NULL, questa funzione restituisce NULL senza creare un metafile.

[in] lpszLabel

Etichetta dell'icona. Questo parametro può essere NULL. Se lpszLabel è NULL, il metafile risultante non includerà un'etichetta.

[in] lpszSourceFile

Percorso e nome file del file icona. Questa stringa può essere ottenuta tramite l'interfaccia utente o dal database di registrazione. Questo parametro può essere NULL.

[in] iIconIndex

Percorso dell'icona all'interno del file denominato da lpszSourceFile, espresso come offset in byte dall'inizio del file.

Valore restituito

Handle globale in una struttura METAFILEPICT contenente l'icona e l'etichetta. Il metafile usa la modalità di mapping MM_ANISOTROPIC.

Se si verifica un errore, l'handle restituito è NULL. In questo caso, il chiamante può chiamare GetLastError per ottenere ulteriori informazioni.

Commenti

Questa funzione viene chiamata da OleGetIconOfFile e OleGetIconOfClass.

Se lpszSourceFile non è NULL e iIconIndex non è 0, il nome del file di origine passato in lpszSourceFile e l'indice passato da iIconIndex viene aggiunto al metafile creato come record di commento.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ole2.h
Libreria	Ole32.lib
DLL	Ole32.dll

Vedi anche

OleGetIconOfClass

OleGetIconOfFile

Condividi tramite