Button.PrintObject (Propiedad) (2007 System)

Actualización: noviembre 2007

Obtiene o establece un valor que indica si se imprime el control Button al imprimir la hoja de cálculo.

Espacio de nombres:  Microsoft.Office.Tools.Excel.Controls
Ensamblado:  Microsoft.Office.Tools.Excel.v9.0 (en Microsoft.Office.Tools.Excel.v9.0.dll)

Sintaxis

<BrowsableAttribute(False)> _
Public Property PrintObject As Boolean

Dim instance As Button
Dim value As Boolean

value = instance.PrintObject

instance.PrintObject = value

[BrowsableAttribute(false)]
public bool PrintObject { get; set; }

Valor de propiedad

Tipo: System.Boolean

true, si el control Button se imprime al imprimir la hoja de cálculo; de lo contrario, false.

Ejemplos

En el ejemplo de código siguiente se muestra un control Button con un controlador de eventos Click que genera una vista preliminar de la hoja de cálculo. El controlador de eventos pide al usuario que especifique si el botón debe aparecer en la vista preliminar estableciendo el valor de la propiedad PrintObject.

Se trata de un ejemplo para una personalización en el nivel del documento.

Private Sub PrintControl()

    Dim PrintButton As Microsoft.Office.Tools.Excel.Controls.Button = _
        Me.Controls.AddButton(Me.Range("C2", "D3"), "PrintButton")
    PrintButton.Text = "Print preview"
    AddHandler PrintButton.Click, AddressOf printButton_Click

    ' Set a range value so that a print preview is generated even
    ' if the button is hidden from the preview.
    Me.Range("A1", "A10").Value2 = 123
End Sub

Private Sub PrintButton_Click(ByVal sender As Object, ByVal e As EventArgs)
    Dim ClickedButton As Microsoft.Office.Tools.Excel.Controls.Button = _
        CType(sender, Microsoft.Office.Tools.Excel.Controls.Button)

    ' Allow the user to hide the button from print previews.
    If DialogResult.No = MessageBox.Show( _
        "Include the button when printing the sheet?", "Example", _
        MessageBoxButtons.YesNo) Then
        ClickedButton.PrintObject = False
    End If
    Me.PrintPreview(True)
End Sub

private void PrintControl()
{
    Microsoft.Office.Tools.Excel.Controls.Button printButton =
            this.Controls.AddButton(this.Range["C2", "D3"],
            "printButton");
    printButton.Text = "Print preview";
    printButton.Click += new EventHandler(printButton_Click);

    // Set a range value so that a print preview is generated even
    // if the button is hidden from the preview.
    this.Range["A1", "A10"].Value2 = 123;
}

void printButton_Click(object sender, EventArgs e)
{
    Microsoft.Office.Tools.Excel.Controls.Button clickedButton =
        (Microsoft.Office.Tools.Excel.Controls.Button)sender;

    if (DialogResult.No ==
        MessageBox.Show("Include the button when printing the sheet?",
        "Example", MessageBoxButtons.YesNo))
    {
        clickedButton.PrintObject = false;
    }
    this.PrintPreview(true);
}

Permisos

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

Button (Clase)

Button (Miembros)

Microsoft.Office.Tools.Excel.Controls (Espacio de nombres)