Control.Visible Property

Definition

Gets or sets a value indicating whether the control and all its child controls are displayed.

public bool Visible { get; set; }

Property Value

true to display the control and its child controls; otherwise, false. The default is true. When getting the value, true is returned only if the control is visible and the parent control, if it exists, is visible.

Examples

The following code example uses the derived classes VScrollBar and HScrollBar and sets their Visible property values, based on the size of an Image being displayed in a PictureBox control. This example requires that a PictureBox has been created on a form and that HScrollBar and VScrollBar controls have been created on the PictureBox. This code should be called when the image is loaded into the picture box and by the Resize event of the form.

public void DisplayScrollBars()
 {
    // Display or hide the scroll bars based upon  
    // whether the image is larger than the PictureBox.
    if (pictureBox1.Width > pictureBox1.Image.Width)
    {
       hScrollBar1.Visible = false;
    }
    else
    {
       hScrollBar1.Visible = true;
    }
    
    if (pictureBox1.Height > pictureBox1.Image.Height)
    {
       vScrollBar1.Visible = false;
    }
    else
    {
       vScrollBar1.Visible = true;
    }
 }

Remarks

If you set Visible to true:

  • The control might not be visible to the user if it's obscured behind other controls.
  • The control won't be displayed if the parent control is not visible.

Applies to

Product Versions
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

See also