TaskbarItemInfo 클래스
작업 표시줄 축소판 그림이 표시되는 방법에 대한 정보를 나타냅니다.
상속 계층 구조
System.Object
System.Windows.Threading.DispatcherObject
System.Windows.DependencyObject
System.Windows.Freezable
Microsoft.Windows.Shell.TaskbarItemInfo
네임스페이스: Microsoft.Windows.Shell
어셈블리: Microsoft.Windows.Shell(Microsoft.Windows.Shell.dll)
구문
‘선언
Public NotInheritable Class TaskbarItemInfo _
Inherits Freezable
public sealed class TaskbarItemInfo : Freezable
public ref class TaskbarItemInfo sealed : public Freezable
[<Sealed>]
type TaskbarItemInfo =
class
inherit Freezable
end
public final class TaskbarItemInfo extends Freezable
TaskbarItemInfo 형식에서는 다음과 같은 멤버를 노출합니다.
생성자
| 이름 | 설명 | |
|---|---|---|
.gif "Public 메서드") |
TaskbarItemInfo | TaskbarItemInfo 클래스의 새 인스턴스를 초기화합니다. |
위쪽
속성
| 이름 | 설명 | |
|---|---|---|
.gif "Public 속성") |
CanFreeze | 개체를 수정할 수 없게 만들 수 있는지 여부를 나타내는 값을 가져옵니다. (Freezable에서 상속됨) |
|
DependencyObjectType | 이 인스턴스의 CLR 형식을 래핑하는 DependencyObjectType을 가져옵니다. (DependencyObject에서 상속됨) |
|
Description | 작업 표시줄 항목 도구 설명에 대한 텍스트를 가져오거나 설정합니다. |
|
Dispatcher | 이 DispatcherObject와 연결된 Dispatcher를 가져옵니다. (DispatcherObject에서 상속됨) |
|
IsFrozen | 개체를 현재 수정할 수 있는지 여부를 나타내는 값을 가져옵니다. (Freezable에서 상속됨) |
|
IsSealed | 이 인스턴스가 현재 봉인되어 있는지(읽기 전용인지) 여부를 나타내는 값을 가져옵니다. (DependencyObject에서 상속됨) |
|
Overlay | 작업 표시줄 단추의 프로그램 아이콘에 표시되는 이미지를 가져오거나 설정합니다. |
|
ProgressState | 작업 표시줄 단추에 진행률 표시기가 표시되는 방법을 나타내는 값을 가져오거나 설정합니다. |
|
ProgressValue | 작업 표시줄 단추에 진행률 표시기의 진행 정도를 나타내는 값을 가져오거나 설정합니다. |
|
ThumbButtonInfos | Window 에 연결된 ThumbButtonInfo 개체의 컬렉션을 가져오거나 설정합니다. |
|
ThumbnailClipMargin | 작업 표시줄 축소판 그림에 표시되는 응용 프로그램 창 클라이언트 영역의 일부를 지정하는 값을 가져오거나 설정합니다. |
위쪽
연결된 속성
| 이름 | 설명 | |
|---|---|---|
|
TaskbarItemInfo | 창에 연결된 TaskbarItemInfo를 가져오거나 설정합니다. |
위쪽
메서드
| 이름 | 설명 | |
|---|---|---|
|
CheckAccess | 호출 스레드가 이 DispatcherObject에 액세스할 수 있는지 여부를 확인합니다. (DispatcherObject에서 상속됨) |
|
ClearValue(DependencyProperty) | 속성의 로컬 값을 지웁니다.지울 속성은 DependencyProperty 식별자로 지정됩니다. (DependencyObject에서 상속됨) |
|
ClearValue(DependencyPropertyKey) | 읽기 전용 속성의 로컬 값을 지웁니다.지울 속성은 DependencyPropertyKey에서 지정됩니다. (DependencyObject에서 상속됨) |
|
Clone | 개체 값의 전체 복사본을 만들어 Freezable의 수정 가능한 복제본을 만듭니다.개체의 종속성 속성을 복사할 때 이 메서드는 식을 복사하지만 애니메이션 또는 현재 값은 복사하지 않습니다. 이러한 식이 더 이상 확인되지 않을 수도 있습니다. (Freezable에서 상속됨) |
.gif "Protected 메서드") |
CloneCore | 애니메이션이 적용되지 않은 기준 속성 값을 사용하여 인스턴스를 지정된 Freezable의 복제본(전체 복사본)으로 만듭니다. (Freezable에서 상속됨) |
|
CloneCurrentValue | 현재 값을 사용하여 Freezable의 수정 가능한 복제본(전체 복사본)을 만듭니다. (Freezable에서 상속됨) |
|
CloneCurrentValueCore | 현재 속성 값을 사용하여 인스턴스를 지정된 Freezable의 수정 가능한 복제본(전체 복사본)으로 만듭니다. (Freezable에서 상속됨) |
|
CoerceValue | 지정된 종속성 속성 값을 강제 변환합니다.이 작업은 호출하는 DependencyObject에 있는 종속성 속성의 속성 메타데이터에 지정되어 있는 CoerceValueCallback 함수를 호출하여 수행합니다. (DependencyObject에서 상속됨) |
|
CreateInstance | Freezable 클래스의 새 인스턴스를 초기화합니다. (Freezable에서 상속됨) |
|
CreateInstanceCore | 파생 클래스에서 구현되는 경우 Freezable 파생 클래스의 새 인스턴스를 만듭니다. (Freezable에서 상속됨) |
|
Equals | 제공된 DependencyObject가 현재 DependencyObject에 해당하는지 여부를 확인합니다. (DependencyObject에서 상속됨) |
|
Finalize | 가비지 수집에서 회수하기 전에 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨) |
|
Freeze | 현재 개체를 수정할 수 없게 만들고 IsFrozen 속성을 true로 설정합니다. (Freezable에서 상속됨) |
|
FreezeCore | Freezable 을 수정할 수 없게 만들거나, 수정할 수 없게 만들 수 있는지 테스트합니다. (Freezable에서 상속됨) |
|
GetAsFrozen | 애니메이션이 적용되지 않은 기준 속성 값을 사용하여 Freezable의 고정된 복사본을 만듭니다.복사본이 고정되므로 고정된 하위 개체는 모두 참조를 통해 복사됩니다. (Freezable에서 상속됨) |
|
GetAsFrozenCore | 애니메이션이 적용되지 않은 기준 속성 값을 사용하여 인스턴스를 지정된 Freezable의 고정된 복제본으로 만듭니다. (Freezable에서 상속됨) |
|
GetCurrentValueAsFrozen | 현재 속성 값을 사용하여 Freezable의 고정된 복사본을 만듭니다.복사본이 고정되므로 고정된 하위 개체는 모두 참조를 통해 복사됩니다. (Freezable에서 상속됨) |
|
GetCurrentValueAsFrozenCore | 현재 인스턴스를 지정된 Freezable의 고정된 복제본으로 만듭니다.개체에 애니메이션이 적용된 종속성 속성이 있으면 애니메이션이 적용된 현재 값이 복사됩니다. (Freezable에서 상속됨) |
|
GetHashCode | 이 DependencyObject의 해시 코드를 가져옵니다. (DependencyObject에서 상속됨) |
|
GetLocalValueEnumerator | 이 DependencyObject에 대해 로컬로 값을 설정한 종속성 속성을 확인하기 위한 특수 열거자를 만듭니다. (DependencyObject에서 상속됨) |
.gif "정적 멤버") |
GetTaskbarItemInfo | 개체의 TaskbarItemInfo 연결된 속성 값을 가져옵니다. |
|
GetType | 현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨) |
|
GetValue | 이 DependencyObject 인스턴스에서 종속성 속성의 현재 유효 값을 반환합니다. (DependencyObject에서 상속됨) |
|
InvalidateProperty | 지정된 종속성 속성의 유효 값을 다시 계산합니다. (DependencyObject에서 상속됨) |
|
MemberwiseClone | 현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨) |
|
OnChanged | 현재 Freezable 개체가 수정될 때 호출됩니다. (Freezable에서 상속됨) |
|
OnFreezablePropertyChanged(DependencyObject, DependencyObject) | 방금 설정된 DependencyObjectType 데이터 멤버에 대한 적절한 컨텍스트 포인터를 설정합니다. (Freezable에서 상속됨) |
|
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) | 이 멤버는 Windows Presentation Foundation (WPF) 인프라를 지원하며 사용자 코드에서 직접 사용할 수 없습니다. (Freezable에서 상속됨) |
|
OnPropertyChanged | OnPropertyChanged 의 DependencyObject 구현을 재정의하면 Freezable 형식의 종속성 속성이 변경될 때 Changed 처리기를 함께 호출할 수 있습니다. (Freezable에서 상속됨) |
|
ReadLocalValue | 종속성 속성의 로컬 값(있는 경우)을 반환합니다. (DependencyObject에서 상속됨) |
|
ReadPreamble | 유효한 스레드에서 Freezable에 액세스하고 있는지 확인합니다.Freezable 상속자는 종속성 속성이 아닌 데이터 멤버를 읽는 API의 시작 부분에서 이 메서드를 호출해야 합니다. (Freezable에서 상속됨) |
|
SetTaskbarItemInfo | 개체의 TaskbarItemInfo 연결된 속성 값을 설정합니다. |
|
SetValue(DependencyProperty, Object) | 해당 종속성 속성 식별자로 지정되는 종속성 속성의 로컬 값을 설정합니다. (DependencyObject에서 상속됨) |
|
SetValue(DependencyPropertyKey, Object) | 종속성 속성의 DependencyPropertyKey 식별자로 지정되는 읽기 전용 종속성 속성의 로컬 값을 설정합니다. (DependencyObject에서 상속됨) |
|
ShouldSerializeProperty | serialization 프로세스를 통해 제공된 종속성 속성의 값을 serialize해야 하는지 여부를 나타내는 값을 반환합니다. (DependencyObject에서 상속됨) |
|
ToString | 현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨) |
|
VerifyAccess | 호출 스레드에서 이 DispatcherObject에 액세스할 수 있는지 확인합니다. (DispatcherObject에서 상속됨) |
|
WritePostscript | Freezable 에 대한 Changed 이벤트를 발생시키고 OnChanged 메서드를 호출합니다.Freezable에서 파생되는 클래스는 종속성 속성으로 저장되지 않는 클래스 멤버를 수정하는 모든 API의 끝 부분에서 이 메서드를 호출해야 합니다. (Freezable에서 상속됨) |
|
WritePreamble | Freezable 이 고정되어 있지 않고 유효한 스레드 컨텍스트에서 액세스되고 있는지 확인합니다.Freezable 상속자는 종속성 속성이 아닌 데이터 멤버에 쓰는 API의 시작 부분에서 이 메서드를 호출해야 합니다. (Freezable에서 상속됨) |
위쪽
이벤트
| 이름 | 설명 | |
|---|---|---|
.gif "Public 이벤트") |
Changed | Freezable 또는 여기에 들어 있는 개체가 수정될 때 발생합니다. (Freezable에서 상속됨) |
위쪽
필드
| 이름 | 설명 | |
|---|---|---|
.gif "Public 필드") |
DescriptionProperty | Description 종속성 속성을 식별합니다. |
|
OverlayProperty | Overlay 종속성 속성을 식별합니다. |
|
ProgressStateProperty | ProgressState 종속성 속성을 식별합니다. |
|
ProgressValueProperty | ProgressValue 종속성 속성을 식별합니다. |
|
TaskbarItemInfoProperty | TaskbarItemInfo 종속성 속성을 식별합니다. |
|
ThumbButtonInfosProperty | ThumbButtonInfos 종속성 속성을 식별합니다. |
|
ThumbnailClipMarginProperty | ThumbnailClipMargin 종속성 속성을 식별합니다. |
위쪽
설명
TaskbarItemInfo 클래스는 Windows 7 작업 표시줄 기능을 위한 관리되는 래퍼를 제공합니다. Windows 셸 및 네이티브 작업 표시줄 API에 대한 자세한 내용은 Taskbar Extensions를 참조하십시오.
Windows 7 작업 표시줄은 창을 최소화하거나 숨겼을 때 사용자에게 상태를 알리고 공통 작업을 노출하기 위해 작업 표시줄 항목을 사용할 수 있는 향상된 기능을 제공합니다. TaskbarItemInfo 클래스에 의해 노출된 기능은 Windows 7 이전의 Windows 버전에서는 사용할 수 없습니다. TaskbarItemInfo 클래스를 사용하는 응용 프로그램을 이전 버전의 Windows에서 실행할 수 있습니다. 그러나 이러한 작업 표시줄 향상은 이전 버전에서 사용할 수 없습니다.
Windows 7에서 일부 작업 표시줄 기능은 사용자의 설정에 따라 사용하지 못할 수 있습니다. 예를 들어, 작업 표시줄 기능은 Windows Aero가 비활성 상태이거나 응용 프로그램이 높은 권한으로 시작한 경우에는 사용할 수 없습니다. 응용 프로그램은 Windows 7의 향상된 작업 표시줄 기능에 독립적인 사용자와 상호 작용하는 다른 방법을 제공해야 합니다.
작업 표시줄의 맨 오른쪽에 있는 알림 영역의 프로그램 아이콘은 사용자에게 응용 프로그램 상태를 알려 주는 데 일반적으로 사용됩니다. 기본적으로 Windows 7 작업 표시줄은 알림 영역에서 프로그램 아이콘을 숨깁니다. 그러나 Overlay 속성을 설정하여 이미지를 메시징 응용 프로그램의 온라인 상태 같이 상태를 통신하는 작업 표시줄 단추에 이미지를 추가할 수 있습니다. 오버레이 이미지를 사용하면 사용자는 알림 영역에서 프로그램 아이콘을 볼 수 없어도 응용 프로그램 상태는 볼 수 있습니다. ProgressState 및 ProgressValue 속성을 설정하여 실행 중인 작업의 진행률을 작업 표시줄 단추에 표시할 수도 있습니다.
Windows 7 작업 표시줄은 작업 표시줄 단추 위로 마우스 포인터를 이동할 때 응용 프로그램의 축소판 그림을 표시합니다. 기본적으로 전체 응용 프로그램 창이 표시됩니다. ThumbnailClipMargin 속성을 설정하여 축소판 그림에 표시할 창의 특정 부분을 지정할 수 있습니다. 작업 표시줄 축소판 그림 위에 도구 설명이 표시되는 Description을 지정할 수도 있습니다. 사용자 설정 때문에 축소판 그림이 표시되지 않는 경우에도 도구 설명이 표시됩니다.
단추를 작업 표시줄의 축소판 그림에 추가하여 응용 프로그램 창으로 전환하지 않고 일반적인 작업에 대한 액세스 권한을 사용자에게 부여할 수 있습니다. 예를 들어, Window Media Player는 응용 프로그램이 최소화되었을 때 작업 표시줄 미리 보기에서 미디어를 재생할 수 있는 재생, 일시 중지, 앞으로 및 뒤로 단추를 제공합니다. 작업 표시줄 축소판 그림에 있는 단추는 ThumbButtonInfo 개체로 표현되며 ThumbButtonInfos 컬렉션에 포함됩니다.
다음 그림에서는 Windows 7 작업 표시줄의 향상된 기능을 보여 줍니다.
Windows 작업 표시줄 향상된 기능
.png "작업 표시줄 항목 정보 샘플")
스레드로부터의 안전성
이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.