IDesignerOptionService.GetOptionValue(String, String) Methode

  • Referenz

Definition

Namespace:
System.ComponentModel.Design
Assembly:
System.ComponentModel.TypeConverter.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Ruft den Wert der angegebenen Windows Forms-Designer-Option ab.

public:
 System::Object ^ GetOptionValue(System::String ^ pageName, System::String ^ valueName);
public object GetOptionValue (string pageName, string valueName);
public object? GetOptionValue (string pageName, string valueName);
abstract member GetOptionValue : string * string -> obj
Public Function GetOptionValue (pageName As String, valueName As String) As Object

Parameter

pageName
String

Der Name der Seite, die die Option definiert.

valueName
String

Der Name der Optionseigenschaft.

Gibt zurück

Object

Der Wert der angegebenen Option.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der GetOptionValue -Methode zum Abfragen des Werts der GridSize Option veranschaulicht.

// Obtains and shows the size of the standard design-mode grid square.
System::Drawing::Size size =  *dynamic_cast<System::Drawing::Size^>(designerOptionService->GetOptionValue( "WindowsFormsDesigner\\General", "GridSize" ));

// Obtains and shows the size of the standard design-mode grid square.
Size size = (Size)designerOptionService.GetOptionValue("WindowsFormsDesigner\\General", "GridSize");

' Obtains and shows the size of the standard design-mode grid square.
Dim size As Size = CType(designerOptionService.GetOptionValue("WindowsFormsDesigner\General", "GridSize"), Size)

Hinweise

Der pageName Parameter sollte aus "WindowsFormsDesigner\CategoryName" bestehen, wobei CategoryName ein Optionskategoriename ohne Leerzeichen ist. Der Kategoriename lautet in der Regel "Allgemein". Daher können Sie auf die Designeroptionenkategorie "Allgemein" mit dem englischen Seitennamen "WindowsFormsDesigner\General" zugreifen.

Hinweis

Die Seiten- und Wertnamen werden immer in Englisch erwartet. Daher wird die folgende Tabelle bereitgestellt, um Ihnen den Zugriff auf die gewünschten Optionen zu erleichtern.

In der folgenden Tabelle sind die englischen Wertnamen, ihr Datenformat und eine Beschreibung der einzelnen Werte angegeben:

Wertname Wertformat BESCHREIBUNG
GridSize Size Die Größe jedes Rasterquadrats.
GridSize.Width Int32 Die Breite jedes Rasterquadrat. Diese geschachtelte Eigenschaft ist schreibgeschützt, wenn über den Designeroptionsdienst darauf zugegriffen wird.
GridSize.Height Int32 Die Höhe jedes Rasterquadrat. Diese geschachtelte Eigenschaft ist schreibgeschützt, wenn über den Designeroptionsdienst darauf zugegriffen wird.
ShowGrid Boolean true , wenn das Raster angezeigt werden soll; false , wenn das Raster nicht angezeigt werden soll.
SnapToGrid Boolean true , wenn die Positionen der Komponenten am Raster ausgerichtet werden sollen; false , wenn die Positionen nicht unbedingt ausgerichtet werden sollen.
LayoutMode Microsoft.VisualStudio.Windows.Forms.LayoutMode SnapLines , um Ausrichtungslinien zu verwenden oder SnapToGrid Steuerelemente am Raster auszurichten,
ObjectBoundSmartTagAutoShow Boolean true, damit der Smarttagbereich einer Komponente bei der Erstellung automatisch geöffnet wird; andernfalls false.
AutoToolboxPopulate Boolean true , um der Toolbox automatisch die benutzerdefinierten Steuerelemente und Komponenten einer Lösung hinzuzufügen; falseandernfalls .
UseOptimizedCodeGeneration Boolean true, wenn der Komponentencache aktiviert wird, andernfalls false.

Gilt für:

Weitere Informationen