IDesignerOptionService.GetOptionValue(String, String) Méthode

Référence

Définition

Espace de noms:: System.ComponentModel.Design

Assembly:: System.ComponentModel.TypeConverter.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient la valeur de l'option du Concepteur Windows Forms spécifiée.

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

Paramètres

pageName: String

Nom de la page qui définit l'option.

valueName: String

Nom de la propriété de l'option.

Retours

Object

Valeur de l'option spécifiée.

Exemples

L’exemple de code suivant illustre l’utilisation de la GetOptionValue méthode pour interroger la valeur de l’option GridSize .

// 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)

Remarques

Le pageName paramètre doit se composer de « WindowsFormsDesigner\CategoryName », où CategoryName est un nom de catégorie d’options sans espaces blancs. Le nom de la catégorie est généralement « Général ». Par conséquent, vous pouvez accéder à la catégorie d’options du concepteur « Général » avec le nom de page en anglais « WindowsFormsDesigner\General ».

Notes

Les noms de page et de valeur sont toujours attendus en anglais. Par conséquent, le tableau suivant est fourni pour vous aider à accéder aux options souhaitées.

Le tableau suivant indique les noms de valeur en anglais, leur format de données et une description de chacun d’eux :

Nom de la valeur	Format de la valeur	Description
GridSize	Size	Taille de chaque carré de grille.
GridSize.Width	Int32	Largeur de chaque carré de grille. Cette propriété imbriquée est en lecture seule lorsqu’elle est accessible via le service d’option de concepteur.
GridSize.Height	Int32	Hauteur de chaque carré de grille. Cette propriété imbriquée est en lecture seule lorsqu’elle est accessible via le service d’option de concepteur.
ShowGrid	Boolean	`true` si la grille doit être affichée ; `false` si la grille ne doit pas être affichée.
SnapToGrid	Boolean	`true` si les positions des composants doivent être alignées sur la grille ; `false` si les positions ne doivent pas nécessairement être alignées.
LayoutMode	`Microsoft.VisualStudio.Windows.Forms.LayoutMode`	`SnapLines` pour utiliser des lignes d’alignement ou `SnapToGrid` pour aligner des contrôles sur la grille,
ObjectBoundSmartTagAutoShow	Boolean	`true` pour permettre au panneau des balises actives d'un composant de s'ouvrir automatiquement au moment de la création ; sinon, `false`.
AutoToolboxPopulate	Boolean	`true` pour ajouter automatiquement les contrôles et composants personnalisés d’une solution à la boîte à outils ; sinon, `false`.
UseOptimizedCodeGeneration	Boolean	`true` si le cache du composant est activé ; sinon `false`.

S’applique à