ComboBoxRenderer Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Innehåller metoder som används för att återge en kombinationsrutekontroll med visuella format. Det går inte att ärva den här klassen.
public ref class ComboBoxRenderer sealed
public sealed class ComboBoxRenderer
type ComboBoxRenderer = class
Public NotInheritable Class ComboBoxRenderer
- Arv
-
ComboBoxRenderer
Exempel
I följande kodexempel visas hur du skapar en anpassad kontroll som använder DrawTextBox metoderna och DrawDropDownButton för att rita en kombinationsruta som svarar på musklickningar.
#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>
using namespace System;
using namespace System::Drawing;
using namespace System::Windows::Forms;
using namespace System::Windows::Forms::VisualStyles;
namespace ComboBoxRendererSample
{
ref class CustomComboBox: public Control
{
private:
System::Drawing::Size arrowSize;
Rectangle arrowRectangle;
Rectangle topTextBoxRectangle;
Rectangle bottomTextBoxRectangle;
ComboBoxState textBoxState;
ComboBoxState arrowState;
String^ bottomText;
bool isActivated;
int minHeight;
int minWidth;
public:
CustomComboBox() : Control()
{
minHeight = 38;
minWidth = 40;
this->Location = Point(10, 10);
this->Size = System::Drawing::Size(140, 38);
this->Font = SystemFonts::IconTitleFont;
this->Text = "Click the button";
textBoxState = ComboBoxState::Normal;
bottomText = "Using ComboBoxRenderer";
arrowState = ComboBoxState::Normal;
// Initialize the rectangles to look like the standard combo
// box control.
arrowSize = System::Drawing::Size(18, 20);
arrowRectangle = Rectangle(ClientRectangle.X +
ClientRectangle.Width - arrowSize.Width - 1,
ClientRectangle.Y + 1,
arrowSize.Width,
arrowSize.Height);
topTextBoxRectangle = Rectangle(ClientRectangle.X,
ClientRectangle.Y,
ClientRectangle.Width,
arrowSize.Height + 2);
bottomTextBoxRectangle = Rectangle(ClientRectangle.X,
ClientRectangle.Y + topTextBoxRectangle.Height,
ClientRectangle.Width,
topTextBoxRectangle.Height - 6);
}
// Draw the combo box in the current state.
protected:
virtual void OnPaint(PaintEventArgs^ e) override
{
Control::OnPaint(e);
if (!ComboBoxRenderer::IsSupported)
{
this->Parent->Text = "Visual Styles Disabled";
return;
}
this->Parent->Text = "CustomComboBox Enabled";
// Always draw the main text box and drop down arrow in their
// current states
ComboBoxRenderer::DrawTextBox(e->Graphics, topTextBoxRectangle,
this->Text, this->Font, textBoxState);
ComboBoxRenderer::DrawDropDownButton(e->Graphics, arrowRectangle,
arrowState);
// Only draw the bottom text box if the arrow has been clicked
if (isActivated)
{
ComboBoxRenderer::DrawTextBox(e->Graphics,
bottomTextBoxRectangle, bottomText, this->Font,
textBoxState);
}
}
protected:
virtual void OnMouseDown(MouseEventArgs^ e) override
{
Control::OnMouseDown(e);
// Check whether the user clicked the arrow.
if (arrowRectangle.Contains(e->Location) &&
ComboBoxRenderer::IsSupported)
{
// Draw the arrow in the pressed state.
arrowState = ComboBoxState::Pressed;
// The user has activated the combo box.
if (!isActivated)
{
this->Text = "Clicked!";
textBoxState = ComboBoxState::Pressed;
isActivated = true;
}
// The user has deactivated the combo box.
else
{
this->Text = "Click here";
textBoxState = ComboBoxState::Normal;
isActivated = false;
}
// Redraw the control.
Invalidate();
}
}
protected:
virtual void OnMouseUp(MouseEventArgs^ e) override
{
Control::OnMouseUp(e);
if (arrowRectangle.Contains(e->Location) &&
ComboBoxRenderer::IsSupported)
{
arrowState = ComboBoxState::Normal;
Invalidate();
}
}
};
ref class Form1 : public Form
{
public:
Form1() : Form()
{
this->Size = System::Drawing::Size(300, 300);
CustomComboBox^ ComboBox1 = gcnew CustomComboBox();
Controls->Add(ComboBox1);
}
};
}
[STAThread]
int main()
{
// The call to EnableVisualStyles below does not affect
// whether ComboBoxRenderer.IsSupported is true; as long as visual
// styles are enabled by the operating system, IsSupported is true.
Application::EnableVisualStyles();
Application::Run(gcnew ComboBoxRendererSample::Form1());
}
using System;
using System.Drawing;
using System.Windows.Forms;
using System.Windows.Forms.VisualStyles;
namespace ComboBoxRendererSample
{
class Form1 : Form
{
public Form1()
: base()
{
this.Size = new Size(300, 300);
CustomComboBox ComboBox1 = new CustomComboBox();
Controls.Add(ComboBox1);
}
[STAThread]
static void Main()
{
// The call to EnableVisualStyles below does not affect
// whether ComboBoxRenderer.IsSupported is true; as long as visual
// styles are enabled by the operating system, IsSupported is true.
Application.EnableVisualStyles();
Application.Run(new Form1());
}
}
public class CustomComboBox : Control
{
private Size arrowSize;
private Rectangle arrowRectangle;
private Rectangle topTextBoxRectangle;
private Rectangle bottomTextBoxRectangle;
private ComboBoxState textBoxState = ComboBoxState.Normal;
private ComboBoxState arrowState = ComboBoxState.Normal;
private String bottomText = "Using ComboBoxRenderer";
private bool isActivated = false;
private const int minHeight = 38;
private const int minWidth = 40;
public CustomComboBox()
: base()
{
this.Location = new Point(10, 10);
this.Size = new Size(140, 38);
this.Font = SystemFonts.IconTitleFont;
this.Text = "Click the button";
// Initialize the rectangles to look like the standard combo
// box control.
arrowSize = new Size(18, 20);
arrowRectangle = new Rectangle(ClientRectangle.X +
ClientRectangle.Width - arrowSize.Width - 1,
ClientRectangle.Y + 1,
arrowSize.Width,
arrowSize.Height);
topTextBoxRectangle = new Rectangle(ClientRectangle.X,
ClientRectangle.Y,
ClientRectangle.Width,
arrowSize.Height + 2);
bottomTextBoxRectangle = new Rectangle(ClientRectangle.X,
ClientRectangle.Y + topTextBoxRectangle.Height,
ClientRectangle.Width,
topTextBoxRectangle.Height - 6);
}
// Draw the combo box in the current state.
protected override void OnPaint(PaintEventArgs e)
{
base.OnPaint(e);
if (!ComboBoxRenderer.IsSupported)
{
this.Parent.Text = "Visual Styles Disabled";
return;
}
this.Parent.Text = "CustomComboBox Enabled";
// Always draw the main text box and drop down arrow in their
// current states
ComboBoxRenderer.DrawTextBox(e.Graphics, topTextBoxRectangle,
this.Text, this.Font, textBoxState);
ComboBoxRenderer.DrawDropDownButton(e.Graphics, arrowRectangle,
arrowState);
// Only draw the bottom text box if the arrow has been clicked
if (isActivated)
{
ComboBoxRenderer.DrawTextBox(e.Graphics,
bottomTextBoxRectangle, bottomText, this.Font,
textBoxState);
}
}
protected override void OnMouseDown(MouseEventArgs e)
{
base.OnMouseDown(e);
// Check whether the user clicked the arrow.
if (arrowRectangle.Contains(e.Location) &&
ComboBoxRenderer.IsSupported)
{
// Draw the arrow in the pressed state.
arrowState = ComboBoxState.Pressed;
// The user has activated the combo box.
if (!isActivated)
{
this.Text = "Clicked!";
textBoxState = ComboBoxState.Pressed;
isActivated = true;
}
// The user has deactivated the combo box.
else
{
this.Text = "Click here";
textBoxState = ComboBoxState.Normal;
isActivated = false;
}
// Redraw the control.
Invalidate();
}
}
protected override void OnMouseUp(MouseEventArgs e)
{
base.OnMouseUp(e);
if (arrowRectangle.Contains(e.Location) &&
ComboBoxRenderer.IsSupported)
{
arrowState = ComboBoxState.Normal;
Invalidate();
}
}
}
}
Imports System.Drawing
Imports System.Windows.Forms
Imports System.Windows.Forms.VisualStyles
Namespace ComboBoxRendererSample
Class Form1
Inherits Form
Public Sub New()
Me.Size = New Size(300, 300)
Dim ComboBox1 As New CustomComboBox()
Controls.Add(ComboBox1)
End Sub
<STAThread()> _
Shared Sub Main()
' The call to EnableVisualStyles below does not affect
' whether ComboBoxRenderer.IsSupported is true; as long as visual
' styles are enabled by the operating system, IsSupported is true.
Application.EnableVisualStyles()
Application.Run(New Form1())
End Sub
End Class
Public Class CustomComboBox
Inherits Control
Private arrowSize As Size
Private arrowRectangle As Rectangle
Private topTextBoxRectangle As Rectangle
Private bottomTextBoxRectangle As Rectangle
Private textBoxState As ComboBoxState = ComboBoxState.Normal
Private arrowState As ComboBoxState = ComboBoxState.Normal
Private bottomText As String = "Using ComboBoxRenderer"
Private isActivated As Boolean = False
Private minHeight As Integer = 38
Private minWidth As Integer = 40
Public Sub New()
Me.Location = New Point(10, 10)
Me.Size = New Size(140, 38)
Me.Font = SystemFonts.IconTitleFont
Me.Text = "Click the button"
' Initialize the rectangles to look like the standard combo
' box control.
arrowSize = New Size(18, 20)
arrowRectangle = New Rectangle(Me.ClientRectangle.X + _
Me.ClientRectangle.Width - arrowSize.Width - 1, _
Me.ClientRectangle.Y + 1, arrowSize.Width, _
arrowSize.Height)
topTextBoxRectangle = New Rectangle(Me.ClientRectangle.X, _
Me.ClientRectangle.Y, Me.ClientRectangle.Width, _
arrowSize.Height + 2)
bottomTextBoxRectangle = New Rectangle(Me.ClientRectangle.X, _
Me.ClientRectangle.Y + topTextBoxRectangle.Height, _
Me.ClientRectangle.Width, topTextBoxRectangle.Height - 6)
End Sub
' Draw the combo box in the current state.
Protected Overrides Sub OnPaint(ByVal e As PaintEventArgs)
MyBase.OnPaint(e)
If Not ComboBoxRenderer.IsSupported Then
Me.Parent.Text = "Visual Styles Disabled"
Return
End If
Me.Parent.Text = "CustomComboBox Enabled"
' Always draw the main text box and drop down arrow in their
' current states.
ComboBoxRenderer.DrawTextBox(e.Graphics, topTextBoxRectangle, _
Me.Text, Me.Font, textBoxState)
ComboBoxRenderer.DrawDropDownButton(e.Graphics, arrowRectangle, _
arrowState)
' Only draw the bottom text box if the arrow has been clicked.
If isActivated Then
ComboBoxRenderer.DrawTextBox(e.Graphics, _
bottomTextBoxRectangle, bottomText, Me.Font, textBoxState)
End If
End Sub
Protected Overrides Sub OnMouseDown(ByVal e As MouseEventArgs)
MyBase.OnMouseDown(e)
' Check whether the user clicked the arrow.
If arrowRectangle.Contains(e.Location) And _
ComboBoxRenderer.IsSupported Then
' Draw the arrow in the pressed state.
arrowState = ComboBoxState.Pressed
' The user has activated the combo box.
If Not isActivated Then
Me.Text = "Clicked!"
textBoxState = ComboBoxState.Pressed
isActivated = True
' The user has deactivated the combo box.
Else
Me.Text = "Click here"
textBoxState = ComboBoxState.Normal
isActivated = False
End If
' Redraw the control.
Invalidate()
End If
End Sub
Protected Overrides Sub OnMouseUp(ByVal e As MouseEventArgs)
MyBase.OnMouseUp(e)
If arrowRectangle.Contains(e.Location) And _
ComboBoxRenderer.IsSupported Then
arrowState = ComboBoxState.Normal
Invalidate()
End If
End Sub
End Class
End Namespace
Kommentarer
Klassen ComboBoxRenderer innehåller en uppsättning static metoder som kan användas för att återge en kombinationsrutekontroll med operativsystemets aktuella visuella format. Rendering av en kontroll syftar på att rita användargränssnittet för en kontroll. Det här är användbart om du ritar en anpassad kontroll som ska se ut som det aktuella visuella formatet. Om du vill rita en kombinationsruta använder du DrawTextBox metoden för att rita textrutan och DrawDropDownButton metoden för att rita listrutepilen.
Om visuella format är aktiverade i operativsystemet och visuella format tillämpas på klientområdet i programfönster, DrawTextBox och DrawDropDownButton kommer att rita kombinationsrutan med det aktuella visuella formatet. Annars genererar dessa metoder en InvalidOperationException. Om du vill ta reda på om medlemmarna i den här klassen kan användas kan du kontrollera värdet för IsSupported egenskapen.
Den här klassen omsluter funktionen för en System.Windows.Forms.VisualStyles.VisualStyleRenderer som är inställd på ett av de element som exponeras av klasserna System.Windows.Forms.VisualStyles.VisualStyleElement.ComboBox.DropDownButton och System.Windows.Forms.VisualStyles.VisualStyleElement.TextBox.TextEdit. Mer information finns i Renderingskontroller med visuella format.
Egenskaper
| Name | Description |
|---|---|
| IsSupported |
Hämtar ett värde som anger om ComboBoxRenderer klassen kan användas för att rita en kombinationsruta med visuella format. |
Metoder
| Name | Description |
|---|---|
| DrawDropDownButton(Graphics, Rectangle, ComboBoxState) |
Ritar en listrutepil med det aktuella visuella formatet för operativsystemet. |
| DrawTextBox(Graphics, Rectangle, ComboBoxState) |
Ritar en textruta i det angivna tillståndet och gränserna. |
| DrawTextBox(Graphics, Rectangle, String, Font, ComboBoxState) |
Ritar en textruta i det angivna tillståndet och gränserna med den angivna texten. |
| DrawTextBox(Graphics, Rectangle, String, Font, Rectangle, ComboBoxState) |
Ritar en textruta i det angivna tillståndet och gränserna med angivna text- och textgräns. |
| DrawTextBox(Graphics, Rectangle, String, Font, Rectangle, TextFormatFlags, ComboBoxState) |
Ritar en textruta i det angivna tillståndet och gränserna med angiven text, textformatering och textgräns. |
| DrawTextBox(Graphics, Rectangle, String, Font, TextFormatFlags, ComboBoxState) |
Ritar en textruta i angivet tillstånd och gränser med angiven text- och textformatering. |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |