Win32 API 日本語リファレンス
ホームStorage.IndexServer › FILTERREGION

FILTERREGION

構造体
サイズx64: 12 バイト / x86: 12 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
idChunkDWORD4+0+0チャンク識別子です。
cwcStartDWORD4+4+4領域の開始位置です。チャンクの先頭からのオフセットとして指定します。
cwcExtentDWORD4+8+8領域の範囲です。Unicode 文字数として指定します。

公式ドキュメント

オブジェクト内の指定されたテキスト部分の位置と範囲を示します。

解説(Remarks)

cwcExtent メンバーは、(cwcStart メンバーが指定する位置から数えて) チャンクの終端を超えて延びる文字数を指定する場合があります。その場合、領域は次のチャンクへ継続されるものとし、そのチャンクは現在の領域と同じ属性を持っている必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// FILTERREGION  (x64 12 / x86 12 バイト)
typedef struct FILTERREGION {
    DWORD idChunk;
    DWORD cwcStart;
    DWORD cwcExtent;
} FILTERREGION;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FILTERREGION
{
    public uint idChunk;
    public uint cwcStart;
    public uint cwcExtent;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FILTERREGION
    Public idChunk As UInteger
    Public cwcStart As UInteger
    Public cwcExtent As UInteger
End Structure
import ctypes
from ctypes import wintypes

class FILTERREGION(ctypes.Structure):
    _fields_ = [
        ("idChunk", wintypes.DWORD),
        ("cwcStart", wintypes.DWORD),
        ("cwcExtent", wintypes.DWORD),
    ]
#[repr(C)]
pub struct FILTERREGION {
    pub idChunk: u32,
    pub cwcStart: u32,
    pub cwcExtent: u32,
}
import "golang.org/x/sys/windows"

type FILTERREGION struct {
	idChunk uint32
	cwcStart uint32
	cwcExtent uint32
}
type
  FILTERREGION = record
    idChunk: DWORD;
    cwcStart: DWORD;
    cwcExtent: DWORD;
  end;
const FILTERREGION = extern struct {
    idChunk: u32,
    cwcStart: u32,
    cwcExtent: u32,
};
type
  FILTERREGION {.bycopy.} = object
    idChunk: uint32
    cwcStart: uint32
    cwcExtent: uint32
struct FILTERREGION
{
    uint idChunk;
    uint cwcStart;
    uint cwcExtent;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; FILTERREGION サイズ: 12 バイト(x64)
dim st, 3    ; 4byte整数×3(構造体サイズ 12 / 4 切り上げ)
; idChunk : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; cwcStart : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; cwcExtent : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global FILTERREGION
    #field int idChunk
    #field int cwcStart
    #field int cwcExtent
#endstruct

stdim st, FILTERREGION        ; NSTRUCT 変数を確保
st->idChunk = 100
mes "idChunk=" + st->idChunk