IDesignerOptionService.GetOptionValue(String, String) Método

Definição

Obtém o valor da opção de Designer de Formulários do Windows especificada.

public object GetOptionValue (string pageName, string valueName);
public object? GetOptionValue (string pageName, string valueName);

Parâmetros

pageName
String

O nome da página que define a opção.

valueName
String

O nome da propriedade de opção.

Retornos

O valor da opção especificada.

Exemplos

O exemplo de código a seguir demonstra como usar o GetOptionValue método para consultar o valor da opção GridSize .

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

Comentários

O pageName parâmetro deve consistir em "WindowsFormsDesigner\CategoryName", em que CategoryName é um nome de categoria de opções sem caracteres de espaço em branco. O nome da categoria normalmente é "Geral". Portanto, você pode acessar a categoria de opções de designer "Geral" com o nome da página em inglês "WindowsFormsDesigner\General".

Observação

Os nomes de página e valor são sempre esperados em inglês. Portanto, a tabela a seguir é fornecida para ajudá-lo a acessar as opções desejadas.

A tabela a seguir indica os nomes de valor em inglês, seu formato de dados e uma descrição de cada um:

Nome do valor Formato do valor Descrição
Gridsize Size O tamanho de cada quadrado de grade.
GridSize.Width Int32 A largura de cada quadrado de grade. Essa propriedade aninhada é somente leitura quando acessada por meio do serviço de opção do designer.
GridSize.Height Int32 A altura de cada quadrado de grade. Essa propriedade aninhada é somente leitura quando acessada por meio do serviço de opção do designer.
ShowGrid Boolean true se a grade deve ser mostrada; false se a grade não deve ser mostrada.
Snaptogrid Boolean true se as posições dos componentes devem ser alinhadas à grade; false se as posições não devem necessariamente ser alinhadas.
LayoutMode Microsoft.VisualStudio.Windows.Forms.LayoutMode SnapLines para usar snaplines ou SnapToGrid para alinhar controles à grade,
ObjectBoundSmartTagAutoShow Boolean true para permitir que o painel de marca inteligente de um componente seja aberto automaticamente após a criação; caso contrário, false.
AutoToolboxPopulate Boolean true para adicionar automaticamente os controles e componentes personalizados de uma solução à Caixa de Ferramentas; caso contrário, false.
UseOptimizedCodeGeneration Boolean true se o cache de componentes estiver habilitado; caso contrário, false.

Aplica-se a

Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Confira também