다음을 통해 공유

Form.TransparencyKey 속성

  • 아티클

폼의 투명 영역을 나타내는 색을 가져오거나 설정합니다.

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

구문

‘선언
Public Property TransparencyKey As Color
‘사용 방법
Dim instance As Form
Dim value As Color

value = instance.TransparencyKey

instance.TransparencyKey = value

public Color TransparencyKey { get; set; }

public:
property Color TransparencyKey {
    Color get ();
    void set (Color value);
}

/** @property */
public Color get_TransparencyKey ()

/** @property */
public void set_TransparencyKey (Color value)

public function get TransparencyKey () : Color

public function set TransparencyKey (value : Color)

속성 값

폼에 투명하게 표시할 색을 나타내는 Color입니다.

설명

TransparencyKey 속성에 Color가 할당되면 같은 BackColor를 갖는 폼의 영역이 투명하게 표시됩니다. 마우스 클릭 등과 같이 폼의 투명 영역에서 수행되는 마우스 동작은 투명 영역 아래의 창으로 전달됩니다. 예를 들어, 폼의 클라이언트 영역이 투명하게 나타나는 경우 해당 영역을 마우스로 클릭하면 해당 영역 아래의 창에 클릭 이벤트에 대한 알림이 보내집니다. TransparencyKey 속성에 할당된 색이 폼의 컨트롤 색과 같으면 해당 컨트롤도 투명하게 표시됩니다. 예를 들어, 폼에 TransparencyKey 속성이 SystemColors.Control로 설정된 Button 컨트롤이 있는 경우 이 컨트롤은 Button 컨트롤의 BackColor 속성을 다른 색으로 바꾸지 않으면 투명하게 표시됩니다.

이 속성은 RightToLeftLayout이 true인 경우 지원되지 않습니다.

Windows 2000, Windows Server 2003, Windows XP Home Edition, Windows XP Professional x64 Edition, Windows Server 2003 플랫폼 참고: 투명 창 및 영역은 Windows 2000 이상에서만 지원됩니다.

예제

다음 코드 예제에서는 폼의 배경색에 관계없이 투명 클라이언트 영역이 있는 창을 만듭니다. 이 예제에서는 해당 예제 메서드가 폼 클래스 내에 정의되어 있어야 합니다.

Public Sub InitializeMyForm()
    BackColor = Color.Red
    ' Make the background color of form display transparently.
    TransparencyKey = BackColor
End Sub 'InitializeMyForm

public void InitializeMyForm()
 {
    this.BackColor = Color.Red;
    // Make the background color of form display transparently.
    this.TransparencyKey = BackColor;
 }
    

public:
   void InitializeMyForm()
   {
      this->BackColor = Color::Red;
      // Make the background color of form display transparently.
      this->TransparencyKey = BackColor;
   }

public void InitializeMyForm()
{
    this.set_BackColor(Color.get_Red());

    // Make the background color of form display transparently.
    this.set_TransparencyKey(this.get_BackColor());
} //InitializeMyForm

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

참고 항목

참조

Form 클래스
Form 멤버
System.Windows.Forms 네임스페이스