Form.TransparencyKey Propriedade

Definição

Obtém ou define a cor que representará áreas transparentes do formulário.

public:
 property System::Drawing::Color TransparencyKey { System::Drawing::Color get(); void set(System::Drawing::Color value); };
public System.Drawing.Color TransparencyKey { get; set; }
member this.TransparencyKey : System.Drawing.Color with get, set
Public Property TransparencyKey As Color

Valor da propriedade

Color

Um Color que representa a cor a ser exibida de forma transparente no formulário.

Exemplos

O exemplo a seguir cria uma janela que tem uma região de cliente transparente, independentemente da cor da tela de fundo do formulário. Este exemplo requer que o método de exemplo seja definido em uma classe de formulário.

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 Sub InitializeMyForm()
    BackColor = Color.Red
    ' Make the background color of form display transparently.
    TransparencyKey = BackColor
End Sub

Comentários

Quando a TransparencyKey propriedade é atribuída a um Color, as áreas do formulário que têm o mesmo BackColor serão exibidas de forma transparente. Todas as ações do mouse, como o clique do mouse, executadas nas áreas transparentes do formulário serão transferidas para as janelas abaixo da área transparente. Por exemplo, se a região do cliente de um formulário for transparente, clicar no mouse nessa área enviará a notificação de evento do clique para qualquer janela abaixo dele. Se a cor atribuída à TransparencyKey propriedade for a mesma que qualquer controle no formulário, ela também será exibida de forma transparente. Por exemplo, se você tiver um Button controle em um formulário com sua TransparencyKey propriedade definida como SystemColors.Control, o controle será exibido de forma transparente, a menos que a BackColor propriedade do Button controle seja alterada para uma cor diferente.

Essa propriedade não tem suporte quando RightToLeftLayout é true.

Aplica-se a