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