DataGridViewImageColumn.Description Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen einer Zeichenfolge, die das Bild der Spalte beschreibt.
public:
property System::String ^ Description { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.Browsable(true)]
public string Description { get; set; }[<System.ComponentModel.Browsable(true)>]
member this.Description : string with get, setPublic Property Description As StringEigenschaftswert
Die Textbeschreibung des Spaltenbilds. Der Standardwert lautet Empty.
- Attribute
Ausnahmen
Der Wert der CellTemplate Eigenschaft lautet null.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die Description Eigenschaft verwendet wird, um das Bildlayout widerzuspiegeln. Dieses Beispiel ist Teil eines größeren Beispiels, das in How to: Work with Image Columns in the Windows Forms DataGridView Control verfügbar ist.
void Stretch( Object^ sender, EventArgs^ e )
{
System::Collections::IEnumerator^ myEnum = dataGridView1->Columns->GetEnumerator();
while ( myEnum->MoveNext() )
{
DataGridViewImageColumn^ column = safe_cast<DataGridViewImageColumn^>(myEnum->Current);
column->ImageLayout = DataGridViewImageCellLayout::Stretch;
column->Description = L"Stretched";
}
}
void ZoomToImage( Object^ sender, EventArgs^ e )
{
System::Collections::IEnumerator^ myEnum1 = dataGridView1->Columns->GetEnumerator();
while ( myEnum1->MoveNext() )
{
DataGridViewImageColumn^ column = safe_cast<DataGridViewImageColumn^>(myEnum1->Current);
column->ImageLayout = DataGridViewImageCellLayout::Zoom;
column->Description = L"Zoomed";
}
}
void NormalImage( Object^ sender, EventArgs^ e )
{
System::Collections::IEnumerator^ myEnum2 = dataGridView1->Columns->GetEnumerator();
while ( myEnum2->MoveNext() )
{
DataGridViewImageColumn^ column = safe_cast<DataGridViewImageColumn^>(myEnum2->Current);
column->ImageLayout = DataGridViewImageCellLayout::Normal;
column->Description = L"Normal";
}
}
private void Stretch(object sender, EventArgs e)
{
foreach (DataGridViewImageColumn column in
dataGridView1.Columns)
{
column.ImageLayout = DataGridViewImageCellLayout.Stretch;
column.Description = "Stretched";
}
}
private void ZoomToImage(object sender, EventArgs e)
{
foreach (DataGridViewImageColumn column in
dataGridView1.Columns)
{
column.ImageLayout = DataGridViewImageCellLayout.Zoom;
column.Description = "Zoomed";
}
}
private void NormalImage(object sender, EventArgs e)
{
foreach (DataGridViewImageColumn column in
dataGridView1.Columns)
{
column.ImageLayout = DataGridViewImageCellLayout.Normal;
column.Description = "Normal";
}
}
Private Sub Stretch(ByVal sender As Object, _
ByVal e As EventArgs) Handles Button3.Click
For Each column As DataGridViewImageColumn _
In dataGridView1.Columns
column.ImageLayout = DataGridViewImageCellLayout.Stretch
column.Description = "Stretched image layout"
Next
End Sub
Private Sub ZoomToImage(ByVal sender As Object, _
ByVal e As EventArgs) Handles Button4.Click
For Each column As DataGridViewImageColumn _
In dataGridView1.Columns
column.ImageLayout = DataGridViewImageCellLayout.Zoom
column.Description = "Zoomed image layout"
Next
End Sub
Private Sub NormalImage(ByVal sender As Object, _
ByVal e As EventArgs) Handles Button5.Click
For Each column As DataGridViewImageColumn _
In dataGridView1.Columns
column.ImageLayout = DataGridViewImageCellLayout.Normal
column.Description = "Normal image layout"
Next
End Sub
Hinweise
Sie können die Description Eigenschaft verwenden, um das von der Image Eigenschaft Icon bereitgestellte Bild zu beschreiben. Diese Beschreibung bietet eine barrierefreie Alternative zum Bild. Darüber hinaus wird der Beschreibungstext verwendet, wenn der Zellwert in die Zwischenablage kopiert wird.
Dient zum Abrufen oder Festlegen dieser Eigenschaft zum Abrufen oder Festlegen der Description Eigenschaft des Objekts, das von der CellTemplate Eigenschaft zurückgegeben wird. Durch Festlegen dieser Eigenschaft wird auch die Description Eigenschaft jeder Zelle in der Spalte festgelegt. Wenn Sie den angegebenen Wert für einzelne Zellen überschreiben möchten, legen Sie die Zellwerte fest, nachdem Sie den Spaltenwert festgelegt haben.
