Control.RightToLeft Control.RightToLeft Control.RightToLeft Control.RightToLeft Property

Definição

Obtém ou define um valor que indica se os elementos do controle estão alinhados para dar suporte a localidades que usam fontes da direita para a esquerda.Gets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts.

public:
 virtual property System::Windows::Forms::RightToLeft RightToLeft { System::Windows::Forms::RightToLeft get(); void set(System::Windows::Forms::RightToLeft value); };
public virtual System.Windows.Forms.RightToLeft RightToLeft { get; set; }
member this.RightToLeft : System.Windows.Forms.RightToLeft with get, set
Public Overridable Property RightToLeft As RightToLeft

Valor da propriedade

Um dos valores de RightToLeft.One of the RightToLeft values. O padrão é Inherit.The default is Inherit.

Exceções

O valor atribuído não é um dos valores RightToLeft.The assigned value is not one of the RightToLeft values.

Comentários

A RightToLeft propriedade é uma propriedade de ambiente.The RightToLeft property is an ambient property. Uma propriedade de ambiente é uma propriedade de controle que, se não definida, é recuperada do controle pai.An ambient property is a control property that, if not set, is retrieved from the parent control. Por exemplo, um Button terá o mesmo BackColor que seu pai Form por padrão.For example, a Button will have the same BackColor as its parent Form by default. Para obter mais informações sobre as propriedades de ambiente AmbientProperties , consulte a Control classe ou a visão geral da classe.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

A RightToLeft propriedade é usada para aplicativos internacionais em que a linguagem é escrita da direita para a esquerda, como hebraico ou árabe.The RightToLeft property is used for international applications where the language is written from right to left, such as Hebrew or Arabic. Quando essa propriedade é definida como RightToLeft.Yes, os elementos de controle que incluem texto são exibidos da direita para a esquerda.When this property is set to RightToLeft.Yes, control elements that include text are displayed from right to left.

Observação

Se o valor da RightToLeft propriedade for alterado em tempo de execução, somente o texto bruto sem formatação será preservado.If the value of the RightToLeft property is changed at run time, only raw text without formatting is preserved.

Veja a seguir alguns exemplos de como os RightToLeft elementos de controle são afetados pelo valor da propriedade de: RightToLeft.YesThe following are a few examples of how control elements are affected by the RightToLeft property value of RightToLeft.Yes :

  • As barras de rolagem vertical são exibidas no lado esquerdo, e não no lado direito dos controles roláveis Form( Panelpor exemplo TextBox,, RichTextBoxmultilinha e).Vertical scroll bars are displayed on the left side rather than right side of scrollable controls (for example, Form, Panel, multiline TextBox, and RichTextBox).

  • As barras de rolagem horizontal começam com a caixa de rolagem (Thumb) alinhada à direita.Horizontal scroll bars start with the scroll box (thumb) right-aligned.

  • O alinhamento do elemento da caixa de seleção, CheckAlign controlado pela propriedade, é invertido RadioButton para CheckBox controles e.The check box element alignment, controlled by the CheckAlign property, is reversed for CheckBox and RadioButton controls.

  • Os itens na caixa de listagem, na caixa de combinação e nos controles de cima estão alinhados à direita.Items in list box, combo box, and up-down controls are right aligned.

  • Os botões para cima e para baixo são NumericUpDown alinhados DomainUpDown à esquerda e aos controles.Up and down buttons are left-aligned on NumericUpDown and DomainUpDown controls.

  • Os menusMainMenu( MenuItem, e ContextMenu) são exibidos alinhados à direita.Menus (MainMenu, MenuItem, and ContextMenu) are displayed right-aligned.

  • O alinhamento dos botões da barra de ToolBar ferramentas em um controle ou o alinhamento do ToolBarButton texto em um não RightToLeft é afetado pela propriedade.The alignment of toolbar buttons on a ToolBar control or the alignment of text on a ToolBarButton is not affected by the RightToLeft property.

  • AxHostdá suporte ao alinhamento da direita para a esquerda; no entanto, o efeito em um controle ActiveX depende da extensão à qual o autor do controle implementou o suporte à exibição da direita para a esquerda.AxHost supports right-to-left alignment; however, the effect on an ActiveX control depends on the extent to which the control author implemented support for right-to-left display.

Notas aos Herdeiros

Ao substituir a RightToLeft Propriedade em uma classe derivada, use a propriedade da RightToLeft classe base para estender a implementação de base.When overriding the RightToLeft property in a derived class, use the base class's RightToLeft property to extend the base implementation. Caso contrário, você deve fornecer toda a implementação.Otherwise, you must provide all the implementation. Não é necessário substituir get os acessadores e set os acessadores da RightToLeft Propriedade; você pode substituir apenas um, se necessário.You are not required to override both the get and set accessors of the RightToLeft property; you can override only one if needed.

Aplica-se a

Veja também