textKashidaSpace property

Deprecated. Specifies the ratio of kashida expansion to white space expansion when justifying lines of text in the object.

 

Syntax

HRESULT value = object.put_textKashidaSpace( v);HRESULT value = object.get_textKashidaSpace(* p);

Property values

Type: VARIANT

inherit (inherit)

Text is expanded like the text in the parent object.

String format

percentage

CSS information

Applies To	All elements
Media	visual
Inherited	1
Initial Value	0%

Standards information

• CSS Text Level 3, Section 8.3

Remarks

This property is deprecated and is not supported in Windows Internet Explorer 8 and higher document compatibility modes. It is still available for use in Internet Explorer 8 and later when the page is in either IE5 (Quirks) mode or IE7 Standards mode. For more information about document compatibility modes, see Defining document compatibility.

Kashida is a typographic effect that justifies lines of text by elongating characters at carefully chosen points. It is used in Arabic writing systems.

Kashida justification increases the length of a line by elongating cursive (Arabic) characters at certain points. The semantics of text-kashida and IHTMLCSSStyleDeclaration::textKashidaSpace are opposite each other: "text-kashida:100%" is nearly equivalent to "text-kashida-space:0%".

For the IHTMLCSSStyleDeclaration::textKashidaSpace property to have any effect, you must also set the IHTMLCSSStyleDeclaration::textAlign property to "justify". (Setting IHTMLCSSStyleDeclaration::textJustify property to "kashida" is not required.)

The IHTMLCSSStyleDeclaration::textKashidaSpace property is read-only for the IHTMLCurrentStyle2 interface (C++) and currentStyle object (script).

The IHTMLCSSStyleDeclaration::textKashidaSpace property applies to block elements only.

Requirements

Minimum supported client	Windows XP
Minimum supported server	Windows 2000 Server
Header	Mshtml.h
IDL	Mshtml.idl
DLL	Mshtml.dll