TreeNodeStates Sabit listesi
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
TreeNodeolası durumlarını temsil eden sabitleri tanımlar.
Bu sabit listesi, üyeleri için bit düzeyinde karşılaştırmayı destekler.
public enum class TreeNodeStates[System.Flags]
public enum TreeNodeStates[<System.Flags>]
type TreeNodeStates = Public Enum TreeNodeStates- Devralma
- Öznitelikler
Alanlar
| Name | Değer | Description |
|---|---|---|
| Selected | 1 | Düğüm seçilir. |
| Grayed | 2 | Düğüm devre dışı bırakıldı. |
| Checked | 8 | Düğüm denetlendi. |
| Focused | 16 | Düğümde odak vardır. |
| Default | 32 | Düğüm varsayılan durumundadır. |
| Hot | 64 | Düğüm sık erişimli. Özellik olarak ayarlandığında |
| Marked | 128 | Düğüm işaretlenir. |
| Indeterminate | 256 | Düğüm belirsiz bir durumda. |
| ShowKeyboardCues | 512 | Düğüm bir klavye kısayolu göstermelidir. |
Örnekler
Aşağıdaki örnekte sahip çizimini kullanarak bir TreeView denetimin nasıl özelleştirileceği gösterilmektedir. Örnekteki TreeView denetim, normal düğüm etiketlerinin yanında isteğe bağlı düğüm etiketlerini görüntüler. Düğüm etiketleri özelliği kullanılarak TreeNode.Tag belirtilir. Denetim TreeView ayrıca özel bir vurgu rengi de dahil olmak üzere özel renkler kullanır.
Renk özelliklerini ayarlayarak renklerin TreeView çoğunu özelleştirebilirsiniz, ancak seçim vurgu rengi özellik olarak kullanılamaz. Ayrıca, varsayılan seçim vurgu dikdörtgeni yalnızca bir düğüm etiketi çevresinde genişletir. Sahip çizimi, düğüm etiketlerini çizmek ve bir düğüm etiketi içerecek kadar büyük özelleştirilmiş bir vurgu dikdörtgeni çizmek için kullanılmalıdır.
Örnekte, olay işleyicisi TreeView.DrawNode sınıfının yöntemlerini çağırarak seçilmemiş düğümler DrawTreeNodeEventArgs çizer. Bu yöntemler, özelleştirme gerektirmeyen öğeler için TreeView varsayılan görünümü sağlar. İşleyici düğüm etiketlerini çizer ve özel seçim el ile vurgulanır.
Tam örnek için başvuru konusuna TreeView.DrawNode bakın.
// Draws a node.
private:
void myTreeView_DrawNode( Object^ sender, DrawTreeNodeEventArgs^ e )
{
// Draw the background and node text for a selected node.
if ( (e->State & TreeNodeStates::Selected) != (TreeNodeStates)0 )
{
// Draw the background of the selected node. The NodeBounds
// method makes the highlight rectangle large enough to
// include the text of a node tag, if one is present.
e->Graphics->FillRectangle( Brushes::Green, NodeBounds( e->Node ) );
// Retrieve the node font. If the node font has not been set,
// use the TreeView font.
System::Drawing::Font^ nodeFont = e->Node->NodeFont;
if ( nodeFont == nullptr )
nodeFont = (dynamic_cast<TreeView^>(sender))->Font;
// Draw the node text.
e->Graphics->DrawString( e->Node->Text, nodeFont, Brushes::White, Rectangle::Inflate( e->Bounds, 2, 0 ) );
}
// Use the default background and node text.
else
{
e->DrawDefault = true;
}
// If a node tag is present, draw its string representation
// to the right of the label text.
if ( e->Node->Tag != nullptr )
{
e->Graphics->DrawString( e->Node->Tag->ToString(), tagFont, Brushes::Yellow, (float)e->Bounds.Right + 2, (float)e->Bounds.Top );
}
// If the node has focus, draw the focus rectangle large, making
// it large enough to include the text of the node tag, if present.
if ( (e->State & TreeNodeStates::Focused) != (TreeNodeStates)0 )
{
Pen^ focusPen = gcnew Pen( Color::Black );
try
{
focusPen->DashStyle = System::Drawing::Drawing2D::DashStyle::Dot;
Rectangle focusBounds = NodeBounds( e->Node );
focusBounds.Size = System::Drawing::Size( focusBounds.Width - 1, focusBounds.Height - 1 );
e->Graphics->DrawRectangle( focusPen, focusBounds );
}
finally
{
if ( focusPen )
delete safe_cast<IDisposable^>(focusPen);
}
}
}
// Draws a node.
private void myTreeView_DrawNode(
object sender, DrawTreeNodeEventArgs e)
{
// Draw the background and node text for a selected node.
if ((e.State & TreeNodeStates.Selected) != 0)
{
// Draw the background of the selected node. The NodeBounds
// method makes the highlight rectangle large enough to
// include the text of a node tag, if one is present.
e.Graphics.FillRectangle(Brushes.Green, NodeBounds(e.Node));
// Retrieve the node font. If the node font has not been set,
// use the TreeView font.
Font nodeFont = e.Node.NodeFont;
if (nodeFont == null) nodeFont = ((TreeView)sender).Font;
// Draw the node text.
e.Graphics.DrawString(e.Node.Text, nodeFont, Brushes.White,
Rectangle.Inflate(e.Bounds, 2, 0));
}
// Use the default background and node text.
else
{
e.DrawDefault = true;
}
// If a node tag is present, draw its string representation
// to the right of the label text.
if (e.Node.Tag != null)
{
e.Graphics.DrawString(e.Node.Tag.ToString(), tagFont,
Brushes.Yellow, e.Bounds.Right + 2, e.Bounds.Top);
}
// If the node has focus, draw the focus rectangle large, making
// it large enough to include the text of the node tag, if present.
if ((e.State & TreeNodeStates.Focused) != 0)
{
using (Pen focusPen = new Pen(Color.Black))
{
focusPen.DashStyle = System.Drawing.Drawing2D.DashStyle.Dot;
Rectangle focusBounds = NodeBounds(e.Node);
focusBounds.Size = new Size(focusBounds.Width - 1,
focusBounds.Height - 1);
e.Graphics.DrawRectangle(focusPen, focusBounds);
}
}
}
' Draws a node.
Private Sub myTreeView_DrawNode(ByVal sender As Object, _
ByVal e As DrawTreeNodeEventArgs) Handles myTreeView.DrawNode
' Draw the background and node text for a selected node.
If (e.State And TreeNodeStates.Selected) <> 0 Then
' Draw the background of the selected node. The NodeBounds
' method makes the highlight rectangle large enough to
' include the text of a node tag, if one is present.
e.Graphics.FillRectangle(Brushes.Green, NodeBounds(e.Node))
' Retrieve the node font. If the node font has not been set,
' use the TreeView font.
Dim nodeFont As Font = e.Node.NodeFont
If nodeFont Is Nothing Then
nodeFont = CType(sender, TreeView).Font
End If
' Draw the node text.
e.Graphics.DrawString(e.Node.Text, nodeFont, Brushes.White, _
e.Bounds.Left - 2, e.Bounds.Top)
' Use the default background and node text.
Else
e.DrawDefault = True
End If
' If a node tag is present, draw its string representation
' to the right of the label text.
If (e.Node.Tag IsNot Nothing) Then
e.Graphics.DrawString(e.Node.Tag.ToString(), tagFont, _
Brushes.Yellow, e.Bounds.Right + 2, e.Bounds.Top)
End If
' If the node has focus, draw the focus rectangle large, making
' it large enough to include the text of the node tag, if present.
If (e.State And TreeNodeStates.Focused) <> 0 Then
Dim focusPen As New Pen(Color.Black)
Try
focusPen.DashStyle = System.Drawing.Drawing2D.DashStyle.Dot
Dim focusBounds As Rectangle = NodeBounds(e.Node)
focusBounds.Size = New Size(focusBounds.Width - 1, _
focusBounds.Height - 1)
e.Graphics.DrawRectangle(focusPen, focusBounds)
Finally
focusPen.Dispose()
End Try
End If
End Sub
Açıklamalar
Bu numaralandırma sınıfın StateDrawTreeNodeEventArgs özelliği tarafından kullanılır. Daha fazla bilgi için olaya bakın TreeView.DrawNode .
