Export (0) Print
Expand All

ToolBarButton.PartialPush Property

Gets or sets a value indicating whether a toggle-style toolbar button is partially pushed.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public bool PartialPush { get; set; }

Property Value

Type: System.Boolean
true if a toggle-style toolbar button is partially pushed; otherwise, false. The default is false.

When PartialPush is set to true, the toolbar button appears to have its face grayed. This appearance is different from the dimmed appearance when the Enabled property is set to false since the partial-push appearance gives a haze to the entire button face. This property has no effect unless the ToolBarButtonStyle is set to ToggleButton.

The following code example demonstrates how to use the Pushed, and PartialPush properties. To run the example, paste the following code in a form containing a RichTextBox control called RichTextBox1.Call the InitializeToolBar method in the form's constructor or Load method.

	
	// Declare ToolBar1. 
	internal System.Windows.Forms.ToolBar ToolBar1;

	// Initialize ToolBar1 with Bold(B), Italic(I), and  
	// Underline(U) buttons. 
	private void InitializeToolBar()
	{
		ToolBar1 = new ToolBar();

		// Set the appearance to Flat.
		ToolBar1.Appearance = ToolBarAppearance.Flat;

		// Set the toolbar to dock at the bottom of the form.
		ToolBar1.Dock = DockStyle.Bottom;

		// Set the toolbar font to 14 points and bold.
		ToolBar1.Font = new Font(FontFamily.GenericSansSerif,
			14, FontStyle.Bold);

		// Declare fontstyle array with the three font styles.
		FontStyle[] fonts = new FontStyle[]{FontStyle.Bold, 
			FontStyle.Italic, FontStyle.Underline};
		
		int count;

		// Create a button for each value in the array, setting its  
		// text to the first letter of the style and its  
		// button's tag property. 
		for(count=0; count<fonts.Length; count++)
		{
			ToolBarButton fontButton = 
				new ToolBarButton(fonts[count].ToString().Substring(0, 1));
			fontButton.Style = ToolBarButtonStyle.ToggleButton;
			fontButton.Tag = fonts[count];
			ToolBar1.Buttons.Add(fontButton);
		}
		this.ToolBar1.ButtonClick += 
			new ToolBarButtonClickEventHandler(ToolBar1_ButtonClick);
		this.Controls.Add(this.ToolBar1);
	}
	

	// Declare FontStyle object, which defaults to the Regular 
	// FontStyle.
	FontStyle style = new FontStyle();

	private void ToolBar1_ButtonClick(object sender, 
		System.Windows.Forms.ToolBarButtonClickEventArgs e)
	{

		// If a button is pushed, use a bitwise Or combination  
		// of the style variable and the button tag, to set style to  
		// the correct FontStyle. Set the button's PartialPush  
		// property to true for a Windows XP-like appearance. 
		if (e.Button.Pushed)
		{
			e.Button.PartialPush = true;
			style = style |(FontStyle) e.Button.Tag;

		}
		else
		{
			// If the button was not pushed, use a bitwise XOR  
			// combination to turn off that style  
			// and set the PartialPush property to false.
			e.Button.PartialPush = false;
			style = style ^ (FontStyle) e.Button.Tag;
		}

		// Set the font using the existing RichTextBox font and the new 
		// style.
		RichTextBox1.Font = new Font(RichTextBox1.Font, style);

	}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft