Korzystanie z ikon

Artykuł
03/16/2025

W poniższych tematach opisano sposób wykonywania określonych zadań związanych z ikonami:

Tworzenie ikony
Pobieranie rozmiaru ikony
wyświetlanie ikony
Udostępnianie zasobów ikon

Tworzenie ikony

Aby użyć ikony, aplikacja musi uzyskać dojście do ikony. W poniższym przykładzie pokazano, jak utworzyć dwa różne uchwyty do ikon: jeden dla standardowej ikony pytania i jeden dla ikony niestandardowej, dołączonej jako zasób w pliku definicji zasobów aplikacji.

HICON hIcon1;   // icon handle 
HICON hIcon2;   // icon handle 
 
// Create a standard question icon. 
 
hIcon1 = LoadIcon(NULL, IDI_QUESTION); 
 
// Create a custom icon based on a resource. 
 
hIcon2 = LoadIcon(hinst, MAKEINTRESOURCE(460)); 
 
// Create a custom icon at run time.

Aplikacja powinna implementować niestandardowe ikony jako zasoby i używać funkcji LoadIcon lub LoadImage, zamiast tworzyć ikony podczas działania. Takie podejście pozwala uniknąć zależności urządzenia, uprościć lokalizację i umożliwić aplikacjom udostępnianie map bitowych ikon. Jednak w poniższym przykładzie użyto CreateIcon do utworzenia niestandardowej ikony monochromatycznej w czasie wykonywania, na podstawie bitowych masek mapy bitowej; został on dołączony, aby zilustrować sposób, w jaki system interpretuje maski bitów mapy bitowej ikony.

HICON hIcon3;      // icon handle 
 
// Yang icon AND bitmask 
 
BYTE ANDmaskIcon[] = {0xFF, 0xFF, 0xFF, 0xFF,   // line 1 
                      0xFF, 0xFF, 0xC3, 0xFF,   // line 2 
                      0xFF, 0xFF, 0x00, 0xFF,   // line 3 
                      0xFF, 0xFE, 0x00, 0x7F,   // line 4 
 
                      0xFF, 0xFC, 0x00, 0x1F,   // line 5 
                      0xFF, 0xF8, 0x00, 0x0F,   // line 6 
                      0xFF, 0xF8, 0x00, 0x0F,   // line 7 
                      0xFF, 0xF0, 0x00, 0x07,   // line 8 
 
                      0xFF, 0xF0, 0x00, 0x03,   // line 9 
                      0xFF, 0xE0, 0x00, 0x03,   // line 10 
                      0xFF, 0xE0, 0x00, 0x01,   // line 11 
                      0xFF, 0xE0, 0x00, 0x01,   // line 12 
 
                      0xFF, 0xF0, 0x00, 0x01,   // line 13 
                      0xFF, 0xF0, 0x00, 0x00,   // line 14 
                      0xFF, 0xF8, 0x00, 0x00,   // line 15 
                      0xFF, 0xFC, 0x00, 0x00,   // line 16 
 
                      0xFF, 0xFF, 0x00, 0x00,   // line 17 
                      0xFF, 0xFF, 0x80, 0x00,   // line 18 
                      0xFF, 0xFF, 0xE0, 0x00,   // line 19 
                      0xFF, 0xFF, 0xE0, 0x01,   // line 20 
 
                      0xFF, 0xFF, 0xF0, 0x01,   // line 21 
                      0xFF, 0xFF, 0xF0, 0x01,   // line 22 
                      0xFF, 0xFF, 0xF0, 0x03,   // line 23 
                      0xFF, 0xFF, 0xE0, 0x03,   // line 24 
 
                      0xFF, 0xFF, 0xE0, 0x07,   // line 25 
                      0xFF, 0xFF, 0xC0, 0x0F,   // line 26 
                      0xFF, 0xFF, 0xC0, 0x0F,   // line 27 
                      0xFF, 0xFF, 0x80, 0x1F,   // line 28 
 
                      0xFF, 0xFF, 0x00, 0x7F,   // line 29 
                      0xFF, 0xFC, 0x00, 0xFF,   // line 30 
                      0xFF, 0xF8, 0x03, 0xFF,   // line 31 
                      0xFF, 0xFC, 0x3F, 0xFF};  // line 32 
 
// Yang icon XOR bitmask 
 
BYTE XORmaskIcon[] = {0x00, 0x00, 0x00, 0x00,   // line 1 
                      0x00, 0x00, 0x00, 0x00,   // line 2 
                      0x00, 0x00, 0x00, 0x00,   // line 3 
                      0x00, 0x00, 0x00, 0x00,   // line 4 
 
                      0x00, 0x00, 0x00, 0x00,   // line 5 
                      0x00, 0x00, 0x00, 0x00,   // line 6 
                      0x00, 0x00, 0x00, 0x00,   // line 7 
                      0x00, 0x00, 0x38, 0x00,   // line 8 
 
                      0x00, 0x00, 0x7C, 0x00,   // line 9 
                      0x00, 0x00, 0x7C, 0x00,   // line 10 
                      0x00, 0x00, 0x7C, 0x00,   // line 11 
                      0x00, 0x00, 0x38, 0x00,   // line 12 
 
                      0x00, 0x00, 0x00, 0x00,   // line 13 
                      0x00, 0x00, 0x00, 0x00,   // line 14 
                      0x00, 0x00, 0x00, 0x00,   // line 15 
                      0x00, 0x00, 0x00, 0x00,   // line 16 
 
                      0x00, 0x00, 0x00, 0x00,   // line 17 
                      0x00, 0x00, 0x00, 0x00,   // line 18 
                      0x00, 0x00, 0x00, 0x00,   // line 19 
                      0x00, 0x00, 0x00, 0x00,   // line 20 
 
                      0x00, 0x00, 0x00, 0x00,   // line 21 
                      0x00, 0x00, 0x00, 0x00,   // line 22 
                      0x00, 0x00, 0x00, 0x00,   // line 23 
                      0x00, 0x00, 0x00, 0x00,   // line 24 
 
                      0x00, 0x00, 0x00, 0x00,   // line 25 
                      0x00, 0x00, 0x00, 0x00,   // line 26 
                      0x00, 0x00, 0x00, 0x00,   // line 27 
                      0x00, 0x00, 0x00, 0x00,   // line 28 
 
                      0x00, 0x00, 0x00, 0x00,   // line 29 
                      0x00, 0x00, 0x00, 0x00,   // line 30 
                      0x00, 0x00, 0x00, 0x00,   // line 31 
                      0x00, 0x00, 0x00, 0x00};  // line 32 
 
hIcon3 = CreateIcon(hinst,    // application instance  
             32,              // icon width 
             32,              // icon height 
             1,               // number of XOR planes 
             1,               // number of bits per pixel 
             ANDmaskIcon,     // AND bitmask  
             XORmaskIcon);    // XOR bitmask

Aby utworzyć ikonę, CreateIcon stosuje następującą tabelę prawdy do masek bitów AND i XOR.

Maska bitowa AND	Maska bitów XOR	Wyświetlacz
0	0	Czarny
0	1	Biały
1	0	Ekran
1	1	Odwrócony ekran

Aby utworzyć kolorową ikonę w czasie wykonywania, należy użyć funkcji CreateIconIndirect, która tworzy ikonę opartą na zawartości struktury ICONINFO.

Przed zamknięciem aplikacja musi użyć DestroyIcon, aby zniszczyć dowolną utworzoną ikonę przy użyciu CreateIcon lub CreateIconIndirect. Nie jest konieczne zniszczenie ikon utworzonych przez inne funkcje.

Pobieranie rozmiaru ikony

Oto przykładowy kod pokazujący, jak uzyskać rozmiar ikony z uchwytu HICON.

// Also works for cursors
BOOL GetIconDimensions(__in HICON hico, __out SIZE *psiz)
{
  ICONINFO ii;
  BOOL fResult = GetIconInfo(hico, &ii);
  if (fResult) {
    BITMAP bm;
    fResult = GetObject(ii.hbmMask, sizeof(bm), &bm) == sizeof(bm);
    if (fResult) {
      psiz->cx = bm.bmWidth;
      psiz->cy = ii.hbmColor ? bm.bmHeight : bm.bmHeight / 2;
    }
    if (ii.hbmMask)  DeleteObject(ii.hbmMask);
    if (ii.hbmColor) DeleteObject(ii.hbmColor);
  }
  return fResult;
}

Wyświetlanie ikony

Aplikacja może ładować i tworzyć ikony do wyświetlania w obszarze klienta aplikacji lub oknach podrzędnych. W poniższym przykładzie pokazano, jak narysować ikonę w obszarze klienta okna, którego kontekst urządzenia (DC) jest identyfikowany przez parametr hdc.

HICON hIcon1;   // icon handle  
HDC hdc;        // handle to display context 
 
DrawIcon(hdc, 10, 20, hIcon1);

System automatycznie wyświetla ikony klas dla okna. Aplikacja może przypisywać ikony klas podczas rejestrowania klasy okna. Aplikacja może zastąpić ikonę klasy przy użyciu funkcji SetClassLong. Ta funkcja zmienia domyślne ustawienia okna dla wszystkich okien danej klasy. Poniższy przykład zastępuje ikonę klasy ikoną, której identyfikator zasobu to 480.

HINSTANCE hinst;            // handle to current instance 
HWND hwnd;                  // main window handle  
 
// Change the icon for hwnd's window class. 
 
SetClassLongPtr(hwnd,          // window handle 
    GCLP_HICON,              // changes icon 
    (LONG_PTR) LoadIcon(hinst, MAKEINTRESOURCE(480))
   );

Aby uzyskać więcej informacji na temat klas okien, zobacz Klasy okien.

Poniższy kod używa funkcji CreateIconFromResourceEx, DrawIconi LookupIconIdFromDirectoryExi kilku funkcji zasobów, aby utworzyć uchwyt ikony na podstawie danych ikon z innego pliku wykonywalnego. Następnie wyświetla ikonę w oknie.

Ostrzeżenie o zabezpieczeniach: Użycie LoadLibrary niepoprawnie może naruszyć bezpieczeństwo aplikacji przez załadowanie nieprawidłowej biblioteki DLL. Zapoznaj się z dokumentacją LoadLibrary, aby uzyskać informacje na temat prawidłowego ładowania bibliotek DLL z różnymi wersjami systemu Windows.

HICON hIcon1;       // icon handle 
HINSTANCE hExe;     // handle to loaded .EXE file 
HRSRC hResource;    // handle to FindResource  
HRSRC hMem;         // handle to LoadResource 
BYTE *lpResource;   // pointer to resource data  
int nID;            // ID of resource that best fits current screen 
 
HDC hdc;        // handle to display context 
 
// Load the file from which to copy the icon. 
// Note: LoadLibrary should have a fully explicit path.
//
hExe = LoadLibrary("myapp.exe");
if (hExe == NULL)
{
    //Error loading module -- fail as securely as possible
    return;
}
 
 
// Find the icon directory whose identifier is 440. 
 
hResource = FindResource(hExe, 
    MAKEINTRESOURCE(440), 
    RT_GROUP_ICON); 
 
// Load and lock the icon directory. 
 
hMem = LoadResource(hExe, hResource); 
 
lpResource = LockResource(hMem); 
 
// Get the identifier of the icon that is most appropriate 
// for the video display. 
 
nID = LookupIconIdFromDirectoryEx((PBYTE) lpResource, TRUE, 
    CXICON, CYICON, LR_DEFAULTCOLOR); 
 
// Find the bits for the nID icon. 
 
hResource = FindResource(hExe, 
    MAKEINTRESOURCE(nID), 
    MAKEINTRESOURCE(RT_ICON)); 
 
// Load and lock the icon. 
 
hMem = LoadResource(hExe, hResource); 
 
lpResource = LockResource(hMem); 
 
// Create a handle to the icon. 
 
hIcon1 = CreateIconFromResourceEx((PBYTE) lpResource, 
    SizeofResource(hExe, hResource), TRUE, 0x00030000, 
    CXICON, CYICON, LR_DEFAULTCOLOR); 
 
// Draw the icon in the client area. 
 
DrawIcon(hdc, 10, 20, hIcon1);

Udostępnij za pośrednictwem

Korzystanie z ikon

Tworzenie ikony

Pobieranie rozmiaru ikony

Wyświetlanie ikony

Opinia

Dodatkowe zasoby

Udostępnij za pośrednictwem

Korzystanie z ikon

Tworzenie ikony

Pobieranie rozmiaru ikony

Wyświetlanie ikony

Udostępnianie zasobów ikon

Opinia

Dodatkowe zasoby