Home Library Learn Samples Downloads Support Community Forums
MSDN Library
Development Tools and Languages
Visual Studio 2012
Visual C++
MFC and ATL
MFC Desktop Applications
Classes
CListCtrl Class
CListCtrl::ApproximateViewRect
CListCtrl::Arrange
CListCtrl::CancelEditLabel
CListCtrl::CListCtrl
CListCtrl::Create
CListCtrl::CreateEx
CListCtrl::CreateDragImage
CListCtrl::DeleteAllItems
CListCtrl::DeleteColumn
CListCtrl::DeleteItem
CListCtrl::DrawItem
CListCtrl::EditLabel
CListCtrl::EnableGroupView
CListCtrl::EnsureVisible
CListCtrl::FindItem
CListCtrl::GetBkColor
CListCtrl::GetBkImage
CListCtrl::GetCallbackMask
CListCtrl::GetCheck
CListCtrl::GetColumn
CListCtrl::GetColumnOrderArray
CListCtrl::GetColumnWidth
CListCtrl::GetCountPerPage
CListCtrl::GetEditControl
CListCtrl::GetEmptyText
CListCtrl::GetExtendedStyle
CListCtrl::GetFirstSelectedItemPosition
CListCtrl::GetFocusedGroup
CListCtrl::GetGroupCount
CListCtrl::GetGroupInfo
CListCtrl::GetGroupInfoByIndex
CListCtrl::GetGroupMetrics
CListCtrl::GetGroupRect
CListCtrl::GetGroupState
CListCtrl::GetHeaderCtrl
CListCtrl::GetHotCursor
CListCtrl::GetHotItem
CListCtrl::GetHoverTime
CListCtrl::GetImageList
CListCtrl::GetInsertMark
CListCtrl::GetInsertMarkColor
CListCtrl::GetInsertMarkRect
CListCtrl::GetItem
CListCtrl::GetItemCount
CListCtrl::GetItemData
CListCtrl::GetItemIndexRect
CListCtrl::GetItemPosition
CListCtrl::GetItemRect
CListCtrl::GetItemSpacing
CListCtrl::GetItemState
CListCtrl::GetItemText
CListCtrl::GetNextItem
CListCtrl::GetNextItemIndex
CListCtrl::GetNextSelectedItem
CListCtrl::GetNumberOfWorkAreas
CListCtrl::GetOutlineColor
CListCtrl::GetOrigin
CListCtrl::GetSelectedColumn
CListCtrl::GetSelectedCount
CListCtrl::GetSelectionMark
CListCtrl::GetStringWidth
CListCtrl::GetSubItemRect
CListCtrl::GetTextBkColor
CListCtrl::GetTextColor
CListCtrl::GetTileInfo
CListCtrl::GetTileViewInfo
CListCtrl::GetToolTips
CListCtrl::GetTopIndex
CListCtrl::GetView
CListCtrl::GetViewRect
CListCtrl::GetWorkAreas
CListCtrl::HasGroup
CListCtrl::HitTest
CListCtrl::InsertColumn
CListCtrl::InsertGroup
CListCtrl::InsertGroupSorted
CListCtrl::InsertItem
CListCtrl::InsertMarkHitTest
CListCtrl::IsGroupViewEnabled
CListCtrl::IsItemVisible
CListCtrl::MapIDToIndex
CListCtrl::MapIndexToID
CListCtrl::MoveGroup
CListCtrl::MoveItemToGroup
CListCtrl::RedrawItems
CListCtrl::RemoveAllGroups
CListCtrl::RemoveGroup
CListCtrl::Scroll
CListCtrl::SetBkColor
CListCtrl::SetBkImage
CListCtrl::SetCallbackMask
CListCtrl::SetCheck
CListCtrl::SetColumn
CListCtrl::SetColumnOrderArray
CListCtrl::SetColumnWidth
CListCtrl::SetExtendedStyle
CListCtrl::SetGroupInfo
CListCtrl::SetGroupMetrics
CListCtrl::SetHotCursor
CListCtrl::SetHotItem
CListCtrl::SetHoverTime
CListCtrl::SetIconSpacing
CListCtrl::SetImageList
CListCtrl::SetInfoTip
CListCtrl::SetInsertMark
CListCtrl::SetInsertMarkColor
CListCtrl::SetItem
CListCtrl::SetItemCount
CListCtrl::SetItemCountEx
CListCtrl::SetItemData
CListCtrl::SetItemIndexState
CListCtrl::SetItemPosition
CListCtrl::SetItemState
CListCtrl::SetItemText
CListCtrl::SetOutlineColor
CListCtrl::SetSelectedColumn
CListCtrl::SetSelectionMark
CListCtrl::SetTextBkColor
CListCtrl::SetTextColor
CListCtrl::SetTileInfo
CListCtrl::SetTileViewInfo
CListCtrl::SetToolTips
CListCtrl::SetView
CListCtrl::SetWorkAreas
CListCtrl::SortGroups
CListCtrl::SortItems
CListCtrl::SortItemsEx
CListCtrl::SubItemHitTest
CListCtrl::Update
Expand Minimize
This topic has not yet been rated - Rate this topic

CListCtrl::SetBkImage

Visual Studio 2012

Sets the background image of a list view control.

Copy 
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  
);
plvbkImage

Address of an LVBKIMAGE structure, containing the new background image information.

hbm

Handle to a bitmap.

pszUrl

A NULL-terminated string that contains the URL of the background image.

fTile

Nonzero if the image is to be tiled in the background of the list view control; otherwise 0.

xOffsetPercent

The offset, in pixels, of the image's left edge, from origin of the list view control.

yOffsetPercent

The offset, in pixels, of the image's top edge, from origin of the list view control.

Returns nonzero if successful, or zero otherwise.

Note Note

Because CListCtrl::SetBkImage makes use of OLE COM functionality, the OLE libraries must be initialized before using SetBkImage. It is best to initialize the COM libraries when the application is initialized and uninitialize the libraries when the application terminates. This is automatically done in MFC applications that make use of ActiveX technology, OLE Automation, OLE Linking/Embedding, or ODBC/DAO operations.

See the example for CListCtrl::GetBkImage.

Header: afxcmn.h

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.