LoadIcon

Funksjonen LoadIcon laster den angitte ikon ressursen fra den kjørbare filen (.EXE) arkiv forbundet med en programforekomst. Denne funksjonen har blitt erstattet av LoadImage -funksjon

() HICON LoadIcon HINSTANCE  hInstance, / / håndtere til programforekomstenLPCTSTRlpIconName / / ikonnavn streng eller ikonet ressurs / / identifikator);
 

Parametere

hInstance
Håndtere til en forekomst av modulen der kjørbare fil inneholder ikonet skal lastes inn. Denne parameteren må være NULL når et standardikon lastes.
lpIconName
Pekeren til en null-terminert streng som inneholder navnet på ikonet ressursen skal lastes inn. Denne parameteren kan eventuelt inneholde ressursidentifikatoren i signifikante ordet og null i signifikante ordet. Bruke makroen MAKEINTRESOURCE til å opprette denne verdien.

For å bruke en av de forhåndsdefinerte ikonene, kan du definere parameteren hInstance til NULL og lpIconName -parameteren til en av følgende verdier:
Verdi Beskrivelse
IDI_APPLICATION Standard programikon.
IDI_ASTERISK Samme som IDI_INFORMATION.
IDI_ERROR Hånd-formet ikon.
IDI_EXCLAMATION Samme som IDI_WARNING.
IDI_HAND Samme som IDI_ERROR.
IDI_INFORMATION Stjerne-ikonet.
IDI_QUESTION Spørsmålstegnikonet.
IDI_WARNING Utropstegn-ikonet.
IDI_WINLOGO Windows logo-ikon.

Returverdier

Hvis funksjonen lykkes, er returverdien et håndtak til ikonet nylig lastet.

Hvis funksjonen mislykkes, er verdien som returneres NULL. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

LoadIcon laster ikonet ressursen bare hvis det ikke er lastet; Ellers henter det en referanse til den eksisterende ressursen. Funksjonen søker ikonet ressursen for ikonet som er best egnet for det aktive vinduet. Ikonet ressursen kan være en farge eller svart/hvitt-punktgrafikk.

LoadIcon kan bare laste inn et ikon størrelse overholder de SM_CXICON og SM_CYICON systemet metrisk verdiene. Bruke LoadImage -funksjonen til å laste inn ikoner av andre størrelser.

Windows CE: Forhåndsdefinerte ikoner IDI_ LOCK+STJERNE(*) støttes ikke.

Ikonet i Windows CE 1.0, må være en to bits per piksel (.ic2)-ikonet eller en svart-hvitt-ikonet.

Se også

Oversikt over ikoner, ikonet funksjoner, CreateIcon, LoadImage, MAKEINTRESOURCE

Index