Cursor 속성
문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

FrameworkElement.Cursor 속성

마우스 포인터가 FrameworkElement 위에 있을 때 표시되는 커서 이미지를 가져오거나 설정합니다.

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

public Cursor Cursor { get; set; }
<frameworkElement Cursor="cursorsValue"/>

XAML 값

cursorsValue

Arrow 또는 IBeam 같은 Cursors 상수 값에 이름을 지정하는 문자열입니다.

속성 값

형식: System.Windows.Input.Cursor
표시할 커서 이미지입니다. 기본값은 코드 액세스를 위해 null로 정의됩니다. 그러나 런타임 시 UI에서 커서 이미지의 모양은 다양한 요인을 기준으로 합니다.

Dependency property identifier field: CursorProperty

XAML에서 이 속성을 설정할 때 XAML 프로세서는 Cursor 클래스의 형식 변환을 사용하여 특성 문자열 값을 계산합니다. 제공된 문자열은 Cursors 상수인 문자열로 평가해야 합니다. 자세한 내용은 Cursor을 참조하십시오.

코드에서 이 속성을 설정하는 효과를 되돌리고 대신 런타임 UI 기본값을 사용하려면 nullCursor로 설정합니다.

기본값인 null은 UI의 커서/포인터 이미지의 결정을 해당 위치에서는 고유한 개체별 속성 설정으로 지연시키고 다른 위치에서 값을 가져옴을 의미합니다. 소스에서 프로그래밍 값이 제공되지 않는 경우 Silverlight 기반 응용 프로그램 위에 시각적으로 표시되는 기본 커서는 화살표가 됩니다. 그러나 커서를 건너뛸 때는 임시 커서 변경 내용이 개체의 Cursor 값으로 설정되지 않습니다. Cursor 속성은 코드를 통해 실제로 설정된 경우에만 null이 아닌 값을 보고합니다.

특정 컨트롤은 스타일이나 스타일 내의 표시 상태를 통해 생성되는 과정에서, 그리고 컨트롤의 클래스 구현을 통해 Cursor에 영향을 줄 수 있습니다. TextBox 를 포함하는 컨트롤 또는 TextBox 자체가 이러한 컨트롤에 해당합니다.

패널과 같은 레이아웃 컨테이너에서 Cursor 값을 설정하는 경우 다른 방법으로 커서의 정의를 지정하지 않는 포함된 자식 요소에 대한 커서 값이 마우스를 올려 놓을 때의 동작으로 "상속"됩니다. 하지만 일반적으로 TextBox처럼 특정 요소가 특정 커서를 요청하는 경우에는 컨테이너의 Cursor 값과 상관없이 특정 요소별 커서가 사용됩니다.

참고참고:

Silverlight에서는 WPF 커서 API를 기반으로 커서 API를 모델링합니다. 그러나 Silverlight 5 베타에서는 커서를 확장할 수 없습니다. 즉, Silverlight Cursor가 sealed입니다. 이러한 아키텍처상의 이유 때문에 Cursor 중간 형식을 Cursor 정적 속성 값으로 직접 사용하는 대신 코드의 Cursors 속성 값에 사용합니다.

버전 메모

Silverlight 3에서 Cursor는 종속성 속성이며 이는 식별자 필드가 public이 아닌 경우에도 마찬가지입니다. 이 속성은 여전히 XAML에서 설정할 수 있으며 XAML에서 스타일을 지정할 수 있습니다. 하지만 이곳에(예: SetValue) 속성 시스템 API를 사용할 수 없습니다.

다음 예제에서는 "잡기" 작업에 적합한 시각적 커서(Hand)로 사용할 대상 FrameworkElement 위에 커서를 설정하는 유틸리티 메서드를 구현합니다. 또한 이 메서드는 "잡기" 작업을 완료한 후 사용할 수 있도록 이전에 설정한 "잡기" 커서를 null 기본값으로 다시 설정합니다.

private static void ChangeGrabState(bool canGrab, FrameworkElement target)
{
    if (canGrab)
    {
        target.Cursor = Cursors.Hand;
    }
    else
    {
        target.Cursor = null;
        //deliberate null set causes the target to resume a default cursor handling
        //based on context, the specific target's behavior, etc.
    }
}

Silverlight

5, 4, 3에서 지원

Windows Phone용 Silverlight

Windows Phone OS 7.1, Windows Phone OS 7.0에서 지원

Silverlight에서 지원되는 운영 체제 및 브라우저에 대한 자세한 내용은 지원되는 운영 체제 및 브라우저을 참조하십시오.

커뮤니티 추가 항목

추가
표시:
© 2016 Microsoft