Listboxitem

A ListBoxItem 는 컨트롤 내에서 ListBox 선택할 수 있는 개별 항목을 나타냅니다. ListBox 컬렉션에 항목을 추가하면 WPF는 ListBoxItem 컨테이너의 각 항목을 자동으로 래핑합니다.

ListBoxItem 컨트롤은 다음을 비롯한 개별 목록 항목에 대한 시각적 및 동작 속성을 제공합니다.

• 선택 동작 - 항목이 사용자 선택에 응답하는 방법을 처리합니다.
• 시각적 상태 - 항목이 마우스로 가리키거나 선택되거나 포커스가 있을 때 모양 변경 내용을 관리합니다.
• 콘텐츠 프레젠테이션 - 해당 특정 항목의 실제 데이터 또는 콘텐츠를 표시합니다.

ListBoxItem을 직접 스타일링하거나 부모 ListBox에서 사용자 지정 ItemContainerStyle을 정의하여 ListBoxItem 컨테이너의 모양과 동작을 사용자 지정할 수 있습니다.

스타일 및 템플릿

기본 ControlTemplate을 변경하여 ListBoxItem 컨트롤에 고유한 모양을 줄 수 있습니다. 자세한 내용은 스타일 및 템플릿이란? 및 컨트롤에 대한 템플릿을 만드는 방법을 참조하세요.

콘텐츠 속성

컨트롤은 ListBoxItemContent 해당 속성을 콘텐츠 속성으로 사용합니다. 이 속성은 각 목록 항목 내에 표시되는 항목을 결정하고 텍스트, 이미지 및 복잡한 UI 요소를 비롯한 다양한 콘텐츠 형식을 지원합니다.

파트

컨트롤은 ListBoxItem 명명된 템플릿 부분을 정의하지 않습니다.

시각적 상태

다음 표에서는 컨트롤의 시각적 상태를 나열합니다 ListBoxItem .

VisualState 이름	VisualStateGroup 이름	Description
정상	CommonStates	컨트롤이 정상 상태입니다.
마우스 오버	CommonStates	마우스가 컨트롤 위에 있습니다.
Disabled	CommonStates	컨트롤을 사용할 수 없습니다.
Focused	FocusStates	컨트롤에 키보드 포커스가 있습니다.
초점이 맞지 않는	FocusStates	컨트롤에 키보드 포커스가 없습니다.
선택됨	선택 상태	컨트롤이 선택되어 있습니다.
SelectedUnfocused	선택 상태	컨트롤이 선택되었지만 키보드 포커스가 없습니다.
선택되지 않음	SelectionStates	컨트롤이 선택되지 않았습니다.
유효하지 않은 포커스	검증 상태	컨트롤에 유효성 검사 오류가 있고 키보드 포커스가 있습니다.
잘못된포커스없음	검증 상태	컨트롤에 유효성 검사 오류가 있지만 키보드 포커스가 없습니다.
유효	검증 상태	컨트롤이 유효하고 유효성 검사 오류가 없습니다.

참고하십시오

• ListBox
• ListBoxItem
• ListBox