XChangeProperty

Syntax

XChangeProperty(display, w, property, type, format, mode, data, nelements)
      Display *display;
      Window w;
      Atom property, type;
      int format;
      int mode;
      unsigned char *data;
      int nelements;

Arguments

Description

• If mode is PropModeReplace, XChangeProperty() discards the previous property value and stores the new data.
  引き数 mode が PropModeReplace, ならば、 XChangeProperty() は以前のプロパティ値を破棄し、新しいデータを格納する。

• If mode is PropModePrepend or PropModeAppend, XChangeProperty() inserts the specified data before the beginning of the existing data or onto the end of the existing data, respectively. The type and format must match the existing property value, or a BadMatch error results. If the property is undefined, it is treated as defined with the correct type and format with zero-length data.
  mode が PropModePrepend ならば、 XChangeProperty() は現在あるデータの先頭に指定したデータを挿入し、 mode が PropModeAppend ならば、 現在あるデータの末尾に指定したデータを挿入する。 タイプとフォーマットは現在あるプロパティ値と一致していなければならず、 そうでない場合にはエラー BadMatch となる。 プロパティが定義されていない場合、 これは正しいタイプとフォーマットで定義された、 長さゼロのデータとして扱われる。

The lifetime of a property is not tied to the storing client. Properties remain until explicitly deleted, until the window is destroyed, or until the server resets. For a discussion of what happens when the connection to the X server is closed, see section "X Server Connection Close Operations". The maximum size of a property is server dependent and can vary dynamically depending on the amount of memory the server has available. (If there is insufficient space, a BadAlloc error results.)
プロパティの存続期間は、 格納を行ったクライアントとは結びつけられない。 プロパティは明示的に削除されるか、 ウィンドウが破壊されるか、 サーバが再設定するまで残る。 X サーバへの接続が切れた際の挙動については、 セクション "X Server Connection Close Operations" を参照すること。 プロパティの最大サイズはサーバに依存し、 これはサーバが利用可能なメモリ量によって動的に変わることもある。 (十分なメモリが確保できない場合はエラー BadAlloc となる。)

XChangeProperty() can generate BadAlloc , BadAtom , BadMatch , BadValue , and BadWindow errors.
XChangeProperty() はエラー BadAlloc , BadAtom , BadMatch , BadValue , BadWindow を起こすことがある。

Diagnostics

See also