Udostępnij za pośrednictwem

CListCtrl::SetBkImage

  • Artykuł

Ustawia obraz tła formantu widoku listy.

BOOL SetBkImage(
   LVBKIMAGE* plvbkImage 
);
BOOL SetBkImage(
   HBITMAP hbm,
   BOOL fTile = TRUE,
   int xOffsetPercent = 0,
   int yOffsetPercent = 0
);
BOOL SetBkImage(
   LPTSTR pszUrl,
   BOOL fTile = TRUE,
   int xOffsetPercent = 0,
   int yOffsetPercent = 0 
);

Parametry

  • plvbkImage
    Adres LVBKIMAGE struktury zawierające informacje nowego obrazu tła.

  • hbm
    Dojście do mapy bitowej.

  • pszUrl
    A NULL-zakończony ciąg zawierający adres URL obrazu tła.

  • fTile
    Niezerowa, jeśli obraz jest rozmieszczony sąsiadująco w tle formantu widoku listy; 0 inaczej.

  • xOffsetPercent
    Przesunięcie w pikselach lewej krawędzi obrazu pochodzenia formantu widoku listy.

  • yOffsetPercent
    Przesunięcie w pikselach górnej krawędzi obrazu pochodzenia formantu widoku listy.

Wartość zwracana

Zwraca wartość niezerową, jeśli kończy się pomyślnie lub w przeciwnym razie zero.

Uwagi

[!UWAGA]

Ponieważ CListCtrl::SetBkImage korzysta z funkcji OLE COM, bibliotek OLE musi zostać zainicjowany przed użyciem SetBkImage.Najlepiej zainicjować biblioteki COM podczas inicjowania aplikacji i odinicjowania bibliotek, gdy kończy działanie aplikacji.Odbywa się to automatycznie w MFC aplikacji wykorzystania technologii ActiveX, automatyzacji OLE, OLE łączenie/Embedding lub operacji ODBC/DAO.

Przykład

Zobacz przykład dla CListCtrl::GetBkImage.

Wymagania

Nagłówek: afxcmn.h

Zobacz też

Informacje

Klasa CListCtrl

Wykres hierarchii

CListCtrl::GetBkImage