Form.TransparencyKey プロパティ

.NET Framework クラス ライブラリ リファレンス

Form.TransparencyKey プロパティ

フォームの透明な領域を表す色を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property TransparencyKey As
 Color

Visual Basic (使用法)

Dim instance As Form
Dim value As Color

value = instance.TransparencyKey

instance.TransparencyKey = value

C#

public Color TransparencyKey { get; set;
 }

C++

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

J#

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

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

JScript

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 以降でのみサポートされています。

使用例

フォームの背景色に関係なく、透明なクライアント領域を持つウィンドウを作成するコード例を次に示します。この例では、メソッドがフォーム クラス内で定義されていることを前提にしています。

Visual Basic

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

C#

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

C++

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

J#

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 名前空間