문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문
이 설명서는 보관되지만 유지 되지 않습니다.

TaskbarItemInfo 클래스

Visual Studio 2010

작업 표시줄 축소판 그림이 표시되는 방법에 대한 정보를 나타냅니다.

네임스페이스:  Microsoft.Windows.Shell
어셈블리:  Microsoft.Windows.Shell(Microsoft.Windows.Shell.dll)

public sealed class TaskbarItemInfo : Freezable

TaskbarItemInfo 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Public 메서드TaskbarItemInfo TaskbarItemInfo 클래스의 새 인스턴스를 초기화합니다.
위쪽

  이름설명
Public 속성CanFreeze개체를 수정할 수 없게 만들 수 있는지 여부를 나타내는 값을 가져옵니다. (Freezable에서 상속됨)
Public 속성DependencyObjectType이 인스턴스의 CLR 형식을 래핑하는 DependencyObjectType을 가져옵니다.  (DependencyObject에서 상속됨)
Public 속성Description작업 표시줄 항목 도구 설명에 대한 텍스트를 가져오거나 설정합니다.
Public 속성DispatcherDispatcherObject와 연결된 Dispatcher를 가져옵니다. (DispatcherObject에서 상속됨)
Public 속성IsFrozen개체를 현재 수정할 수 있는지 여부를 나타내는 값을 가져옵니다. (Freezable에서 상속됨)
Public 속성IsSealed이 인스턴스가 현재 봉인되어 있는지(읽기 전용인지) 여부를 나타내는 값을 가져옵니다. (DependencyObject에서 상속됨)
Public 속성Overlay작업 표시줄 단추의 프로그램 아이콘에 표시되는 이미지를 가져오거나 설정합니다.
Public 속성ProgressState작업 표시줄 단추에 진행률 표시기가 표시되는 방법을 나타내는 값을 가져오거나 설정합니다.
Public 속성ProgressValue작업 표시줄 단추에 진행률 표시기의 진행 정도를 나타내는 값을 가져오거나 설정합니다.
Public 속성ThumbButtonInfos Window 에 연결된 ThumbButtonInfo 개체의 컬렉션을 가져오거나 설정합니다.
Public 속성ThumbnailClipMargin작업 표시줄 축소판 그림에 표시되는 응용 프로그램 창 클라이언트 영역의 일부를 지정하는 값을 가져오거나 설정합니다.
위쪽

  이름설명
연결된 Public 속성TaskbarItemInfo창에 연결된 TaskbarItemInfo를 가져오거나 설정합니다.
위쪽

  이름설명
Public 메서드CheckAccess호출 스레드가 이 DispatcherObject에 액세스할 수 있는지 여부를 확인합니다. (DispatcherObject에서 상속됨)
Public 메서드ClearValue(DependencyProperty)속성의 로컬 값을 지웁니다. 지울 속성은 DependencyProperty 식별자로 지정됩니다. (DependencyObject에서 상속됨)
Public 메서드ClearValue(DependencyPropertyKey)읽기 전용 속성의 로컬 값을 지웁니다. 지울 속성은 DependencyPropertyKey에서 지정됩니다. (DependencyObject에서 상속됨)
Public 메서드Clone개체 값의 전체 복사본을 만들어 Freezable의 수정 가능한 복제본을 만듭니다. 개체의 종속성 속성을 복사할 때 이 메서드는 식을 복사하지만 애니메이션 또는 현재 값은 복사하지 않습니다. 이러한 식이 더 이상 확인되지 않을 수도 있습니다. (Freezable에서 상속됨)
Protected 메서드CloneCore애니메이션이 적용되지 않은 기준 속성 값을 사용하여 인스턴스를 지정된 Freezable의 복제본(전체 복사본)으로 만듭니다. (Freezable에서 상속됨)
Public 메서드CloneCurrentValue현재 값을 사용하여 Freezable의 수정 가능한 복제본(전체 복사본)을 만듭니다. (Freezable에서 상속됨)
Protected 메서드CloneCurrentValueCore현재 속성 값을 사용하여 인스턴스를 지정된 Freezable의 수정 가능한 복제본(전체 복사본)으로 만듭니다. (Freezable에서 상속됨)
Public 메서드CoerceValue지정된 종속성 속성 값을 강제 변환합니다. 이 작업은 호출하는 DependencyObject에 있는 종속성 속성의 속성 메타데이터에 지정되어 있는 CoerceValueCallback 함수를 호출하여 수행합니다. (DependencyObject에서 상속됨)
Protected 메서드CreateInstance Freezable 클래스의 새 인스턴스를 초기화합니다. (Freezable에서 상속됨)
Protected 메서드CreateInstanceCore파생 클래스에서 구현되는 경우 Freezable 파생 클래스의 새 인스턴스를 만듭니다. (Freezable에서 상속됨)
Public 메서드Equals제공된 DependencyObject가 현재 DependencyObject에 해당하는지 여부를 확인합니다. (DependencyObject에서 상속됨)
Protected 메서드Finalize가비지 수집에서 회수하기 전에 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드Freeze현재 개체를 수정할 수 없게 만들고 IsFrozen 속성을 true로 설정합니다. (Freezable에서 상속됨)
Protected 메서드FreezeCore Freezable 을 수정할 수 없게 만들거나, 수정할 수 없게 만들 수 있는지 테스트합니다. (Freezable에서 상속됨)
Public 메서드GetAsFrozen애니메이션이 적용되지 않은 기준 속성 값을 사용하여 Freezable의 고정된 복사본을 만듭니다. 복사본이 고정되므로 고정된 하위 개체는 모두 참조를 통해 복사됩니다. (Freezable에서 상속됨)
Protected 메서드GetAsFrozenCore애니메이션이 적용되지 않은 기준 속성 값을 사용하여 인스턴스를 지정된 Freezable의 고정된 복제본으로 만듭니다. (Freezable에서 상속됨)
Public 메서드GetCurrentValueAsFrozen현재 속성 값을 사용하여 Freezable의 고정된 복사본을 만듭니다. 복사본이 고정되므로 고정된 하위 개체는 모두 참조를 통해 복사됩니다. (Freezable에서 상속됨)
Protected 메서드GetCurrentValueAsFrozenCore현재 인스턴스를 지정된 Freezable의 고정된 복제본으로 만듭니다. 개체에 애니메이션이 적용된 종속성 속성이 있으면 애니메이션이 적용된 현재 값이 복사됩니다. (Freezable에서 상속됨)
Public 메서드GetHashCodeDependencyObject의 해시 코드를 가져옵니다. (DependencyObject에서 상속됨)
Public 메서드GetLocalValueEnumeratorDependencyObject에 대해 로컬로 값을 설정한 종속성 속성을 확인하기 위한 특수 열거자를 만듭니다. (DependencyObject에서 상속됨)
Public 메서드정적 멤버GetTaskbarItemInfo개체의 TaskbarItemInfo 연결된 속성 값을 가져옵니다.
Public 메서드GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Public 메서드GetValueDependencyObject 인스턴스에서 종속성 속성의 현재 유효 값을 반환합니다. (DependencyObject에서 상속됨)
Public 메서드InvalidateProperty지정된 종속성 속성의 유효 값을 다시 계산합니다. (DependencyObject에서 상속됨)
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Protected 메서드OnChanged현재 Freezable 개체가 수정될 때 호출됩니다. (Freezable에서 상속됨)
Protected 메서드OnFreezablePropertyChanged(DependencyObject, DependencyObject)방금 설정된 DependencyObjectType 데이터 멤버에 대한 적절한 컨텍스트 포인터를 설정합니다. (Freezable에서 상속됨)
Protected 메서드OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)이 멤버는 Windows Presentation Foundation (WPF) 인프라를 지원하며 사용자 코드에서 직접 사용할 수 없습니다. (Freezable에서 상속됨)
Protected 메서드OnPropertyChanged OnPropertyChanged DependencyObject 구현을 재정의하면 Freezable 형식의 종속성 속성이 변경될 때 Changed 처리기를 함께 호출할 수 있습니다. (Freezable에서 상속됨)
Public 메서드ReadLocalValue종속성 속성의 로컬 값(있는 경우)을 반환합니다. (DependencyObject에서 상속됨)
Protected 메서드ReadPreamble유효한 스레드에서 Freezable에 액세스하고 있는지 확인합니다. Freezable 상속자는 종속성 속성이 아닌 데이터 멤버를 읽는 API의 시작 부분에서 이 메서드를 호출해야 합니다. (Freezable에서 상속됨)
Public 메서드정적 멤버SetTaskbarItemInfo개체의 TaskbarItemInfo 연결된 속성 값을 설정합니다.
Public 메서드SetValue(DependencyProperty, Object)해당 종속성 속성 식별자로 지정되는 종속성 속성의 로컬 값을 설정합니다. (DependencyObject에서 상속됨)
Public 메서드SetValue(DependencyPropertyKey, Object)종속성 속성의 DependencyPropertyKey 식별자로 지정되는 읽기 전용 종속성 속성의 로컬 값을 설정합니다. (DependencyObject에서 상속됨)
Protected 메서드ShouldSerializePropertyserialization 프로세스를 통해 제공된 종속성 속성의 값을 serialize해야 하는지 여부를 나타내는 값을 반환합니다. (DependencyObject에서 상속됨)
Public 메서드ToString현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
Public 메서드VerifyAccess호출 스레드에서 이 DispatcherObject에 액세스할 수 있는지 확인합니다. (DispatcherObject에서 상속됨)
Protected 메서드WritePostscript Freezable 에 대한 Changed 이벤트를 발생시키고 OnChanged 메서드를 호출합니다. Freezable 에서 파생되는 클래스는 종속성 속성으로 저장되지 않는 클래스 멤버를 수정하는 모든 API의 끝 부분에서 이 메서드를 호출해야 합니다. (Freezable에서 상속됨)
Protected 메서드WritePreamble Freezable 이 고정되어 있지 않고 유효한 스레드 컨텍스트에서 액세스되고 있는지 확인합니다. Freezable 상속자는 종속성 속성이 아닌 데이터 멤버에 쓰는 API의 시작 부분에서 이 메서드를 호출해야 합니다. (Freezable에서 상속됨)
위쪽

  이름설명
Public 이벤트Changed Freezable 또는 여기에 들어 있는 개체가 수정될 때 발생합니다. (Freezable에서 상속됨)
위쪽

  이름설명
Public 필드정적 멤버DescriptionProperty Description 종속성 속성을 식별합니다.
Public 필드정적 멤버OverlayProperty Overlay 종속성 속성을 식별합니다.
Public 필드정적 멤버ProgressStateProperty ProgressState 종속성 속성을 식별합니다.
Public 필드정적 멤버ProgressValueProperty ProgressValue 종속성 속성을 식별합니다.
Public 필드정적 멤버TaskbarItemInfoProperty TaskbarItemInfo 종속성 속성을 식별합니다.
Public 필드정적 멤버ThumbButtonInfosProperty ThumbButtonInfos 종속성 속성을 식별합니다.
Public 필드정적 멤버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 작업 표시줄 향상된 기능

작업 표시줄 항목 정보 샘플

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.
표시: