乐胖代购免代理版

.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

public Color TransparencyKey { get; set;
 }

C++

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

/** @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

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;
   }

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

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